Use a single ESP32 to control multiple devices and sensors via MQTT.
The ESP32 act as an MQTT bridge for your domotic system, and it's designed to be remotely managed and updated.
It provides low level functionalities to develop IOT devices

• Control multiple devices and sensors with a single ESP32
• Remote management and update
• Minimal configuration
• Extendable modules and easy to use
• Parallel tasks and low level functionalities

1. Install PlatformIO

pip install -U platformio

2. Clone the repository

git clone [email protected]:jonamat/base-sat.git

The repo is designed to keep your configuration (include/config.h and include/devices.h) separated from the main code. You can update the repo without losing your configuration by pulling the latest changes from the repository. If you have made changes to the main code, you can stash them before pulling the changes and then apply them back.

git stash # Stash your changes if you have made any in the main code (in src folder)
git pull
git stash apply # Apply your changes back

1. Rename the include/config.template.h file to include/config.h and fill your configuration.

mv include/config.template.h include/config.h

2. Fill the basic configuration in the include/config.h file.

#define SAT_NAME "sat-1"
#define WIFI_SSID "your-wifi-ssid"
#define WIFI_PASSWORD "your-wifi-password"
#define MQTT_SERVER "test.mosquitto.org"

3. Rename the include/devices.template.h file to include/devices.h and define your devices and sensors.

mv include/devices.template.h include/devices.h

1. Edit the vector devices in the include/devices.h file to insert your modules. See Modules to know how to do.

std::vector<Module*> devices = {
  new AnalogOutputDAC("/lights", 33),
  new AnalogReader("/sun-tracer", 34),
  new Button("/light-switch", 35),
  new DigitalInput("/door-sensor", 36),
  new DigitalOutput("/heater", 37),
  new IROutput("/tv-remote", 38),
  new NTCThermistor("/temperature", 39, 10000, 10000),
  new PWM("/fan", 40, 1000, 8, 0, 1023)
};

4. Upload the code to your ESP32 and check the serial monitor for the satellite status.

pio run -t upload

Modules are the basic building blocks of the satellite. They control 1 (or multiple) GPIO pins. They can be sensors or actuators. Each module has some basic commands. By default, the command topic is the module topic with the suffix /set. The module sends a message to the command topic when the state changes.

Check the state of a digital input pin. It sends a message to the defined topic when the state changes.

Set the state of a digital output pin. It listens to the command topic and changes the state of the pin when a message is received. A new message is sent to the main topic when the state changes.

Read the value of an analog pin. It sends a message to the defined topic when the value changes.

! This module is available only on DAC pins, and for the ESP32 are 25 and 26. Set the value of an analog output pin using the integrated DAC. It listens to the command topic and changes the value of the pin when a message is received. A new message is sent to the main topic when the value changes.

Set the value of an analog output pin using PWM. It listens to the command topic and changes the value of the pin when a message is received. A new message is sent to the main topic when the value changes.

Send IR signals using the IRremote library. It listens to the command topic and sends the IR signal when a message is received.

Read the value of a thermistor and convert it to temperature. It sends a message to the defined topic when the value changes.

Check the state of a button. It sends a message to the defined topic when the state changes. It uses the Bounce2 library to debounce the button.

MIT