People Counter for $30 Using an ESP8266 an NodeMCU




Introduction: People Counter for $30 Using an ESP8266 an NodeMCU

A people counter is a device that used to measure the number of people traversing an entrance, hallway, street corner, etc. If you need to know how many people exist in a space - this is your simple solution. Mostly used in retail stores, shopping malls, and smart office buildings, this counting technology has provided insight to how shoppers/employers behave.

How is the people counter application applicable to you (other than just being really cool technology)? Imagine you're the owner of a shop; this counter would will alert you to daily visitors, the walking paths taken when inside, where they stop, and how long they linger at in a place. Wouldn't you like to know what materials gain the most attention; possibly being able to reposition products geographically to increase awareness to benefit your customers needs and your bottom line? In this guide you will learn how to build your own home-made people counter. Also included are instructions for you newly collected data to be utilized via Ubidots, an application enablement platform.

Step 1: ​Materials Required

  • ESP8266 NodeMCU
  • PIR Motion Sensor
  • Female - Female Wires
  • Plastic Protection Case
  • MicroUSB Cable

Step 2: Wiring and Casing

As you can see, the motion sensor has three pins: V+, Ground, and a third for outputs signal ("1" = movement, and "0" static environment). First plug the cables straight to the pins of your NodeMCU, follow the table and diagram:

NodeMCU -> PIR Sensor

D6 -> OUT

3.3V -> VCC

NodeMCU -> LED

D4 -> VCC

Because the sensor is very sensitive to movement, I used the jumper switch behind it to set the lowest sensibility. I also painted over the lense corners to focus on one specific space instead of omnidirectional. (This was for my liking, but please explore and innovate as you see fit) The results of these few extra minutes of work result in the a friendly, contained device.

Step 3: With the Case and And Device Pieced Together, We Now Need to Connect With Arduino IDE

To start, connect your NodeMCU to your computers port using the micro USB

Note: If you do not already have the Arduino IDE, click here to download.

1.- Open the Arduino IDE, select Files -> Preferences. Next input the following URL into the Additional Board Manager URLs text box. You can add multiple URLs, separating them with commas if needed. "".

NOTE: If you're a Mac user, please note that Arduino and File contain different drop down functions compared to Windows operating systems. Also, you will need to install the following driver to be able to upload your NodeMCU.

2.- Open Boards Manager from Tools -> Board menu and install ESP8266 platform. To simply find the correct device, search ESP8266 within the search bar.

3.- Select your NodeMCU 1.0 (ESP-12 Module) from Tools > Board menu. Additionally, we need to be able to communicate with the NodeMCU, we also need to select the port com. Go to Tools > Port > Select the appropriate PORT for your computer/device connection.

Also, to keep everything running fast and smooth - let's make sure the upload speed is optimized to 115200.

Go to Tools > Upload Speed > 115200.

4.- Next we need to download the Ubidots MQTT ESP library from Github. To do this, open the MQTT ESP libraryhere, download the library by clicking the green button called "Clone or download" and select "Download ZIP".

5.- Now move back to your Arduino IDE, click on Sketch -> Include Library -> Add .ZIP Library.

6.- Select the .ZIP file of ubidotsMQTTESP and then “Accept” or “Choose”.

If successful, you will receive a message below in the Arduino IDE confirming your library.

7.- Next go to Sketch/Program-> Include Library -> Library Manager and install the PubSubClient library. To simply find the correct library, search PubSubClient within the search bar.

8.- Close the Arduino IDE and open it again. The restart is required. Please do not miss this step!!

Now it is time to start coding :)

Go to this link to copy and paste it into the Arduino IDE. Once you have copied the code, you will need to assign the parameters: Wi-Fi name and password, plus your individual, unique Ubidots TOKEN. If you don't know how locate your Ubidots TOKEN, please reference this article below.

Once you pasted the code and updated the WiFi parameters, you must Verify this within the Arduino IDE. To do this, in the top left corner of our Arduino IDE choose the Check Mark icon to verify any code.

Once the code is verified, you will receive a "Donecompiling" message in the Arduino IDE.

Next, your have to upload the code into your NodeMCU. To do this, choose the right-arrow icon beside the check mark icon.

Once the code is uploaded, you will receive a "Doneuploading" message in the Arduino IDE.

Now your sensor is sending the data to the Ubidots Could!

Step 4: Status LED

Once your code is uploaded, the onboard LED will alert you the devices connectivity.

  • LED on -> Ok, device connected and sending data.
  • LED blink (1 second) -> Trying to reconnect. Lost the connection. No acces to internet.
  • LED off -> Device not connected

Step 5: Management of the Data in Ubidots

If your device is correctly connected you will see a new device created within your device section in your Ubidots application. The name of the device will be "sensor-pir", also inside the device you will see the variable created called "motion."

If you desire to change you device and variable names to a more friendly one, please reference this article

Next, to count the amount of people your device is detecting, we need to create a new derived variable to be able to manage the data and count the amount of people detected. Click on "Add variable" and select "Rolling window"

Select the device called "pir-sensor" and the variable "motion" then, compute the sum every time set as you desire ( 1 minute; 1 hour; 1 day) to get the number of people detected. Press Save and assign a name for the variable.

Once your variable is created, you will receive the number of people detected on that variable. Below is an illustration of the final result:

Step 6: Results

This project educates administrators and decision makers to the amount of people passing through a particular space and how they operate. Please note not every person will be detected due to limitations of the motion sensor. Line of sight is important for us humans and machines also struggle with this too. But we are working on it!

Now it is time to create a dashboard to control and manage the variables of your own People Counter. To learn more about Ubidots widgets and events, check out these video tutorials.

Made by: Maria Carlina Hernandez



    • Science of Cooking

      Science of Cooking
    • Pocket-Sized Contest

      Pocket-Sized Contest
    • Trash to Treasure

      Trash to Treasure

    We have a be nice policy.
    Please be positive and constructive.




    Hello there!

    We're glad you want to share something with the Instructables community!

    And we’re here to help you out.

    Due to some recent changes on the site, we are no longer able to publish stand-alone videos and other forms of incomplete posts. In order to be published live on the site, Instructables must consist of the following things:

    - Multiple steps showing how you made your project

    - Written instructions in each step

    - Your own original images

    Beyond making your Instructable simply publishable, this guide ( explains what is required to have your Instructables featured by our site editors. It’s very helpful, and definitely worth checking out.

    We would love to review your project again after you have made the necessary edits, and we will publish your project if it is eligible.

    If you have any questions, please feel free to ask right here or send us an email at


    Instructables Community Manager