This is an old revision of the document!
Table of Contents
Configuring IoT modules
In this page, we will explain how you can configure the IoT Homelab modules for your router and selected MQTT broker. To configure the modules you will need:
- Wifi name and password.
- MQTT broker IP adress, port and username and password (if using password protected broker).
- A laptop/PC with WiFi connection and a program capable of HTTP POST request.
Required software
To configure the IoT Homelab modules you will need some kind of a program that allows to make a HTTP POST request. In this tutorial we will be using Advanced REST Client (ARC) that can be downloaded here.
Connecting to the module
If you power on the module for the first time, it will go to Boot mode. That means it will create a Wifi access point that you can connect to with your laptop. That happens every time the module cannot connect to the router or the broker.
After the module is powered on, you should see it in the Wifi list of your device.
NB! If you want to reconfigure the module you have to first disable (or move out of range) the current router the module is configured to. That is because if the module can connect to the router and broker defined, it does not create an access point.
Handling the ARC program
After opening the ARC program. First select the POST method. After that type
http://192.168.4.1/set/config
in the Request URL field. Then select the Body parameter and copy the following line there:
{"dname":"ESP44","wname":"raspberryIoT","wpass":"piIoT123","msrv":"192.168.4.1","mport":"1883","muser":"test","mpass":"test","mssl":"false"}
If you are using the Raspberry image we provided then only change the dname field. If you are using some other broker then you have to change all fields according to your setup. The fields are as following:
| Field | Description |
|---|---|
| dname | Name of the controller module. It is recommended to write the name physically on the module to avoid getting them mixed up. |
| wname | The SSID of the Wifi router you wish to connect to |
| wpass | The password for that Wifi connection |
| msrv | The IP address of the MQTT broker |
| mport | The port for the MQTT broker (Usually 1883 is used for connections without SSL and 8883 for connections with SSL. |
| muser | The username for the MQTT broker. Only relevant when using a broker with SSL. |
| mpass | The password for MQTT broker. Only relevant when using a broker with SSL. |
| mssl | A boolean that shows if SSL is used or not. |
Once you have configured the fields as necessary press SEND to upload the configuration to the module. After a few seconds the following success indicator should appear after the body field. If it fails check if the connection with the module is still active and if you do not have any formatting mistakes.
