Fork of the espurna firmware for `mhsw` switches
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

370 lines
24 KiB

8 years ago
6 years ago
6 years ago
6 years ago
8 years ago
7 years ago
7 years ago
6 years ago
6 years ago
7 years ago
7 years ago
6 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
6 years ago
6 years ago
7 years ago
6 years ago
7 years ago
6 years ago
6 years ago
7 years ago
6 years ago
6 years ago
6 years ago
6 years ago
7 years ago
7 years ago
6 years ago
6 years ago
7 years ago
6 years ago
7 years ago
6 years ago
7 years ago
7 years ago
6 years ago
6 years ago
7 years ago
7 years ago
6 years ago
7 years ago
7 years ago
6 years ago
6 years ago
6 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
7 years ago
6 years ago
6 years ago
7 years ago
6 years ago
7 years ago
6 years ago
6 years ago
6 years ago
6 years ago
6 years ago
6 years ago
7 years ago
7 years ago
8 years ago
8 years ago
8 years ago
8 years ago
  1. # ESPurna Firmware
  2. ESPurna ("spark" in Catalan) is a custom firmware for ESP8285/ESP8266 based smart switches, lights and sensors.
  3. It uses the Arduino Core for ESP8266 framework and a number of 3rd party libraries.
  4. [![version](https://img.shields.io/badge/version-1.13.6--dev-brightgreen.svg)](CHANGELOG.md)
  5. [![branch](https://img.shields.io/badge/branch-dev-orange.svg)](https://github.com/xoseperez/espurna/tree/dev/)
  6. [![license](https://img.shields.io/github/license/xoseperez/espurna.svg)](LICENSE)
  7. [![travis](https://travis-ci.org/xoseperez/espurna.svg?branch=dev)](https://travis-ci.org/xoseperez/espurna)
  8. [![codacy](https://api.codacy.com/project/badge/Grade/c9496e25cf07434cba786b462cb15f49)](https://www.codacy.com/app/xoseperez/espurna/dashboard)
  9. [![downloads](https://img.shields.io/github/downloads/xoseperez/espurna/total.svg)](https://github.com/xoseperez/espurna/releases)
  10. <br />
  11. [![donate](https://img.shields.io/badge/donate-PayPal-blue.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=xose%2eperez%40gmail%2ecom&lc=US&no_note=0&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_LG%2egif%3aNonHostedGuest)
  12. [![gitter](https://img.shields.io/gitter/room/tinkermant-cat/espurna.svg)](https://gitter.im/tinkerman-cat/espurna)
  13. [![twitter](https://img.shields.io/twitter/follow/xoseperez.svg?style=social)](https://twitter.com/intent/follow?screen_name=xoseperez)
  14. ---
  15. ## Collaborators
  16. Since November 2018, Max Prokhorov (@mcspr) is also actively working as a collaborator of the project.
  17. ## Contributors
  18. **Without your help this project would not be possible**. I (@xoseperez) simply can't spend all the time I wish on ESPurna but luckly I recieve a lot of contributions, bug fixes, enhancement suggestions,... from people all around the world. I would like to thank each and every one of you. The [contributors](https://github.com/xoseperez/espurna/graphs/contributors) page shows the ones that have done a PR in the past, but I also get contributions in the issues, by email or via the [gitter ESPurna channel](https://gitter.im/tinkerman-cat/espurna), those I also want to thank.
  19. **Thank you all very much**.
  20. ## Notice
  21. > Ladies and gentlemen in the embedded world, use [PlatformIO](https://platformio.org/). If I could offer you only one tip for the future, [PlatformIO](https://platformio.org/) would be it.
  22. > Please use the [gitter ESPurna channel](https://gitter.im/tinkerman-cat/espurna) for support and questions, you have better chances to get fast answers from me or other ESPurna users. Open an issue here only if you feel there is a bug or you want to request an enhancement. Thank you.
  23. ## Features
  24. * *KRACK* vulnerability free (when built with Arduino Core >= 2.4.0)
  25. * Support for **multiple ESP8266-based boards** ([check list](https://github.com/xoseperez/espurna/wiki/Hardware))
  26. * Power saving options
  27. * Wifi **AP Mode** or **STA mode**
  28. * Supports static IP
  29. * Up to 5 different networks can be defined
  30. * Scans for strongest network if more than one defined (also available in web UI)
  31. * Handles correctly multiple AP with the same SSID
  32. * Defaults to AP mode (also available after double clicking the main button)
  33. * Support for **WPS** and **Smart Config** (not available in default builds)
  34. * Network visibility
  35. * Supports mDNS (service reporting and metadata) both server mode and client mode (.local name resolution)
  36. * Supports NetBIOS, LLMNR and Netbios (when built with Arduino Core >= 2.4.0) and SSDP (experimental)
  37. * Switch management
  38. * Support for **push buttons** and **toggle switches**
  39. * Configurable **status on boot** per switch (always ON, always OFF, same as before or toggle)
  40. * Support for **pulse mode** per switch (normally ON or normally OFF) with configurable time
  41. * Support for **relay synchronization** (all equal, only one ON, one and only on ON)
  42. * Support for **MQTT groups** to sync switches between devices
  43. * Support for **delayed ON/OFF**
  44. * Support for **latched relays**
  45. * **MQTT** enabled
  46. * **SSL/TLS support** (not on regular builds, see [#64](https://github.com/xoseperez/espurna/issues/64))
  47. * Switch on/off and toggle relays, group topics (sync relays between different devices)
  48. * Report button event notifications
  49. * Enable/disable pulse mode
  50. * Change LED notification mode
  51. * Remote reset the board
  52. * Fully configurable in webUI (broker, user, password, QoS, keep alive time, retain flag, client ID)
  53. * **Scheduler** to automatically turn on, off or toggle any relay at a given time and day, also change light intensity for dimmers
  54. * **Alexa** integration using the [FauxmoESP Library](https://bitbucket.org/xoseperez/fauxmoesp)
  55. * [**Google Assistant**](http://tinkerman.cat/using-google-assistant-control-your-esp8266-devices/) integration using IFTTT and Webhooks (Google Home, Allo)
  56. * [**Domoticz**](https://domoticz.com/) integration via MQTT
  57. * [**Home Assistant**](https://home-assistant.io/) integration
  58. * Support for switches (on/off)
  59. * Support for lights (color, brightness, on/off state)
  60. * Supports MQTT auto-discover feature (switches, lights and sensors)
  61. * Integration via MQTT Discover or copy-pasting configuration code
  62. * [**InfluxDB**](https://www.influxdata.com/) integration via HTTP API
  63. * [**Thingspeak**](https://thingspeak.com/) integration via HTTP API (HTTPS available for custom builds)
  64. * **Sonoff RF Bridge** support
  65. * Multiple virtual switches (tested with up to 16)
  66. * MQTT-to-RF two-way bridge (no need to learn codes)
  67. * Support for [https://github.com/Portisch/RF-Bridge-EFM8BB1](https://github.com/Portisch/RF-Bridge-EFM8BB1) custom firmware
  68. * Support for [direct control of the encoder/decoder bypassing the EFM8BB1](https://github.com/xoseperez/espurna/wiki/Hardware-Itead-Sonoff-RF-Bridge---Direct-Hack)
  69. * Support for [different **sensors**](Sensors)
  70. * Environment
  71. * **DHT11 / DHT12 / DHT22 / DHT21 / AM2301 / Itead's SI7021**
  72. * **BMP180**, **BMP280** and **BME280** pressure, humidity (BME280) and temperature (BMP280 & BME280) sensor by Bosch
  73. * **TMP35** and **TMP36** analog temperature sensors
  74. * **MAX6675** temperature sensor
  75. * **NTC** temperature sensors
  76. * **SI7021** temperature and humidity sensor
  77. * **SHT3X** temperature and humidity sensor over I2C (Wemos shield)
  78. * **AM2320** temperature and humidity sensor over I2C
  79. * **Dallas OneWire sensors** like the DS18B20
  80. * **MHZ19** CO2 sensor
  81. * **MICS2710** CO2 & NO2 sensor
  82. * **MICS5525** CO & CO2 sensor
  83. * **SenseAir S8** CO2 sensor
  84. * **PMSX003/PMS5003T/ST** dust sensors
  85. * **SDS011** dust sensor
  86. * **BH1750** luminosity sensor
  87. * **GUVAS12SD** UV sensor
  88. * **VEML6075** UV Sensor
  89. * **EZO pH Circuit**
  90. * **Geiger counter** by RH Electronics
  91. * **HC-SR04**, **SRF05**, **SRF06**, **DYP-ME007**, **JSN-SR04T** & **Parallax PING)))™** distance sensors
  92. * **VL53L1X** distance sensor
  93. * Power monitoring
  94. * **HLW8012** using the [HLW8012 Library](https://bitbucket.org/xoseperez/hlw8012) (Sonoff POW)
  95. * **CSE7766** and **CSE7759B** power monitor chips
  96. * **HJL-01** and **BL0937** power monitor chips
  97. * Non-invasive **current sensor** using **internal ADC** or **ADC712** or **ADC121** or **ADS1115**
  98. * **V9261F** power monitor chip
  99. * **PZEM0004T** power monitor board
  100. * Raw **analog** and **digital** sensors
  101. * Simple **pulse counter** with **event triggering** option
  102. * Support for (almost) any UART based sensor via the **UART-to-MQTT module**
  103. * Support for different units (Fahrenheit or Celsius, Watts or Kilowatts, Joules or kWh)
  104. * Support for LED lights
  105. * MY92XX-based light bulbs and PWM LED strips (dimmers) up to 5 channels (RGB, cold white and warm white, for instance)
  106. * Support for CCT lights
  107. * RGB and HSV color codes supported
  108. * Manage channels individually
  109. * Temperature color supported (in [mired](https://en.wikipedia.org/wiki/Mired) and [kelvin](https://en.wikipedia.org/wiki/Color_temperature)) via MQTT / REST API
  110. * Flicker-free PWM management
  111. * Soft color transitions
  112. * Color synchronization between light using MQTT
  113. * Option to have separate switches for each channel
  114. * Support for simple 433MHz RF receivers
  115. * Support for UART-to-MQTT bidirectional bridge
  116. * Fast asynchronous **HTTP Server** and cool **Web User Interface**
  117. * Configurable port
  118. * Basic authentication
  119. * Web-based configuration
  120. * Relay switching and sensor data from the web interface
  121. * Handle color, brightness, and white/warm channels for lights
  122. * Websockets-based communication between the device and the browser
  123. * Backup and restore settings option
  124. * Upgrade firmware from the web interface
  125. * Works great behind a [secured reverse proxy](http://tinkerman.cat/secure-remote-access-to-your-iot-devices/)
  126. * **REST API** (enable/disable from web interface)
  127. * GET and PUT relay status (including pulses)
  128. * Change light color (for supported hardware)
  129. * GET sensor data (power, current, voltage, temperature and humidity) depending on the available hardware
  130. * Works great behind a secured reverse proxy
  131. * **RPC API** (enable/disable from web interface)
  132. * Remote reset the board
  133. * **Over-The-Air** (OTA) updates even for 1Mb boards
  134. * Manually from PlatformIO or Arduino IDE
  135. * Automatic updates through the [NoFUSS Library](https://bitbucket.org/xoseperez/nofuss)
  136. * Update from web interface using pre-built images
  137. * **Command line configuration**
  138. * Change configuration
  139. * Run special commands
  140. * **Telnet support**
  141. * Enable/disable via the web UI
  142. * Shows debug info and allows to run terminal commands
  143. * **NTP** for time synchronization
  144. * Supports worldwide time zones
  145. * Compatible with DST (EU and USA)
  146. * **Unstable system check**
  147. * Detects unstable system (crashes on boot continuously) and defaults to a stable system
  148. * Only WiFi AP, OTA and Telnet available if system is flagged as unstable
  149. * Configurable LED notifications based on WiFi status, relays status or MQTT messages.
  150. * Button interface
  151. * Click to toggle relays
  152. * Double click to enter AP mode (only main button)
  153. * Long click (>1 second) to reboot device (only main button)
  154. * Extra long click (>10 seconds) to go back to factory settings (only main button)
  155. * Specific definitions for touch button devices (ESPurna Switch, Sonoff Touch & T1)
  156. * Configuration stored in different sectors to prevent data loosing and corruption
  157. ## Notices
  158. ---
  159. > **2018-04-08**<br />
  160. > Please use [gitter](https://gitter.im/tinkerman-cat/espurna) for support and questions, you have better chances to get fast answers by me or other ESPurna users. Open an issue here only if you feel there is a bug or you want to request an enhancement. Thank you.
  161. ---
  162. > **2018-03-09**<br />
  163. > Default branch in GitHub is now the development branch "dev".<br>
  164. > The stable branch (the one used to create the [binary releases](https://github.com/xoseperez/espurna/releases)) is "[master](https://github.com/xoseperez/espurna/tree/master)".
  165. ---
  166. > **2018-01-24**<br />
  167. > This repository has been migrated from Bitbucket to GitHub. There were a number of reason to migrate the repository to GitHub. I like Bitbucket and I'm still using it for a lot of projects, but ESPurna has grown and its community as well. Some users have complain about Bitbucket not being enough community-focused. This change is mainly aimed to use a platform with greater acceptance on the open-source community and tools better suited to them (to you), like the possibility to contribute to the documentation in an easy way.
  168. >
  169. >What happened with all the info in Bitbucket? Well, most of it has been ported to GitHub, albeit with some quirks:
  170. >
  171. >* **Code** has, of course been migrated completely
  172. >* **Issues** are all on GitHub already **but** all issues and comments show up as reported by me. The original reporter is referenced inside the body of the issue (or comment) with a link to his/her profile at Bitbucket and a link to his/her profile at GitHub if it happens to be the same username. I **suggest all reporters to subscribe to the issues they originally filed** (search for your BitBucket username to list them).
  173. >* **Pull requests** historic has not been migrated. At the moment of the migration all pull-requests have been either merged or declined. Of course, those PR merged are in the code base, but the historic and comments in the PR pages will be lost.
  174. >* **Documentation** it's on it way, first step will be to migrate existing wiki, maybe with a new TOC structure
  175. >* **Watchers**, **Forks**, I'm afraid they are all gone. Visit the new repo home and click on the "Watch" button on the top right. And as you do it click also on the "Star" button too :)
  176. >
  177. >I apologize for any inconvenience this migration may have caused. I have decided to do it the hard way.
  178. ---
  179. > **2018-01-11**<br />
  180. > As of current version (1.12.0) ESPurna is tested using Arduino Core 2.3.0 and it's meant to be built against that version.
  181. ---
  182. > **2017-08-26**<br />
  183. > Since version 1.9.0 the default **MQTT topics for commands have changed**. They all now end with "/set". This means you will have to change your controller software (Node-RED or alike) to send messages to -for instance- "/home/living/light/relay/0/set". The device will publish its state in "/home/living/light/relay/0" like before.
  184. ---
  185. > **2017-07-24**<br />
  186. > Default flash layout changed in 1.8.3, as an unpredicted consequence devices will not be able to persist/retrieve configuration if flashed with 1.8.3 via **OTA** from **PlatformIO**. Please check issue [#187](https://github.com/xoseperez/espurna/issues/187).
  187. ---
  188. ## Contribute
  189. There are several ways to contribute to ESPurna development. You can contribute to the repository by doing:
  190. * Pull requests (fixes, enhancements, new features... are very welcome)
  191. * Documentation (I reckon I'm bad at it)
  192. * Testing (filing issues or help resolving them, they take a lot of time and sometimes I don't have the required hardware to test them all)
  193. And of course you can always buy me a beer, coffee, tea,... via the donation button below.
  194. [![Donate](https://img.shields.io/badge/donate-PayPal-blue.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=xose%2eperez%40gmail%2ecom&lc=US&no_note=0&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_LG%2egif%3aNonHostedGuest)
  195. ## Documentation
  196. For more information please refer to the [ESPurna Wiki](https://github.com/xoseperez/espurna/wiki).
  197. ## Supported hardware
  198. Here is the list of supported hardware. For more information please refer to the [ESPurna Wiki Hardware page](https://github.com/xoseperez/espurna/wiki/Hardware).
  199. ### Power monitoring devices
  200. ||||
  201. |---|---|---|
  202. |![BlitzWolf BW-SHP6](images/devices/blitzwolf-bw-shp6.jpg)|![BlitzWolf BW-SHP2](images/devices/blitzwolf-bw-shp2.jpg)|![Power meters based on V9261F](images/devices/generic-v9261f.jpg)|
  203. |**Blitzwolf BW-SHP6**|**Blitzwolf BW-SHP2<br />(also by Coosa, Gosund, HomeCube, Teckin)**|**Power meters based on V9261F**|
  204. |![Itead Sonoff POW](images/devices/itead-sonoff-pow.jpg)|![Itead Sonoff POW](images/devices/itead-sonoff-pow-r2.jpg)|![Itead Sonoff S31](images/devices/itead-sonoff-s31.jpg)|
  205. |**Itead Sonoff POW**|**Itead Sonoff POW R2**|**Itead Sonoff S31**|
  206. |![Smartlife Mini Smart Socket](images/devices/smartlife-mini-smart-socket.jpg)|![Teckin SP20](images/devices/teckin-sp20.jpg)|![Digoo NX SP202](images/devices/digoo-nx-sp202.jpg)|
  207. |**Smartlife (NETVIP) Mini Smart Socket**|**Teckin SP20**|**Digoo NX SP202**|
  208. |![Vanzavanzu Smart WiFi Plug Mini](images/devices/vanzavanzu-smart-wifi-plug-mini.jpg)|||
  209. |**Vanzavanzu Smart WiFi Plug Mini**|||
  210. ### Embedded switches
  211. ||||
  212. |---|---|---|
  213. |![Itead Sonoff Basic](images/devices/itead-sonoff-basic.jpg)|![Itead Sonoff Dual/Dual R2](images/devices/itead-sonoff-dual.jpg)|![Itead Sonoff TH10/TH16](images/devices/itead-sonoff-th.jpg)|
  214. |**Itead Sonoff Basic**|**Itead Sonoff Dual/Dual R2**|**Itead Sonoff TH10/TH16**|
  215. |![Electrodragon WiFi IOT](images/devices/electrodragon-wifi-iot.jpg)|![OpenEnergyMonitor WiFi MQTT Relay / Thermostat](images/devices/openenergymonitor-mqtt-relay.jpg)||
  216. |**Electrodragon WiFi IOT**|**OpenEnergyMonitor WiFi MQTT Relay / Thermostat**||
  217. |![Itead Sonoff 4CH](images/devices/itead-sonoff-4ch.jpg)|![Itead Sonoff 4CH Pro](images/devices/itead-sonoff-4ch-pro.jpg)||
  218. |**Itead Sonoff 4CH**|**Itead Sonoff 4CH Pro**||
  219. |![Allterco Shelly1](images/devices/allterco-shelly1.jpg)|![Allterco Shelly2](images/devices/allterco-shelly2.jpg)|![Jan Goedeke Wifi Relay (NO/NC)](images/devices/jangoe-wifi-relay.jpg)|
  220. |**Alterco Shelly1**|**Alterco Shelly2**|**Jan Goedeke Wifi Relay (NO/NC)**|
  221. |![EXS Wifi Relay v3.1](images/devices/exs-wifi-relay-v31.jpg)|![EXS Wifi Relay v5.0](images/devices/exs-wifi-relay-v50.jpg)|![Jorge García Wifi + Relays Board Kit](images/devices/jorgegarcia-wifi-relays.jpg)|
  222. |**EXS Wifi Relay v3.1**|**EXS Wifi Relay v5.0**|**Jorge García Wifi + Relays Board Kit**|
  223. |![Allnet ESP8266-UP-Relay](images/devices/allnet-esp8266-up-relay.jpg)|![Bruno Horta's OnOfre](images/devices/bh-onofre.jpg)|![Luani HVIO](images/devices/luani-hvio.jpg)|
  224. |**Allnet ESP8266-UP-Relay**|**Bruno Horta's OnOfre**|**Luani HVIO**|
  225. ### Wall Sockets
  226. ||||
  227. |---|---|---|
  228. |![Itead S20](images/devices/itead-s20.jpg)|![Itead S26](images/devices/itead-s26.jpg)|![Neo Coolcam NAS WR01W](images/devices/neo-coolcam-wifi.jpg)|
  229. |**Itead S20**|**Itead S26**|**Neo Coolcam NAS WR01W**|
  230. |![Maxcio W-US002S](images/devices/maxcio-w-us002s.jpg)|![HEYGO HY02](images/devices/heygo-hy02.jpg)|![YiDian XS-SSA05](images/devices/yidian-xs-ssa05.jpg)|
  231. |**Maxcio W-US002S**|**HEYGO HY02**|**YiDian XS-SSA05**|
  232. |![WiOn 50055](images/devices/wion-50055.jpg)|![LINGAN SWA1](images/devices/lingan-swa1.jpg)|![HomeCube 16A](images/devices/homecube-16a.jpg)|
  233. |**WiOn 50055**|**LINGAN SWA1**|**HomeCube 16A**|
  234. |![WorkChoice EcoPlug](images/devices/workchoice-ecoplug.jpg)|![Bestek MRJ1011](images/devices/bestek-mrj1011.jpg)|![Tonbux XS-SSA01](images/devices/tonbux-xs-ssa01.jpg)|
  235. |**WorkChoice EcoPlug**|**Bestek MRJ1011**|**Tonbux XS-SSA01**|
  236. |![Schuko Wifi Plug](images/devices/schuko-wifi-plug.jpg)|![Schuko Wifi Plug V2](images/devices/schuko-wifi-plug-v2.jpg)|![KMC 70011](images/devices/kmc-70011.jpg)|
  237. |**Schuko Wifi Plug**|**Schuko Wifi Plug V2**|**KMC 70011**|
  238. |![Xenon SM-PW702U](images/devices/xenon-sm-pw702u.jpg)|![Orvibo B25](images/devices/orvibo-b25.jpg)|![Oukitel P1](images/devices/oukitel-p1.jpg)|
  239. |**Xenon SM-PW702U**|**Orvibo B25**|**Oukitel P1**|
  240. |![Tonbux XS-SSA06](images/devices/tonbux-xs-ssa06.jpg)|![Litesun LA-WF3](images/devices/litesun-la-wf3.jpg)|![Maxcio W DE-004](images/devices/maxcio-w-de004.jpg)|
  241. |**Tonbux XS-SSA06**|**Litesun LA-WF3**|**Maxcio W DE-004**|
  242. |![Hama WiFi Steckdose](images/devices/hama-wifi-steckdose.jpg)|![GBLife RGBW Socket](images/devices/gblife-rgbw-socket.jpg)||
  243. |**Hama WiFi Steckdose**|**GBLife RGBW Socket**||
  244. ### Wall switches
  245. ||||
  246. |---|---|---|
  247. |![Itead Sonoff Touch](images/devices/itead-sonoff-touch.jpg)|![Itead Sonoff T1](images/devices/itead-sonoff-t1.jpg)|![YJZK switch](images/devices/yjzk-2gang-switch.jpg)|
  248. |**Itead Sonoff Touch**|**Itead Sonoff T1**|**YJZK 1/2/3-gangs switch**|
  249. |![Gosund WS1 / KS-602S](images/devices/gosund-ws1.jpg)|||
  250. |**Gosund WS1 / KS-602S**|||
  251. ### Power strips
  252. ||||
  253. |---|---|---|
  254. |![Tonbux PowerStrip02](images/devices/tonbux-powerstrip02.jpg)|![ForNorm ZLD-34EU](images/devices/fornorm-power-strip.jpg)|![Zhilde ZLD-EU55-W](images/devices/zhilde-zld-eu55-w.jpg)|
  255. |**Tonbux PowerStrip02**|**Fornorm Power Strip**|**Zhilde ZLD-EU55-W**|
  256. ### Smart lights
  257. ||||
  258. |---|---|---|
  259. |![Itead Slampher](images/devices/itead-slampher.jpg)|![Arilux E27](images/devices/arilux-e27.jpg)|![Itead Sonoff B1](images/devices/itead-sonoff-b1.jpg)|
  260. |**Itead Slampher**|**Arilux E27**|**Itead Sonoff B1**|
  261. |![AI-Thinker Wifi Light / Noduino OpenLight](images/devices/aithinker-ai-light.jpg)|![Authometion LYT8266](images/devices/authometion-lyt8266.jpg)|![AG-L4](images/devices/ag-l4.jpg)|
  262. |**AI-Thinker Wifi Light / Noduino OpenLight**|**Authometion LYT8266**|**AG-L4**|
  263. |![Lohas 9W](images/devices/lohas-9w.jpg)|![Xiaomi Smart Desk Lamp](images/devices/xiaomi-smart-desk-lamp.jpg)|![iWoole LED Table Lamp](images/devices/iwoole-led-table-lamp.jpg)|
  264. |**Lohas 9W**|**Xiaomi Smart Desk Lamp**|**iWoole LED Table Lamp**|
  265. |![Itead Sonoff LED](images/devices/itead-sonoff-led.jpg)|![Itead BN-SZ01](images/devices/itead-bn-sz01.jpg)|![Lombox LUX Nova 2](images/devices/lombex-lux-nova2.jpg)|
  266. |**Itead Sonoff LED**|**Itead BN-SZ01**|**Lombex LUX Nova 2 (white and color)**|
  267. |![Arilux AL-LC01 (RGB)](images/devices/arilux-al-lc01.jpg)|![Arilux AL-LC02 (RGBW)](images/devices/arilux-al-lc02.jpg)|![Arilux AL-LC06 (RGBWWCW)](images/devices/arilux-al-lc06.jpg)|
  268. |**Arilux AL-LC01 (RGB)**|**Arilux AL-LC02 (RGBW)**|**Arilux AL-LC06 (RGBWWCW)**|
  269. |![Arilux AL-LC11 (RGBWWW) & RF](images/devices/arilux-al-lc11.jpg)|![MagicHome LED Controller (1.0 and 2.x)](images/devices/magichome-led-controller.jpg)|![Huacanxing H801/802](images/devices/huacanxing-h801.jpg)|
  270. |**Arilux AL-LC11 (RGBWWW) & RF**|**MagicHome LED Controller (1.0/2.x, also ZJ WFMN A/B11)**|**Huacanxing H801/802**|
  271. ### Radio links / gateways
  272. ||||
  273. |---|---|---|
  274. |![Tinkerman RFM69GW](images/devices/tinkerman-rfm69gw.jpg)|![Itead Sonoff RF Bridge](images/devices/itead-sonoff-rfbridge.jpg)|![Itead Sonoff RF](images/devices/itead-sonoff-rf.jpg)|
  275. |**Tinkerman RFM69GW**|**Itead Sonoff RF Bridge**|**Itead Sonoff RF**|
  276. ### Other devices
  277. ||||
  278. |---|---|---|
  279. |![Tonbux Mosquito Killer](images/devices/tonbux-mosquito-killer.jpg)|![Itead Sonoff IFAN02](images/devices/itead-sonoff-ifan02.jpg)||
  280. |**Tonbux Mosquito Killer**|**Itead Sonoff IFAN02**|||
  281. ### Custom & Development boards
  282. ||||
  283. |---|---|---|
  284. |![Tinkerman Espurna H](images/devices/tinkerman-espurna-h.jpg)||![NodeMCU](images/devices/nodemcu-lolin-v3.jpg)|
  285. |**Tinkerman ESPurna H**||**NodeMCU Lolin V3**|
  286. |![Itead Sonoff SV](images/devices/itead-sonoff-sv.jpg)|![Itead 1CH Inching](images/devices/itead-1ch-inching.jpg)|![Itead Motor Clockwise/Anticlockwise](images/devices/itead-motor.jpg)|
  287. |**Itead Sonoff SV**|**Itead 1CH Inching**|**Itead Motor Clockwise/Anticlockwise**|
  288. |![ManCaveMade ESP-Live](images/devices/mancavemade-esp-live.jpg)|![Wemos D1 Mini Relay Shield](images/devices/wemos-d1-relayshield.jpg)|![Gizwits Witty Cloud](images/devices/witty-cloud.jpg)|
  289. |**ManCaveMade ESP-Live**|**Wemos D1 Mini Relay Shield**|**Gizwits Witty Cloud**|
  290. |![IKE ESPike](images/devices/ike-espike.jpg)|![Pilotak ESP DIN](images/devices/pilotak-esp-din.jpg)|![Arniex Swifitch](images/devices/arniex-swifitch.jpg)|
  291. |**IKE ESPike**|**Pilotak ESP DIN**|**Arniex Swifitch**|
  292. |![Heltec Touch Relay](images/devices/heltec-touch-relay.jpg)|![Generic Relay v4.0](images/devices/generic-relay-40.jpg)|![Generic RGBLed v1.0](images/devices/generic-rgbled-10.jpg)|
  293. |**Heltec Touch Relay**|**Generic Relay v4.0**|**Generic RGBLed v1.0**|
  294. |![Generic DHT11 v1.0](images/devices/generic-dht11-10.jpg)|![Generic DS18B20 v1.0](images/devices/generic-ds18b20-10.jpg)|![InterMitTech QuinLED 2.6](images/devices/intermittech-quinled-2.6.jpg)|
  295. |**Generic DHT11 v1.0**|**Generic DS18B20 v1.0**|**InterMitTech QuinLED 2.6**|
  296. |![Phyx ESP12 RGBW](images/devices/phyx-esp12-rgbw.jpg)|![RH Electronics Geiger Counter](images/devices/generic-geiger-diy.png)|![Green ESP Relay](images/devices/green-esp-relay.jpg)|
  297. |**Phyx ESP12 RGBW**|**RH Electronics Geiger Counter**|**Green ESP Relay**|
  298. |![Foxel Lightfox Dual](images/devices/foxel-lightfox-dual.jpg)|||
  299. |**Foxel Lightfox Dual**|||
  300. **Other supported boards (beta):**
  301. KMC 4 Outlet, Gosund WS1, MakerFocus Intelligent Module LM33 for Lamps
  302. ## License
  303. Copyright (C) 2016-2019 by Xose Pérez (@xoseperez)
  304. This program is free software: you can redistribute it and/or modify
  305. it under the terms of the GNU General Public License as published by
  306. the Free Software Foundation, either version 3 of the License, or
  307. (at your option) any later version.
  308. This program is distributed in the hope that it will be useful,
  309. but WITHOUT ANY WARRANTY; without even the implied warranty of
  310. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  311. GNU General Public License for more details.
  312. You should have received a copy of the GNU General Public License
  313. along with this program. If not, see <http://www.gnu.org/licenses/>.