ESP-IDF : RF433 Receiver Example

Example of mcsakoff/idf-esp32-rf433 library usage.

Prerequisites

• 315/433-MHz RF receiver module.

• ESP32 family of chips based device.

• Installed:

  • ESP-IDF SDK and corresponding toolchain for ESP32

  • direnv (optional)

  • espflash (optional)

Quick Start

Setup environment

Connect your ESP devkit board to USB and check the hardware info:

$ espflash board-info --no-stub

Note the device chip type (е.g: esp32) and port (e.g.: /dev/cu.usbserial-14810).

Setup environment for ESP-IDF:

$ . ~/esp/esp-idf/export.sh
$ export ESPPORT=/dev/cu.usbserial-14810

Tip	If direnv installed, create .envrc.local file .envrc.local: export ESPPORT=/dev/cu.usbserial-14810 and trigger an environment reload: $ direnv reload

Build and run

Configure the project

$ idf.py set-target esp32
$ idf.py menuconfig

Tip	For target type see Chip type from board info.

Build, flash to the device and run monitor:

$ idf.py build
$ idf.py flash
$ idf.py monitor

Development

CLion

In CLion go to Settings → Build, Execution, Deployment → Toolchains, click Add Environment and select ~/esp/esp-idf/export.sh file.

Use app build target in Run / Debug Configurations.

For details see: Configure an ESP CMake project in CLion.

Copyright and Licensing

Copyright © 2019-2025 Alexey McSakoff
Free use of this software is granted under the terms of the MIT License.

See the LICENSE file for details.