64 lines
2.0 KiB
Markdown
64 lines
2.0 KiB
Markdown
# Configuration
|
|
## File
|
|
Generate a file as, described in
|
|
http://homieiot.github.io/homie-esp8266/docs/develop-v3/configuration/json-configuration-file/
|
|
|
|
## Upload
|
|
* Start ESP
|
|
* Login to Wifi, opened by the ESP
|
|
* Use the script to upload the configuration file
|
|
* restart the ESP
|
|
|
|
# Remote Upload
|
|
|
|
This script will allow you to send an OTA update to your device:
|
|
***upload-via-mqtt.sh***
|
|
|
|
## Installation
|
|
|
|
Requirements are:
|
|
* paho-mqtt
|
|
|
|
## Usage of underlying tool
|
|
|
|
The python script can be used, manually, too:
|
|
```text
|
|
usage: ota_updater.py [-h] -l BROKER_HOST -p BROKER_PORT [-u BROKER_USERNAME]
|
|
[-d BROKER_PASSWORD] [-t BASE_TOPIC] -i DEVICE_ID
|
|
firmware
|
|
|
|
ota firmware update script for ESP8226 implementation of the Homie mqtt IoT
|
|
convention.
|
|
|
|
positional arguments:
|
|
firmware path to the firmware to be sent to the device
|
|
|
|
arguments:
|
|
-h, --help show this help message and exit
|
|
-l BROKER_HOST, --broker-host BROKER_HOST
|
|
host name or ip address of the mqtt broker
|
|
-p BROKER_PORT, --broker-port BROKER_PORT
|
|
port of the mqtt broker
|
|
-u BROKER_USERNAME, --broker-username BROKER_USERNAME
|
|
username used to authenticate with the mqtt broker
|
|
-d BROKER_PASSWORD, --broker-password BROKER_PASSWORD
|
|
password used to authenticate with the mqtt broker
|
|
-t BASE_TOPIC, --base-topic BASE_TOPIC
|
|
base topic of the homie devices on the broker
|
|
-i DEVICE_ID, --device-id DEVICE_ID
|
|
homie device id
|
|
```
|
|
|
|
* `BROKER_HOST` and `BROKER_PORT` defaults to 127.0.0.1 and 1883 respectively if not set.
|
|
* `BROKER_USERNAME` and `BROKER_PASSWORD` are optional.
|
|
* `BASE_TOPIC` has to end with a slash, defaults to `homie/` if not set.
|
|
|
|
### Example:
|
|
|
|
```bash
|
|
python ota_updater.py -l localhost -u admin -d secure -t "homie/" -i "device-id" /path/to/firmware.bin
|
|
```
|
|
|
|
### Source
|
|
https://github.com/homieiot/homie-esp8266/blob/develop/scripts/ota_updater
|