Files
OpenMQTT-Gateway/docs/upload/arduino-ide.md
T
Florian b4e65aef6f Arduino IDE library packaging modification
#579
Update doc to reflect necessary manual changes
Implement a part of these changes to automatic script
2020-04-27 12:35:42 -05:00

41 lines
2.3 KiB
Markdown

# Upload with Arduino IDE
* First download the last version of the Arduino IDE from the arduino [website](https://www.arduino.cc/en/Main/Software)
* Add ESP32 boards by following this [tutorial](https://github.com/espressif/arduino-esp32/blob/master/docs/arduino-ide/boards_manager.md)
* Add ESP8266 boards by following this [tutorial](https://github.com/esp8266/Arduino#installing-with-boards-manager)
* Download OpenMQTTGateway code (OpenMQTTGateway_sources.zip) from the [release page](https://github.com/1technophile/OpenMQTTGateway/releases) and unzip it
* Download the libraries package corresponding to your board and module wished into the same page (example esp32-m5stick-c-ble-libraries.zip)
* Unzip the libraries into your arduino libraries folder (example D:/Users/XXXX/Documents/Arduino/libraries)
* If you are using an ESP, Mega or other powerfull board; Open the *PubSubClient* folder, open the file src/PubSubClient.h, replace
```C++
#define MQTT_MAX_PACKET_SIZE 128
```
by
```C++
#define MQTT_MAX_PACKET_SIZE 1024
```
This modification will enable to send and receive by MQTT long json messages.
* If necessary replace the spaces into each library folder by _: example rename “ESP32 BLE Arduino” folder to “ESP32_BLE_Arduino”
* Open the file main.ino from OpenMQTTGateway/main folder with the arduino IDE
* Change the settings and the desired gateways into user_config.h (uncomment the modules you want)
*Example for the use of RF gateway*
```C++
#define ZgatewayRF "RF" //ESP8266, Arduino, ESP32
//#define ZgatewayIR "IR" //ESP8266, Arduino, Sonoff RF Bridge
//#define ZgatewayLORA "LORA" //ESP8266, Arduino, ESP32
//#define ZgatewayPilight "Pilight" //ESP8266, Arduino, ESP32
//#define ZgatewayBT "BT" //ESP8266, ESP32
```
* Change the pins or parameters corresponding to the modules choosen, for RF you can change the pins into config_RF.h
* Choose the board on the Arduino IDE
* Select the port corresponding to the board
* Note that for using BLE on ESP32 you will need to select *Minimal SPIFFS* into Tools->Partition Scheme
* Open the serial monitor and set 115200 bauds
* Upload ➡️
* You should see the logs into the serial monitor
With an ESP if you did not set your network and mqtt parameters manualy you can now open the [web portal configuration](portal.md).