update (#489)

add fastled doc

add links to bootloaders and boot app0

Arduino IDE upload instructions add

add community

docs/.vuepress/config.js

@@ -3,7 +3,13 @@ module.exports = {
       lineNumbers: true
     },
     title: 'OpenMQTTGateway',
-    description: 'One gateway, many technologies',
+    description: 'One gateway, many technologies: MQTT gateway for ESP8266, ESP32, Sonoff RF Bridge or Arduino with bidirectional 433mhz/315mhz/868mhz, Infrared communications, BLE, beacons detection, mi flora / mi jia / LYWSD02/ Mi Scale compatibility, SMS & LORA.',
+    head: [
+      ['link', { rel: "apple-touch-icon", sizes: "180x180", href: "/img/apple-touch-icon.png"}],
+      ['link', { rel: "icon", type: "image/png", sizes: "32x32", href: "/img/favicon-32x32.png"}],
+      ['link', { rel: "icon", type: "image/png", sizes: "16x16", href: "/img/favicon-16x16.png"}],
+      ['link', { rel: "shortcut icon", href: "/img/apple-touch-icon.png"}],
+    ],
     themeConfig: {
       smoothScroll: true,
       repo: '1technophile/OpenMQTTGateway',
@@ -51,6 +57,7 @@ module.exports = {
           children: [
             'upload/binaries',
             'upload/pio'
+            'upload/arduino-ide'
           ]
         },
         {
@@ -82,7 +89,9 @@ module.exports = {
           title: '6 - Participate 💻',   // required
           sidebarDepth: 1,    // optional, defaults to 1
           children: [
-            'CONTRIBUTING',
+            'participate/development',
+            'participate/community',
+            'participate/financial_support',
             ['https://github.com/1technophile/OpenMQTTGateway/blob/development/LICENSE.txt','License']
           ]
         }

docs/README.md

@@ -1,9 +1,9 @@
-OpenMQTTGateway project goal is to concentrate in one gateway different technologies, decreasing by the way the number of proprietary gateways needed and hiding the different technologies singularity behind a simple & wide spread communication protocol; [MQTT](http://mqtt.org/).
+OpenMQTTGateway project goal is to concentrate in one gateway different technologies, decreasing by the way the number of proprietary gateways needed, and hiding the different technologies singularity behind a simple & wide spread communication protocol; [MQTT](http://mqtt.org/).
 
 ![Overview](./img/OpenMQTTGateway.png)
 
-OpenMQTTGateway support very mature technologies like basic 433mhz/315mhz protocols & infrared so as to make your old dumb devices "smart" and avoid you to throw then away. These devices have also the advantages of having a lower cost compared to Zwave or more sophisticated protocols.
-And support also up to date technologies like Bluetooth Low Energy or LORA.
+OpenMQTTGateway support very mature technologies like basic 433mhz/315mhz protocols & infrared (IR) so as to make your old dumb devices "smart" and avoid you to throw then away. These devices have also the advantages of having a lower cost compared to Zwave or more sophisticated protocols.
+OMG support also up to date technologies like Bluetooth Low Energy (BLE) or LORA.
 
 To have an overview of the supported PIR, door, water, smoke sensors, sirens, rings, beacons, switchs & weather stations you can take a look to the 
 [compatible devices list](https://docs.google.com/spreadsheets/d/1_5fQjAixzRtepkykmL-3uN3G5bLfQ0zMajM9OBZ1bx0/edit#gid=2126158079)

docs/participate/community.md

@@ -0,0 +1,4 @@
+# Community participation
+The first entry step for participating to OMG is sharing and discussing with the [community](https://community.openmqttgateway.com), by sharing your experiences and answering to other questions you are giving back what the others gave to you.
+
+You can use the forum to ask questions, post answers, suggest features and discuss about home automation or Internet of things in a more general way. 

docs/participate/development.md

@@ -1,4 +1,4 @@
-# Contributing
+# Development contributions
 
 I like pull requests from everyone. By participating in this project, you
 agree to follow the code of conduct below

docs/upload/arduino-ide.md

@@ -0,0 +1,26 @@
+# 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 from the [release page](https://github.com/1technophile/OpenMQTTGateway/releases)
+* 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)
+* Open the file main.ino from OpenMQTTGateway/main folder
+* 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
+* Open the serial monitor and set 115200 bauds
+* Upload ➡️
+* You should see the logs into the serial monitor

docs/upload/binaries.md

@@ -5,6 +5,8 @@ Nevertheless you will not be able to change advanced parameters, if you want to
 Download the binary corresponding to your board and gateway [here](https://github.com/1technophile/OpenMQTTGateway/releases) from github and uncompress it.
 
 ## ESP32
+* Download the bootloader [here](https://github.com/espressif/arduino-esp32/raw/master/tools/sdk/bin/bootloader_dio_80m.bin)
+* Download the boot_app0 from [here](https://github.com/espressif/arduino-esp32/raw/master/tools/partitions/boot_app0.bin)
 * Download the flash tool utility from espressif:
 https://www.espressif.com/en/products/hardware/esp32/resources
 * Uncompress the package

docs/use/actuators.md

@@ -20,6 +20,18 @@ ON command
 `mosquitto_pub -t home/OpenMQTTGateway_MEGA/commands/MQTTtoONOFF -m '{"pin":15,"state":1}'`
 
 ## FASTLED
+### The FASTLED module support 2 different operation modes
+1. control one specific RGB LED
+* Set color
+* Set blink
+
+2. Start fire animation (Fire2012)
+
+### Hardware wiring
+Theoreticaly it should be possible to use every free IO pin. But after some tests only pin D2 works at WEMOS D1. Other platforms can work.
+The default setting use NEOPIXEL (WS2812B). The simplest wiring is direct connect D2 to data pin of LED stripe and connect VCC/GND to power source. You should also add an capacitor.
+
+