====== 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 [[https://install.advancedrestclient.com/install|here]].

====Connecting to the module====

If you run [[en:iot:examples:setup:confmode|Configuration mode example]] and push a button, then the module will go to configuration mode. That means it will create a Wifi access point that you can connect to with your laptop.

After that, you should see it in the Wifi list of your device.

{{:en:iot:examples:setup:wifi.png?300|}}

====Handling the ARC program====

After opening the ARC program. First select the POST method. After that type <code>http://192.168.4.1/set/config</code> in the Request URL field. Then select the Body parameter and copy the following line there:
<code>{"dname":"ESP44","wname":"raspberryIoT","wpass":"piIoT123","msrv":"192.168.4.1","mport":"1883","muser":"test","mpass":"test","mssl":"false"}</code>
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.|

{{:en:iot:examples:setup:arc_settings.png?600|}}

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.

{{:en:iot:examples:setup:success.png?300|}}