Skip to content

Latest commit

 

History

History

board

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 

README.md

board section

Software that will be running on ESP32 boards (constantly receiving Probe Request frames).

Software

Setup

  1. Install a C/C++ toolchain
  2. Clone the ESP-IDF repo
    • git clone --recursive git@github.com:espressif/esp-idf.git
  3. New environment variable IDF_PATH pointing at the ESP-IDF directory
  4. python -m pip install --user -r $IDF_PATH/requirements.txt to install the Python packages required by ESP-IDF
  5. Run ./installsh && . ./export.sh in the esp-idf directory

Connect the board

Linux
  1. If the board is not recognized by the O.S., install these drivers following the instructions in CP210x_VCP_Linux_4.x_Release_Notes.txt
  2. Give the current user read and write access the serial port over USB with sudo usermod -a -G dialout $USER
  3. Log out and lock back in
  4. Run ls /dev/tty* twice, first with the board/dongle unplugged, then with plugged in. The port which appears the second time is the one you need

Mac OS

  1. Install these drivers
  2. System Preferences -> Security & Privacy -> Allow apps downloaded from: -> App Store and identified developer
  3. Run ls /dev/cu*/ twice, first with the board/dongle unplugged, then with plugged in. The port which appears the second time is the one you need
Windows
  1. Install this zip file
  2. Connect the ESP32 to the computer
  3. Win + X → Device Manager → Ports → Ports (COM & LPT) → take note of the port to which the board is connected (e.g., "COM3")

Eclipse setup

  1. Install the Eclipse IDE
    • First installation: Eclipse CDT for C/C++
    • Eclipse already installed: install the C/C++ language support extension via Help → Install New Software... → Type the Eclipse version in the Work with: field and install the needed toolchain and autotools
  2. Follow this step-by-step guide

Compile and run an hello world example

  1. Open a Unix shell (Win + R → mingw32 on Windows)
  2. cd $IDF_PATH to navigate to the ESP-IDF project root
  3. cd examples/get-started/hello_world/ to navigate to the hello world example
  4. Preferably clean the project either with idf.py clean or idf.py fullclean
  5. Build the project with idf.py build
  6. Flash and run the project with idf.py -p <port> flash monitor, where <port> indicates the serial port to which the ESP32 board is connected to (e.g., "COM3" on Windows or "/dev/ttyUSB0" on Linux)
  7. To exit IDF monitor use the shortcut Ctrl+]

References