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.

1838 lines
62 KiB

8 years ago
8 years ago
6 years ago
7 years ago
7 years ago
7 years ago
Terminal: change command-line parser (#2247) Change the underlying command line handling: - switch to a custom parser, inspired by redis / sds - update terminalRegisterCommand signature, pass only bare minimum - clean-up `help` & `commands`. update settings `set`, `get` and `del` - allow our custom test suite to run command-line tests - clean-up Stream IO to allow us to print large things into debug stream (for example, `eeprom.dump`) - send parsing errors to the debug log As a proof of concept, introduce `TERMINAL_MQTT_SUPPORT` and `TERMINAL_WEB_API_SUPPORT` - MQTT subscribes to the `<root>/cmd/set` and sends response to the `<root>/cmd`. We can't output too much, as we don't have any large-send API. - Web API listens to the `/api/cmd?apikey=...&line=...` (or PUT, params inside the body). This one is intended as a possible replacement of the `API_SUPPORT`. Internals introduce a 'task' around the AsyncWebServerRequest object that will simulate what WiFiClient does and push data into it continuously, switching between CONT and SYS. Both are experimental. We only accept a single command and not every command is updated to use Print `ctx.output` object. We are also somewhat limited by the Print / Stream overall, perhaps I am overestimating the usefulness of Arduino compatibility to such an extent :) Web API handler can also sometimes show only part of the result, whenever the command tries to yield() by itself waiting for something. Perhaps we would need to create a custom request handler for that specific use-case.
4 years ago
api: rework plain and JSON implementations (#2405) - match paths through a custom AsyncWebHandler instead of using generic not-found fallback handler - allow MQTT-like patterns when registering paths (`simple/path`, `path/+/something`, `path/#`) Replaces `relay/0`, `relay/1` etc. with `relay/+`. Magnitudes are plain paths, but using `/+` in case there's more than 1 magnitude of the same type. - restore `std::function` as callback container (no more single-byte arg nonsense). Still, limit to 1 type per handler type - adds JSON handlers which will receive JsonObject root as both input and output. Same logic as plain - GET returns resource data, PUT updates it. - breaking change to `apiAuthenticate(request)`, it no longer will do `request->send(403)` and expect this to be handled externally. - allow `Api-Key` header containing the key, works for both GET & PUT plain requests. The only way to set apikey for JSON. - add `ApiRequest::param` to retrieve both GET and PUT params (aka args), remove ApiBuffer - remove `API_BUFFER_SIZE`. Allow custom form-data key=value pairs for requests, allow to send basic `String`. - add `API_JSON_BUFFER_SIZE` for the JSON buffer (both input and output) - `/apis` replaced with `/api/list`, no longer uses custom handler and is an `apiRegister` callback - `/api/rpc` custom handler replaced with an `apiRegister` callback WIP further down: - no more `webLog` for API requests, unless `webAccessLog` / `WEB_ACCESS_LOG` is set to `1`. This also needs to happen to the other handlers. - migrate to ArduinoJson v6, since it become apparent it is actually a good upgrade :) - actually make use of JSON endpoints more, right now it's just existing GET for sensors and relays - fork ESPAsyncWebServer to cleanup path parsing and temporary objects attached to the request (also, fix things a lot of things based on PRs there...)
4 years ago
Terminal: change command-line parser (#2247) Change the underlying command line handling: - switch to a custom parser, inspired by redis / sds - update terminalRegisterCommand signature, pass only bare minimum - clean-up `help` & `commands`. update settings `set`, `get` and `del` - allow our custom test suite to run command-line tests - clean-up Stream IO to allow us to print large things into debug stream (for example, `eeprom.dump`) - send parsing errors to the debug log As a proof of concept, introduce `TERMINAL_MQTT_SUPPORT` and `TERMINAL_WEB_API_SUPPORT` - MQTT subscribes to the `<root>/cmd/set` and sends response to the `<root>/cmd`. We can't output too much, as we don't have any large-send API. - Web API listens to the `/api/cmd?apikey=...&line=...` (or PUT, params inside the body). This one is intended as a possible replacement of the `API_SUPPORT`. Internals introduce a 'task' around the AsyncWebServerRequest object that will simulate what WiFiClient does and push data into it continuously, switching between CONT and SYS. Both are experimental. We only accept a single command and not every command is updated to use Print `ctx.output` object. We are also somewhat limited by the Print / Stream overall, perhaps I am overestimating the usefulness of Arduino compatibility to such an extent :) Web API handler can also sometimes show only part of the result, whenever the command tries to yield() by itself waiting for something. Perhaps we would need to create a custom request handler for that specific use-case.
4 years ago
8 years ago
8 years ago
api: rework plain and JSON implementations (#2405) - match paths through a custom AsyncWebHandler instead of using generic not-found fallback handler - allow MQTT-like patterns when registering paths (`simple/path`, `path/+/something`, `path/#`) Replaces `relay/0`, `relay/1` etc. with `relay/+`. Magnitudes are plain paths, but using `/+` in case there's more than 1 magnitude of the same type. - restore `std::function` as callback container (no more single-byte arg nonsense). Still, limit to 1 type per handler type - adds JSON handlers which will receive JsonObject root as both input and output. Same logic as plain - GET returns resource data, PUT updates it. - breaking change to `apiAuthenticate(request)`, it no longer will do `request->send(403)` and expect this to be handled externally. - allow `Api-Key` header containing the key, works for both GET & PUT plain requests. The only way to set apikey for JSON. - add `ApiRequest::param` to retrieve both GET and PUT params (aka args), remove ApiBuffer - remove `API_BUFFER_SIZE`. Allow custom form-data key=value pairs for requests, allow to send basic `String`. - add `API_JSON_BUFFER_SIZE` for the JSON buffer (both input and output) - `/apis` replaced with `/api/list`, no longer uses custom handler and is an `apiRegister` callback - `/api/rpc` custom handler replaced with an `apiRegister` callback WIP further down: - no more `webLog` for API requests, unless `webAccessLog` / `WEB_ACCESS_LOG` is set to `1`. This also needs to happen to the other handlers. - migrate to ArduinoJson v6, since it become apparent it is actually a good upgrade :) - actually make use of JSON endpoints more, right now it's just existing GET for sensors and relays - fork ESPAsyncWebServer to cleanup path parsing and temporary objects attached to the request (also, fix things a lot of things based on PRs there...)
4 years ago
6 years ago
6 years ago
api: rework plain and JSON implementations (#2405) - match paths through a custom AsyncWebHandler instead of using generic not-found fallback handler - allow MQTT-like patterns when registering paths (`simple/path`, `path/+/something`, `path/#`) Replaces `relay/0`, `relay/1` etc. with `relay/+`. Magnitudes are plain paths, but using `/+` in case there's more than 1 magnitude of the same type. - restore `std::function` as callback container (no more single-byte arg nonsense). Still, limit to 1 type per handler type - adds JSON handlers which will receive JsonObject root as both input and output. Same logic as plain - GET returns resource data, PUT updates it. - breaking change to `apiAuthenticate(request)`, it no longer will do `request->send(403)` and expect this to be handled externally. - allow `Api-Key` header containing the key, works for both GET & PUT plain requests. The only way to set apikey for JSON. - add `ApiRequest::param` to retrieve both GET and PUT params (aka args), remove ApiBuffer - remove `API_BUFFER_SIZE`. Allow custom form-data key=value pairs for requests, allow to send basic `String`. - add `API_JSON_BUFFER_SIZE` for the JSON buffer (both input and output) - `/apis` replaced with `/api/list`, no longer uses custom handler and is an `apiRegister` callback - `/api/rpc` custom handler replaced with an `apiRegister` callback WIP further down: - no more `webLog` for API requests, unless `webAccessLog` / `WEB_ACCESS_LOG` is set to `1`. This also needs to happen to the other handlers. - migrate to ArduinoJson v6, since it become apparent it is actually a good upgrade :) - actually make use of JSON endpoints more, right now it's just existing GET for sensors and relays - fork ESPAsyncWebServer to cleanup path parsing and temporary objects attached to the request (also, fix things a lot of things based on PRs there...)
4 years ago
6 years ago
8 years ago
8 years ago
Terminal: change command-line parser (#2247) Change the underlying command line handling: - switch to a custom parser, inspired by redis / sds - update terminalRegisterCommand signature, pass only bare minimum - clean-up `help` & `commands`. update settings `set`, `get` and `del` - allow our custom test suite to run command-line tests - clean-up Stream IO to allow us to print large things into debug stream (for example, `eeprom.dump`) - send parsing errors to the debug log As a proof of concept, introduce `TERMINAL_MQTT_SUPPORT` and `TERMINAL_WEB_API_SUPPORT` - MQTT subscribes to the `<root>/cmd/set` and sends response to the `<root>/cmd`. We can't output too much, as we don't have any large-send API. - Web API listens to the `/api/cmd?apikey=...&line=...` (or PUT, params inside the body). This one is intended as a possible replacement of the `API_SUPPORT`. Internals introduce a 'task' around the AsyncWebServerRequest object that will simulate what WiFiClient does and push data into it continuously, switching between CONT and SYS. Both are experimental. We only accept a single command and not every command is updated to use Print `ctx.output` object. We are also somewhat limited by the Print / Stream overall, perhaps I am overestimating the usefulness of Arduino compatibility to such an extent :) Web API handler can also sometimes show only part of the result, whenever the command tries to yield() by itself waiting for something. Perhaps we would need to create a custom request handler for that specific use-case.
4 years ago
6 years ago
6 years ago
6 years ago
6 years ago
8 years ago
6 years ago
  1. //------------------------------------------------------------------------------
  2. // Do not change this file unless you know what you are doing
  3. // To override user configuration, please see custom.h
  4. //------------------------------------------------------------------------------
  5. #pragma once
  6. //------------------------------------------------------------------------------
  7. // GENERAL
  8. //------------------------------------------------------------------------------
  9. #ifndef DEVICE_NAME
  10. #define DEVICE_NAME MANUFACTURER "_" DEVICE // Concatenate both to get a unique device name
  11. #endif
  12. // When defined, ADMIN_PASS must be 8..63 printable ASCII characters. See:
  13. // https://en.wikipedia.org/wiki/Wi-Fi_Protected_Access#Target_users_(authentication_key_distribution)
  14. // https://github.com/xoseperez/espurna/issues/1151
  15. #ifndef ADMIN_PASS
  16. #define ADMIN_PASS "fibonacci" // Default password (WEB, OTA, WIFI SoftAP)
  17. #endif
  18. #ifndef USE_PASSWORD
  19. #define USE_PASSWORD 1 // Insecurity caution! Disabling this will disable password querying completely.
  20. #endif
  21. #ifndef LOOP_DELAY_TIME
  22. #define LOOP_DELAY_TIME 10 // Delay for the main loop, in millis [0-250]
  23. // Recommended minimum is 10, see:
  24. // https://github.com/xoseperez/espurna/issues/1541
  25. // https://github.com/xoseperez/espurna/issues/1631
  26. // https://github.com/esp8266/Arduino/issues/5825
  27. #endif
  28. //------------------------------------------------------------------------------
  29. // DEBUG
  30. //------------------------------------------------------------------------------
  31. #ifndef DEBUG_LOG_MODE
  32. #define DEBUG_LOG_MODE DebugLogMode::Enabled // Set global logger mode. One of:
  33. // ::Enabled, ::Disabled or ::SkipBoot
  34. #endif
  35. // Serial debug log
  36. #ifndef DEBUG_SERIAL_SUPPORT
  37. #define DEBUG_SERIAL_SUPPORT 1 // Enable serial debug log
  38. #endif
  39. #ifndef DEBUG_PORT
  40. #define DEBUG_PORT Serial // Default debugging port
  41. #endif
  42. #ifndef SERIAL_BAUDRATE
  43. #define SERIAL_BAUDRATE 115200 // Default baudrate
  44. #endif
  45. #ifndef DEBUG_ADD_TIMESTAMP
  46. #define DEBUG_ADD_TIMESTAMP 1 // Add timestamp to debug messages
  47. // (in millis overflowing every 1000 seconds)
  48. #endif
  49. // Second serial port (used for RX)
  50. #ifndef SERIAL_RX_ENABLED
  51. #define SERIAL_RX_ENABLED 0 // Secondary serial port for RX
  52. #endif
  53. #ifndef SERIAL_RX_PORT
  54. #define SERIAL_RX_PORT Serial // This setting is usually defined
  55. // in the hardware.h file for those
  56. // boards that require it
  57. #endif
  58. #ifndef SERIAL_RX_BAUDRATE
  59. #define SERIAL_RX_BAUDRATE 115200 // Default baudrate
  60. #endif
  61. //------------------------------------------------------------------------------
  62. // UDP debug log
  63. // To receive the message on the destination computer use nc:
  64. // nc -ul 8113
  65. #ifndef DEBUG_UDP_SUPPORT
  66. #define DEBUG_UDP_SUPPORT 0 // Enable UDP debug log
  67. #endif
  68. #ifndef DEBUG_UDP_IP
  69. #define DEBUG_UDP_IP IPAddress(192, 168, 1, 100)
  70. #endif
  71. #ifndef DEBUG_UDP_PORT
  72. #define DEBUG_UDP_PORT 514
  73. #endif
  74. // If DEBUG_UDP_PORT is set to 514 syslog format is assumed
  75. // (https://tools.ietf.org/html/rfc3164)
  76. // DEBUG_UDP_FAC_PRI is the facility+priority
  77. #define DEBUG_UDP_FAC_PRI (SYSLOG_LOCAL0 | SYSLOG_DEBUG)
  78. //------------------------------------------------------------------------------
  79. #ifndef DEBUG_TELNET_SUPPORT
  80. #define DEBUG_TELNET_SUPPORT 1 // Enable telnet debug log (will only work if TELNET_SUPPORT is also 1)
  81. #endif
  82. //------------------------------------------------------------------------------
  83. #ifndef DEBUG_WEB_SUPPORT
  84. #define DEBUG_WEB_SUPPORT 1 // Enable web debug log (will only work if WEB_SUPPORT is also 1)
  85. #endif
  86. //------------------------------------------------------------------------------
  87. #ifndef DEBUG_LOG_BUFFER_SUPPORT
  88. #define DEBUG_LOG_BUFFER_SUPPORT 1 // Support boot log buffer (1.2Kb)
  89. // Will only work if DEBUG_LOG_BUFFER_ENABLED or runtime setting is also 1
  90. #endif
  91. #ifndef DEBUG_LOG_BUFFER_ENABLED
  92. #define DEBUG_LOG_BUFFER_ENABLED 0 // Disable boot log buffer by default
  93. #endif
  94. #ifndef DEBUG_LOG_BUFFER_SIZE
  95. #define DEBUG_LOG_BUFFER_SIZE 4096 // Store 4 Kb of log strings
  96. // WARNING! Memory is only reclaimed after `debug.buffer` prints the buffer contents
  97. #endif
  98. //------------------------------------------------------------------------------
  99. // TELNET
  100. //------------------------------------------------------------------------------
  101. #ifndef TELNET_SUPPORT
  102. #define TELNET_SUPPORT 1 // Enable telnet support by default (3.34Kb)
  103. #endif
  104. #ifndef TELNET_STA
  105. #define TELNET_STA 0 // By default, disallow connections via STA interface
  106. #endif
  107. #ifndef TELNET_AUTHENTICATION
  108. #define TELNET_AUTHENTICATION 1 // Request password to start telnet session by default
  109. #endif
  110. #ifndef TELNET_PORT
  111. #define TELNET_PORT 23 // Port to listen to telnet clients
  112. #endif
  113. #ifndef TELNET_MAX_CLIENTS
  114. #define TELNET_MAX_CLIENTS 1 // Max number of concurrent telnet clients
  115. #endif
  116. #ifndef TELNET_SERVER
  117. #define TELNET_SERVER TELNET_SERVER_ASYNC // Can be either TELNET_SERVER_ASYNC (using ESPAsyncTCP) or TELNET_SERVER_WIFISERVER (using WiFiServer)
  118. #endif
  119. #ifndef TELNET_SERVER_ASYNC_BUFFERED
  120. #define TELNET_SERVER_ASYNC_BUFFERED 0 // Enable buffered output for telnet server (+1Kb)
  121. // Helps to avoid lost data with lwip2 TCP_MSS=536 option
  122. #endif
  123. // Enable this flag to add support for reverse telnet (+800 bytes)
  124. // This is useful to telnet to a device behind a NAT or firewall
  125. // To use this feature, start a listen server on a publicly reachable host with e.g. "ncat -vlp <port>" and use the MQTT reverse telnet command to connect
  126. #ifndef TELNET_REVERSE_SUPPORT
  127. #define TELNET_REVERSE_SUPPORT 0
  128. #endif
  129. //------------------------------------------------------------------------------
  130. // TERMINAL
  131. //------------------------------------------------------------------------------
  132. #ifndef TERMINAL_SUPPORT
  133. #define TERMINAL_SUPPORT 1 // Enable terminal commands (0.97Kb)
  134. #endif
  135. #ifndef TERMINAL_SHARED_BUFFER_SIZE
  136. #define TERMINAL_SHARED_BUFFER_SIZE 128 // Maximum size for command line, shared by the WebUI, Telnet and Serial
  137. #endif
  138. #ifndef TERMINAL_MQTT_SUPPORT
  139. #define TERMINAL_MQTT_SUPPORT 0 // MQTT Terminal support built in
  140. // Depends on MQTT_SUPPORT and TERMINAL_SUPPORT commands being available
  141. #endif
  142. #ifndef TERMINAL_WEB_API_SUPPORT
  143. #define TERMINAL_WEB_API_SUPPORT 0 // Web server API Terminal support built in
  144. // Depends on WEB_SUPPORT and TERMINAL_SUPPORT commands being available
  145. #endif
  146. #ifndef TERMINAL_WEB_API_PATH
  147. #define TERMINAL_WEB_API_PATH "cmd"
  148. #endif
  149. //------------------------------------------------------------------------------
  150. // SYSTEM CHECK
  151. //------------------------------------------------------------------------------
  152. #ifndef SYSTEM_CHECK_ENABLED
  153. #define SYSTEM_CHECK_ENABLED 1 // Enable crash check by default
  154. #endif
  155. #ifndef SYSTEM_CHECK_TIME
  156. #define SYSTEM_CHECK_TIME 60000 // The system is considered stable after these many millis
  157. #endif
  158. #ifndef SYSTEM_CHECK_MAX
  159. #define SYSTEM_CHECK_MAX 5 // After this many crashes on boot
  160. // the system is flagged as unstable
  161. #endif
  162. //------------------------------------------------------------------------------
  163. // EEPROM
  164. //------------------------------------------------------------------------------
  165. //#define EEPROM_RORATE_SECTORS 2 // Number of sectors to use for EEPROM rotation
  166. // If not defined the firmware will use a number based
  167. // on the number of available sectors
  168. #ifndef SAVE_CRASH_ENABLED
  169. #define SAVE_CRASH_ENABLED 1 // Save stack trace to EEPROM by default
  170. // Depends on DEBUG_SUPPORT == 1
  171. #endif
  172. #ifndef SAVE_CRASH_STACK_TRACE_MAX
  173. #define SAVE_CRASH_STACK_TRACE_MAX 0x80 // limit at 128 bytes (increment/decrement by 16)
  174. #endif
  175. //------------------------------------------------------------------------------
  176. // GARLAND
  177. //------------------------------------------------------------------------------
  178. #ifndef GARLAND_SUPPORT
  179. #define GARLAND_SUPPORT 0
  180. #endif
  181. #ifndef GARLAND_D_PIN
  182. #define GARLAND_D_PIN D2 // WS2812 pin number
  183. #endif
  184. #ifndef GARLAND_LEDS
  185. #define GARLAND_LEDS 60 // Leds number
  186. #endif
  187. //------------------------------------------------------------------------------
  188. // THERMOSTAT
  189. //------------------------------------------------------------------------------
  190. #ifndef THERMOSTAT_SUPPORT
  191. #define THERMOSTAT_SUPPORT 0
  192. #endif
  193. #ifndef THERMOSTAT_DISPLAY_SUPPORT
  194. #define THERMOSTAT_DISPLAY_SUPPORT 0
  195. #endif
  196. #ifndef THERMOSTAT_DISPLAY_OFF_INTERVAL // Interval in seconds after which display will be switched off
  197. #define THERMOSTAT_DISPLAY_OFF_INTERVAL 0 // This will prevent it from burnout
  198. #endif // 0 - newer switch display off
  199. #define THERMOSTAT_SERVER_LOST_INTERVAL 120000 //server means lost after 2 min from last response
  200. #define THERMOSTAT_REMOTE_TEMP_MAX_WAIT 120 // 2 min
  201. #ifndef THERMOSTAT_REMOTE_SENSOR_NAME
  202. #define THERMOSTAT_REMOTE_SENSOR_NAME "" // Get remote temp(hum) from mqtt topic of this device
  203. #endif
  204. //------------------------------------------------------------------------------
  205. // HEARTBEAT
  206. //------------------------------------------------------------------------------
  207. #define HEARTBEAT_NONE 0 // Never send heartbeat
  208. #define HEARTBEAT_ONCE 1 // Send it only once upon MQTT connection
  209. #define HEARTBEAT_REPEAT 2 // Send it upon MQTT connection and every HEARTBEAT_INTERVAL
  210. #define HEARTBEAT_REPEAT_STATUS 3 // Send it upon MQTT connection and every HEARTBEAT_INTERVAL only STATUS report
  211. // Backwards compatibility check
  212. #if defined(HEARTBEAT_ENABLED) && (HEARTBEAT_ENABLED == 0)
  213. #define HEARTBEAT_MODE HEARTBEAT_NONE
  214. #endif
  215. #ifndef HEARTBEAT_MODE
  216. #define HEARTBEAT_MODE HEARTBEAT_REPEAT
  217. #endif
  218. #ifndef HEARTBEAT_INTERVAL
  219. #define HEARTBEAT_INTERVAL 300UL // Interval between heartbeat messages (in sec)
  220. #endif
  221. #define UPTIME_OVERFLOW 4294967295UL // Uptime overflow value
  222. // Values that will be reported in heartbeat
  223. #ifndef HEARTBEAT_REPORT_STATUS
  224. #define HEARTBEAT_REPORT_STATUS 1
  225. #endif
  226. #ifndef HEARTBEAT_REPORT_SSID
  227. #define HEARTBEAT_REPORT_SSID 1
  228. #endif
  229. #ifndef HEARTBEAT_REPORT_IP
  230. #define HEARTBEAT_REPORT_IP 1
  231. #endif
  232. #ifndef HEARTBEAT_REPORT_MAC
  233. #define HEARTBEAT_REPORT_MAC 1
  234. #endif
  235. #ifndef HEARTBEAT_REPORT_RSSI
  236. #define HEARTBEAT_REPORT_RSSI 1
  237. #endif
  238. #ifndef HEARTBEAT_REPORT_UPTIME
  239. #define HEARTBEAT_REPORT_UPTIME 1
  240. #endif
  241. #ifndef HEARTBEAT_REPORT_DATETIME
  242. #define HEARTBEAT_REPORT_DATETIME 1
  243. #endif
  244. #ifndef HEARTBEAT_REPORT_FREEHEAP
  245. #define HEARTBEAT_REPORT_FREEHEAP 1
  246. #endif
  247. #ifndef HEARTBEAT_REPORT_VCC
  248. #define HEARTBEAT_REPORT_VCC 1
  249. #endif
  250. #ifndef HEARTBEAT_REPORT_RELAY
  251. #define HEARTBEAT_REPORT_RELAY 1
  252. #endif
  253. #ifndef HEARTBEAT_REPORT_LIGHT
  254. #define HEARTBEAT_REPORT_LIGHT 1
  255. #endif
  256. #ifndef HEARTBEAT_REPORT_HOSTNAME
  257. #define HEARTBEAT_REPORT_HOSTNAME 1
  258. #endif
  259. #ifndef HEARTBEAT_REPORT_DESCRIPTION
  260. #define HEARTBEAT_REPORT_DESCRIPTION 1
  261. #endif
  262. #ifndef HEARTBEAT_REPORT_APP
  263. #define HEARTBEAT_REPORT_APP 1
  264. #endif
  265. #ifndef HEARTBEAT_REPORT_VERSION
  266. #define HEARTBEAT_REPORT_VERSION 1
  267. #endif
  268. #ifndef HEARTBEAT_REPORT_BOARD
  269. #define HEARTBEAT_REPORT_BOARD 1
  270. #endif
  271. #ifndef HEARTBEAT_REPORT_LOADAVG
  272. #define HEARTBEAT_REPORT_LOADAVG 1
  273. #endif
  274. #ifndef HEARTBEAT_REPORT_INTERVAL
  275. #define HEARTBEAT_REPORT_INTERVAL 0
  276. #endif
  277. #ifndef HEARTBEAT_REPORT_RANGE
  278. #define HEARTBEAT_REPORT_RANGE THERMOSTAT_SUPPORT
  279. #endif
  280. #ifndef HEARTBEAT_REPORT_REMOTE_TEMP
  281. #define HEARTBEAT_REPORT_REMOTE_TEMP THERMOSTAT_SUPPORT
  282. #endif
  283. #ifndef HEARTBEAT_REPORT_BSSID
  284. #define HEARTBEAT_REPORT_BSSID 0
  285. #endif
  286. //------------------------------------------------------------------------------
  287. // Load average
  288. //------------------------------------------------------------------------------
  289. #ifndef LOADAVG_INTERVAL
  290. #define LOADAVG_INTERVAL 30000 // Interval between calculating load average (in ms)
  291. #endif
  292. //------------------------------------------------------------------------------
  293. // BUTTON
  294. //------------------------------------------------------------------------------
  295. #ifndef BUTTON_SUPPORT
  296. #define BUTTON_SUPPORT 1
  297. #endif
  298. #ifndef BUTTON_DEBOUNCE_DELAY
  299. #define BUTTON_DEBOUNCE_DELAY 50 // Debounce delay (ms)
  300. #endif
  301. #ifndef BUTTON_REPEAT_DELAY
  302. #define BUTTON_REPEAT_DELAY 500 // Time in ms to wait for a second (or third...) click
  303. #endif
  304. #ifndef BUTTON_LNGCLICK_DELAY
  305. #define BUTTON_LNGCLICK_DELAY 1000 // Time in ms holding the button down to get a long click
  306. #endif
  307. #ifndef BUTTON_LNGLNGCLICK_DELAY
  308. #define BUTTON_LNGLNGCLICK_DELAY 10000 // Time in ms holding the button down to get a long-long click
  309. #endif
  310. #ifndef BUTTON_MQTT_SEND_ALL_EVENTS
  311. #define BUTTON_MQTT_SEND_ALL_EVENTS 0 // 0 - to send only events the are bound to actions
  312. // 1 - to send all button events to MQTT
  313. #endif
  314. #ifndef BUTTON_MQTT_RETAIN
  315. #define BUTTON_MQTT_RETAIN 0
  316. #endif
  317. // Generic digital pin support
  318. #ifndef BUTTON_PROVIDER_GENERIC_SUPPORT
  319. #define BUTTON_PROVIDER_GENERIC_SUPPORT 1
  320. #endif
  321. // Hardware specific, drive buttons through serial connection
  322. // (mutually exclusive)
  323. #ifndef BUTTON_PROVIDER_ITEAD_SONOFF_DUAL_SUPPORT
  324. #define BUTTON_PROVIDER_ITEAD_SONOFF_DUAL_SUPPORT 0
  325. #endif
  326. #ifndef BUTTON_PROVIDER_FOXEL_LIGHTFOX_DUAL
  327. #define BUTTON_PROVIDER_FOXEL_LIGHTFOX_DUAL 0
  328. #endif
  329. // Support MCP23S08 8-Bit I/O Expander via the SPI interface
  330. #ifndef BUTTON_PROVIDER_MCP23S08_SUPPORT
  331. #define BUTTON_PROVIDER_MCP23S08_SUPPORT MCP23S08_SUPPORT
  332. #endif
  333. // Resistor ladder support. Poll analog pin and return digital LOW when analog reading is in a certain range
  334. // ref. https://github.com/bxparks/AceButton/tree/develop/docs/resistor_ladder
  335. // Uses BUTTON#_ANALOG_LEVEL for the individual button level configuration
  336. #ifndef BUTTON_PROVIDER_ANALOG_SUPPORT
  337. #define BUTTON_PROVIDER_ANALOG_SUPPORT 0
  338. #endif
  339. //------------------------------------------------------------------------------
  340. // ENCODER
  341. //------------------------------------------------------------------------------
  342. #ifndef ENCODER_SUPPORT
  343. #define ENCODER_SUPPORT 0
  344. #endif
  345. #ifndef ENCODER_MINIMUM_DELTA
  346. #define ENCODER_MINIMUM_DELTA 1
  347. #endif
  348. //------------------------------------------------------------------------------
  349. // LED
  350. //------------------------------------------------------------------------------
  351. #ifndef LED_SUPPORT
  352. #define LED_SUPPORT 1
  353. #endif
  354. //------------------------------------------------------------------------------
  355. // RELAY
  356. //------------------------------------------------------------------------------
  357. #ifndef RELAY_SUPPORT
  358. #define RELAY_SUPPORT 1
  359. #endif
  360. // Default boot mode: 0 means OFF, 1 ON and 2 whatever was before
  361. #ifndef RELAY_BOOT_MODE
  362. #define RELAY_BOOT_MODE RELAY_BOOT_OFF
  363. #endif
  364. // 0 means ANY, 1 zero or one and 2 one and only one
  365. #ifndef RELAY_SYNC
  366. #define RELAY_SYNC RELAY_SYNC_ANY
  367. #endif
  368. // Default pulse mode: 0 means no pulses, 1 means normally off, 2 normally on
  369. #ifndef RELAY_PULSE_MODE
  370. #define RELAY_PULSE_MODE RELAY_PULSE_NONE
  371. #endif
  372. // Default pulse time in seconds
  373. #ifndef RELAY_PULSE_TIME
  374. #define RELAY_PULSE_TIME 1.0
  375. #endif
  376. // Relay requests flood protection window - in seconds
  377. #ifndef RELAY_FLOOD_WINDOW
  378. #define RELAY_FLOOD_WINDOW 3.0
  379. #endif
  380. // Allowed actual relay changes inside requests flood protection window
  381. #ifndef RELAY_FLOOD_CHANGES
  382. #define RELAY_FLOOD_CHANGES 5
  383. #endif
  384. // Pulse with in milliseconds for a latched relay
  385. #ifndef RELAY_LATCHING_PULSE
  386. #define RELAY_LATCHING_PULSE 10
  387. #endif
  388. // Do not save relay state after these many milliseconds
  389. #ifndef RELAY_SAVE_DELAY
  390. #define RELAY_SAVE_DELAY 1000
  391. #endif
  392. #ifndef RELAY_REPORT_STATUS
  393. #define RELAY_REPORT_STATUS 1
  394. #endif
  395. // Configure the MQTT payload for ON, OFF and TOGGLE
  396. #ifndef RELAY_MQTT_OFF
  397. #define RELAY_MQTT_OFF "0"
  398. #endif
  399. #ifndef RELAY_MQTT_ON
  400. #define RELAY_MQTT_ON "1"
  401. #endif
  402. #ifndef RELAY_MQTT_TOGGLE
  403. #define RELAY_MQTT_TOGGLE "2"
  404. #endif
  405. // -----------------------------------------------------------------------------
  406. // WIFI
  407. // -----------------------------------------------------------------------------
  408. #ifndef WIFI_CONNECT_TIMEOUT
  409. #define WIFI_CONNECT_TIMEOUT 60000 // Connecting timeout for WIFI in ms
  410. #endif
  411. #ifndef WIFI_RECONNECT_INTERVAL
  412. #define WIFI_RECONNECT_INTERVAL 180000 // If could not connect to WIFI, retry after this time in ms
  413. #endif
  414. #ifndef WIFI_MAX_NETWORKS
  415. #define WIFI_MAX_NETWORKS 5 // Max number of WIFI connection configurations
  416. #endif
  417. #ifndef WIFI_AP_CAPTIVE
  418. #define WIFI_AP_CAPTIVE 1 // Captive portal enabled when in AP mode
  419. #endif
  420. #ifndef WIFI_AP_MODE
  421. #define WIFI_AP_MODE WiFiApMode::Fallback // By default, fallback to AP mode if no STA connection
  422. // Use WiFiApMode::Enabled to start it when the device boots
  423. // Use WiFiApMode::Disabled to disable AP mode completely
  424. #endif
  425. #ifndef WIFI_AP_SSID
  426. #define WIFI_AP_SSID "" // (optional) Specify softAp SSID.
  427. // By default or when empty, hostname (or device identifier) is used instead.
  428. #endif
  429. #ifndef WIFI_AP_PASS
  430. #define WIFI_AP_PASS "" // (optional) Specify softAp passphrase
  431. // By default or when empty, admin password is used instead.
  432. #endif
  433. #ifndef WIFI_AP_LEASES_SUPPORT
  434. #define WIFI_AP_LEASES_SUPPORT 0 // (optional) Specify softAp MAC<->IP DHCP reservations
  435. // Use `set wifiApLease# MAC`, where MAC is a valid 12-byte HEX number without colons
  436. #endif
  437. #ifndef WIFI_SLEEP_MODE
  438. #define WIFI_SLEEP_MODE WIFI_NONE_SLEEP // WIFI_NONE_SLEEP, WIFI_LIGHT_SLEEP or WIFI_MODEM_SLEEP
  439. #endif
  440. #ifndef WIFI_SCAN_NETWORKS
  441. #define WIFI_SCAN_NETWORKS 1 // Perform a network scan before connecting
  442. #endif
  443. // Optional hardcoded configuration (up to 5 networks, depending on WIFI_MAX_NETWORKS and espurna/wifi_config.h)
  444. #ifndef WIFI1_SSID
  445. #define WIFI1_SSID ""
  446. #endif
  447. #ifndef WIFI1_PASS
  448. #define WIFI1_PASS ""
  449. #endif
  450. #ifndef WIFI1_IP
  451. #define WIFI1_IP ""
  452. #endif
  453. #ifndef WIFI1_GW
  454. #define WIFI1_GW ""
  455. #endif
  456. #ifndef WIFI1_MASK
  457. #define WIFI1_MASK ""
  458. #endif
  459. #ifndef WIFI1_DNS
  460. #define WIFI1_DNS ""
  461. #endif
  462. #ifndef WIFI2_SSID
  463. #define WIFI2_SSID ""
  464. #endif
  465. #ifndef WIFI2_PASS
  466. #define WIFI2_PASS ""
  467. #endif
  468. #ifndef WIFI2_IP
  469. #define WIFI2_IP ""
  470. #endif
  471. #ifndef WIFI2_GW
  472. #define WIFI2_GW ""
  473. #endif
  474. #ifndef WIFI2_MASK
  475. #define WIFI2_MASK ""
  476. #endif
  477. #ifndef WIFI2_DNS
  478. #define WIFI2_DNS ""
  479. #endif
  480. #ifndef WIFI3_SSID
  481. #define WIFI3_SSID ""
  482. #endif
  483. #ifndef WIFI3_PASS
  484. #define WIFI3_PASS ""
  485. #endif
  486. #ifndef WIFI3_IP
  487. #define WIFI3_IP ""
  488. #endif
  489. #ifndef WIFI3_GW
  490. #define WIFI3_GW ""
  491. #endif
  492. #ifndef WIFI3_MASK
  493. #define WIFI3_MASK ""
  494. #endif
  495. #ifndef WIFI3_DNS
  496. #define WIFI3_DNS ""
  497. #endif
  498. #ifndef WIFI4_SSID
  499. #define WIFI4_SSID ""
  500. #endif
  501. #ifndef WIFI4_PASS
  502. #define WIFI4_PASS ""
  503. #endif
  504. #ifndef WIFI4_IP
  505. #define WIFI4_IP ""
  506. #endif
  507. #ifndef WIFI4_GW
  508. #define WIFI4_GW ""
  509. #endif
  510. #ifndef WIFI4_MASK
  511. #define WIFI4_MASK ""
  512. #endif
  513. #ifndef WIFI4_DNS
  514. #define WIFI4_DNS ""
  515. #endif
  516. #ifndef WIFI5_SSID
  517. #define WIFI5_SSID ""
  518. #endif
  519. #ifndef WIFI5_PASS
  520. #define WIFI5_PASS ""
  521. #endif
  522. #ifndef WIFI5_IP
  523. #define WIFI5_IP ""
  524. #endif
  525. #ifndef WIFI5_GW
  526. #define WIFI5_GW ""
  527. #endif
  528. #ifndef WIFI5_MASK
  529. #define WIFI5_MASK ""
  530. #endif
  531. #ifndef WIFI5_DNS
  532. #define WIFI5_DNS ""
  533. #endif
  534. #ifndef WIFI_RSSI_1M
  535. #define WIFI_RSSI_1M -30 // Calibrate it with your router reading the RSSI at 1m
  536. #endif
  537. #ifndef WIFI_PROPAGATION_CONST
  538. #define WIFI_PROPAGATION_CONST 4 // This is typically something between 2.7 to 4.3 (free space is 2)
  539. #endif
  540. // ref: https://docs.espressif.com/projects/esp-idf/en/latest/api-reference/kconfig.html#config-lwip-esp-gratuitous-arp
  541. // ref: https://github.com/xoseperez/espurna/pull/1877#issuecomment-525612546
  542. //
  543. // Broadcast gratuitous ARP periodically to update ARP tables on the AP and all devices on the same network.
  544. // Helps to solve compatibility issues when ESP fails to timely reply to ARP requests, causing the device's ARP table entry to expire.
  545. #ifndef WIFI_GRATUITOUS_ARP_SUPPORT
  546. #define WIFI_GRATUITOUS_ARP_SUPPORT 1
  547. #endif
  548. // Interval is randomized on each boot in range from ..._MIN to ..._MAX (ms)
  549. #ifndef WIFI_GRATUITOUS_ARP_INTERVAL_MIN
  550. #define WIFI_GRATUITOUS_ARP_INTERVAL_MIN 15000
  551. #endif
  552. #ifndef WIFI_GRATUITOUS_ARP_INTERVAL_MAX
  553. #define WIFI_GRATUITOUS_ARP_INTERVAL_MAX 30000
  554. #endif
  555. // ref: https://github.com/esp8266/Arduino/issues/6471
  556. // ref: https://github.com/esp8266/Arduino/issues/6366
  557. //
  558. // Issue #6366 turned out to be high tx power causing weird behavior. Lowering tx power achieved stability.
  559. #ifndef WIFI_OUTPUT_POWER_DBM
  560. #define WIFI_OUTPUT_POWER_DBM 20.0f
  561. #endif
  562. // -----------------------------------------------------------------------------
  563. // WEB
  564. // -----------------------------------------------------------------------------
  565. #ifndef WEB_SUPPORT
  566. #define WEB_SUPPORT 1 // Enable web support (http, api, 121.65Kb)
  567. #endif
  568. #ifndef WEB_EMBEDDED
  569. #define WEB_EMBEDDED 1 // Build the firmware with the web interface embedded in
  570. #endif
  571. #ifndef WEB_ACCESS_LOG
  572. #define WEB_ACCESS_LOG 0 // Log every request that was received by the server (but, not necessarily processed)
  573. #endif
  574. // Requires ESPAsyncTCP to be built with ASYNC_TCP_SSL_ENABLED=1 and Arduino Core version >= 2.4.0
  575. // XXX: This is not working at the moment!! Pending https://github.com/me-no-dev/ESPAsyncTCP/issues/95
  576. #ifndef WEB_SSL_ENABLED
  577. #define WEB_SSL_ENABLED 0 // Use HTTPS web interface
  578. #endif
  579. #ifndef WEB_USERNAME
  580. #define WEB_USERNAME "admin" // HTTP username
  581. #endif
  582. #ifndef WEB_FORCE_PASS_CHANGE
  583. #define WEB_FORCE_PASS_CHANGE 1 // Force the user to change the password if default one
  584. #endif
  585. #ifndef WEB_PORT
  586. #define WEB_PORT 80 // HTTP port
  587. #endif
  588. // Defining a WEB_REMOTE_DOMAIN will enable Cross-Origin Resource Sharing (CORS)
  589. // so you will be able to login to this device from another domain. This will allow
  590. // you to manage all ESPurna devices in your local network from a unique installation
  591. // of the web UI. This installation could be in a local server (a Raspberry Pi, for instance)
  592. // or in the Internet. Since the WebUI is just one compressed file with HTML, CSS and JS
  593. // there are no special requirements. Any static web server will do (NGinx, Apache, Lighttpd,...).
  594. // The only requirement is that the resource must be available under this domain.
  595. #ifndef WEB_REMOTE_DOMAIN
  596. #define WEB_REMOTE_DOMAIN "http://espurna.io"
  597. #endif
  598. // -----------------------------------------------------------------------------
  599. // WEBSOCKETS
  600. // -----------------------------------------------------------------------------
  601. // This will only be enabled if WEB_SUPPORT is 1 (this is the default value)
  602. #ifndef WS_AUTHENTICATION
  603. #define WS_AUTHENTICATION 1 // WS authentication ON by default (see #507)
  604. #endif
  605. #ifndef WS_BUFFER_SIZE
  606. #define WS_BUFFER_SIZE 5 // Max number of secured websocket connections
  607. #endif
  608. #ifndef WS_TIMEOUT
  609. #define WS_TIMEOUT 1800000 // Timeout for secured websocket
  610. #endif
  611. #ifndef WS_UPDATE_INTERVAL
  612. #define WS_UPDATE_INTERVAL 30000 // Update clients every 30 seconds
  613. #endif
  614. // -----------------------------------------------------------------------------
  615. // API
  616. // -----------------------------------------------------------------------------
  617. #ifndef API_SUPPORT
  618. #define API_SUPPORT 1 // API (REST & RPC) support built in
  619. #endif
  620. // This will only be enabled if WEB_SUPPORT is 1 (this is the default value)
  621. #ifndef API_ENABLED
  622. #define API_ENABLED 0 // Do not enable API by default
  623. #endif
  624. #ifndef API_KEY
  625. #define API_KEY "" // Do not enable API by default. WebUI will automatically generate the key
  626. #endif
  627. #ifndef API_RESTFUL
  628. #define API_RESTFUL 1 // A restful API requires changes to be issued as PUT requests
  629. // Setting this to 0 will allow using GET to change relays, for instance
  630. #endif
  631. #ifndef API_JSON_BUFFER_SIZE
  632. #define API_JSON_BUFFER_SIZE 256 // Size of the (de)serializer buffer.
  633. #endif
  634. #ifndef API_BASE_PATH
  635. #define API_BASE_PATH "/api/"
  636. #endif
  637. #ifndef API_REAL_TIME_VALUES
  638. #define API_REAL_TIME_VALUES 0 // Show filtered/median values by default (0 => median, 1 => real time)
  639. #endif
  640. // -----------------------------------------------------------------------------
  641. // MDNS / LLMNR / NETBIOS / SSDP
  642. // -----------------------------------------------------------------------------
  643. #ifndef MDNS_SERVER_SUPPORT
  644. #define MDNS_SERVER_SUPPORT 1 // Publish services using mDNS by default (1.48Kb)
  645. #endif
  646. #ifndef MDNS_CLIENT_SUPPORT
  647. #define MDNS_CLIENT_SUPPORT 0 // Resolve mDNS names (3.44Kb)
  648. #endif
  649. #ifndef LLMNR_SUPPORT
  650. #define LLMNR_SUPPORT 0 // Publish device using LLMNR protocol by default (1.95Kb) - requires Core version >= 2.4.0
  651. #endif
  652. #ifndef NETBIOS_SUPPORT
  653. #define NETBIOS_SUPPORT 0 // Publish device using NetBIOS protocol by default (1.26Kb) - requires Core version >= 2.4.0
  654. #endif
  655. #ifndef SSDP_SUPPORT
  656. #define SSDP_SUPPORT 0 // Publish device using SSDP protocol by default (4.59Kb)
  657. // Not compatible with ALEXA_SUPPORT at the moment
  658. #endif
  659. #ifndef SSDP_DEVICE_TYPE
  660. #define SSDP_DEVICE_TYPE "upnp:rootdevice"
  661. //#define SSDP_DEVICE_TYPE "urn:schemas-upnp-org:device:BinaryLight:1"
  662. #endif
  663. // -----------------------------------------------------------------------------
  664. // SPIFFS
  665. // -----------------------------------------------------------------------------
  666. #ifndef SPIFFS_SUPPORT
  667. #define SPIFFS_SUPPORT 0 // Do not add support for SPIFFS by default
  668. #endif
  669. // -----------------------------------------------------------------------------
  670. // SSL Client ** EXPERIMENTAL **
  671. // -----------------------------------------------------------------------------
  672. #ifndef SECURE_CLIENT
  673. #define SECURE_CLIENT SECURE_CLIENT_NONE // What variant of WiFiClient to use
  674. // SECURE_CLIENT_NONE - No secure client support (default)
  675. // SECURE_CLIENT_AXTLS - axTLS client secure support (All Core versions, ONLY TLS 1.1)
  676. // SECURE_CLIENT_BEARSSL - BearSSL client secure support (starting with 2.5.0, TLS 1.2)
  677. //
  678. // axTLS marked for derecation since Arduino Core 2.4.2 and **will** be removed in the future
  679. #endif
  680. // Security check that is performed when the connection is established:
  681. // SECURE_CLIENT_CHECK_CA - Use Trust Anchor / Root Certificate
  682. // Supported only by the SECURE_CLIENT_BEARSSL
  683. // (See respective ..._SECURE_CLIENT_INCLUDE_CA options per-module)
  684. // SECURE_CLIENT_CHECK_FINGERPRINT - Check certificate fingerprint
  685. // SECURE_CLIENT_CHECK_NONE - Allow insecure connections
  686. #ifndef SECURE_CLIENT_CHECK
  687. #if SECURE_CLIENT == SECURE_CLIENT_BEARSSL
  688. #define SECURE_CLIENT_CHECK SECURE_CLIENT_CHECK_CA
  689. #else
  690. #define SECURE_CLIENT_CHECK SECURE_CLIENT_CHECK_FINGERPRINT
  691. #endif
  692. #endif // SECURE_CLIENT_CHECK
  693. // Support Maximum Fragment Length Negotiation TLS extension
  694. // "...negotiate a smaller maximum fragment length due to memory limitations or bandwidth limitations."
  695. // - https://arduino-esp8266.readthedocs.io/en/latest/esp8266wifi/bearssl-client-secure-class.html#mfln-or-maximum-fragment-length-negotiation-saving-ram
  696. // - https://tools.ietf.org/html/rfc6066#section-4
  697. #ifndef SECURE_CLIENT_MFLN
  698. #define SECURE_CLIENT_MFLN 0 // The only possible values are: 512, 1024, 2048 and 4096
  699. // Set to 0 to disable (default)
  700. #endif
  701. // -----------------------------------------------------------------------------
  702. // OTA
  703. // -----------------------------------------------------------------------------
  704. #ifndef OTA_PORT
  705. #define OTA_PORT 8266 // Port for ArduinoOTA
  706. #endif
  707. #ifndef OTA_MQTT_SUPPORT
  708. #define OTA_MQTT_SUPPORT 0 // Listen for HTTP(s) URLs at '<root topic>/ota'. Depends on OTA_CLIENT
  709. #endif
  710. #ifndef OTA_ARDUINOOTA_SUPPORT
  711. #define OTA_ARDUINOOTA_SUPPORT 1 // Support ArduinoOTA by default (4.2Kb)
  712. // Implicitly depends on ESP8266mDNS library, thus increasing firmware size
  713. #endif
  714. #ifndef OTA_CLIENT
  715. #define OTA_CLIENT OTA_CLIENT_ASYNCTCP // Terminal / MQTT OTA support
  716. // OTA_CLIENT_ASYNCTCP (ESPAsyncTCP library)
  717. // OTA_CLIENT_HTTPUPDATE (Arduino Core library)j
  718. // OTA_CLIENT_NONE to disable
  719. #endif
  720. #ifndef OTA_WEB_SUPPORT
  721. #define OTA_WEB_SUPPORT 1 // Support `/upgrade` endpoint and WebUI OTA handler
  722. #endif
  723. #define OTA_GITHUB_FP "CA:06:F5:6B:25:8B:7A:0D:4F:2B:05:47:09:39:47:86:51:15:19:84"
  724. #ifndef OTA_FINGERPRINT
  725. #define OTA_FINGERPRINT OTA_GITHUB_FP
  726. #endif
  727. #ifndef OTA_SECURE_CLIENT_CHECK
  728. #define OTA_SECURE_CLIENT_CHECK SECURE_CLIENT_CHECK
  729. #endif
  730. #ifndef OTA_SECURE_CLIENT_MFLN
  731. #define OTA_SECURE_CLIENT_MFLN SECURE_CLIENT_MFLN
  732. #endif
  733. #ifndef OTA_SECURE_CLIENT_INCLUDE_CA
  734. #define OTA_SECURE_CLIENT_INCLUDE_CA 0 // Use user-provided CA. Only PROGMEM PEM option is supported.
  735. // TODO: eventually should be replaced with pre-parsed structs, read directly from flash
  736. // (ref: https://github.com/earlephilhower/bearssl-esp8266/pull/14)
  737. //
  738. // When enabled, current implementation includes "static/ota_client_trusted_root_ca.h" with
  739. // const char _ota_client_trusted_root_ca[] PROGMEM = "...PEM data...";
  740. // By default, using DigiCert root in "static/digicert_evroot_pem.h" (for https://github.com)
  741. #endif
  742. // -----------------------------------------------------------------------------
  743. // NOFUSS
  744. // -----------------------------------------------------------------------------
  745. #ifndef NOFUSS_SUPPORT
  746. #define NOFUSS_SUPPORT 0 // Do not enable support for NoFuss by default (12.65Kb)
  747. #endif
  748. #ifndef NOFUSS_ENABLED
  749. #define NOFUSS_ENABLED 0 // Do not perform NoFUSS updates by default
  750. #endif
  751. #ifndef NOFUSS_SERVER
  752. #define NOFUSS_SERVER "" // Default NoFuss Server
  753. #endif
  754. #ifndef NOFUSS_INTERVAL
  755. #define NOFUSS_INTERVAL 3600000 // Check for updates every hour
  756. #endif
  757. // -----------------------------------------------------------------------------
  758. // UART <-> MQTT
  759. // -----------------------------------------------------------------------------
  760. #ifndef UART_MQTT_SUPPORT
  761. #define UART_MQTT_SUPPORT 0 // No support by default
  762. #endif
  763. #ifndef UART_MQTT_USE_SOFT
  764. #define UART_MQTT_USE_SOFT 0 // Use SoftwareSerial
  765. #endif
  766. #ifndef UART_MQTT_HW_PORT
  767. #define UART_MQTT_HW_PORT Serial // Hardware serial port (if UART_MQTT_USE_SOFT == 0)
  768. #endif
  769. #ifndef UART_MQTT_RX_PIN
  770. #define UART_MQTT_RX_PIN 4 // RX PIN (if UART_MQTT_USE_SOFT == 1)
  771. #endif
  772. #ifndef UART_MQTT_TX_PIN
  773. #define UART_MQTT_TX_PIN 5 // TX PIN (if UART_MQTT_USE_SOFT == 1)
  774. #endif
  775. #ifndef UART_MQTT_BAUDRATE
  776. #define UART_MQTT_BAUDRATE 115200 // Serial speed
  777. #endif
  778. #ifndef UART_MQTT_TERMINATION
  779. #define UART_MQTT_TERMINATION '\n' // Termination character
  780. #endif
  781. #define UART_MQTT_BUFFER_SIZE 100 // UART buffer size
  782. // -----------------------------------------------------------------------------
  783. // MQTT
  784. // -----------------------------------------------------------------------------
  785. #ifndef MQTT_SUPPORT
  786. #define MQTT_SUPPORT 1 // MQTT support (22.38Kb async, 12.48Kb sync)
  787. #endif
  788. #ifndef MQTT_LIBRARY
  789. #define MQTT_LIBRARY MQTT_LIBRARY_ASYNCMQTTCLIENT // MQTT_LIBRARY_ASYNCMQTTCLIENT (default, https://github.com/marvinroger/async-mqtt-client)
  790. // MQTT_LIBRARY_PUBSUBCLIENT (https://github.com/knolleary/pubsubclient)
  791. // MQTT_LIBRARY_ARDUINOMQTT (https://github.com/256dpi/arduino-mqtt)
  792. #endif
  793. // -----------------------------------------------------------------------------
  794. // MQTT OVER SSL
  795. // -----------------------------------------------------------------------------
  796. //
  797. // Requires SECURE_CLIENT set to SECURE_CLIENT_AXTLS or SECURE_CLIENT_BEARSSL
  798. // It is recommended to use MQTT_LIBRARY_ARDUINOMQTT or MQTT_LIBRARY_PUBSUBCLIENT
  799. // It is recommended to use SECURE_CLIENT_BEARSSL
  800. // It is recommended to use ESP8266 Arduino Core >= 2.5.2 with SECURE_CLIENT_BEARSSL
  801. //
  802. // Current version of MQTT_LIBRARY_ASYNCMQTTCLIENT only supports SECURE_CLIENT_AXTLS
  803. //
  804. // It is recommended to use WEB_SUPPORT=0 with either SECURE_CLIENT option, as there are miscellaneous problems when using them simultaneously
  805. // (although, things might've improved, and I'd encourage to check whether this is true or not)
  806. //
  807. // When using MQTT_LIBRARY_PUBSUBCLIENT or MQTT_LIBRARY_ARDUINOMQTT, you will have to disable every module that uses ESPAsyncTCP:
  808. // ALEXA_SUPPORT=0, INFLUXDB_SUPPORT=0, TELNET_SUPPORT=0, THINGSPEAK_SUPPORT=0, DEBUG_TELNET_SUPPORT=0 and WEB_SUPPORT=0
  809. // Or, use "sync" versions instead (note that not every module has this option):
  810. // THINGSPEAK_USE_ASYNC=0, TELNET_SERVER=TELNET_SERVER_WIFISERVER
  811. //
  812. // See SECURE_CLIENT_CHECK for all possible connection verification options.
  813. //
  814. // The simpliest way to verify SSL connection is to use fingerprinting.
  815. // For example, to get Google's MQTT server certificate fingerprint, run the following command:
  816. // $ echo -n | openssl s_client -connect mqtt.googleapis.com:8883 2>&1 | openssl x509 -noout -fingerprint -sha1 | cut -d\= -f2
  817. // Note that fingerprint will change when certificate changes e.g. LetsEncrypt renewals or when the CSR updates
  818. #ifndef MQTT_SSL_ENABLED
  819. #define MQTT_SSL_ENABLED 0 // By default MQTT over SSL will not be enabled
  820. #endif
  821. #ifndef MQTT_SSL_FINGERPRINT
  822. #define MQTT_SSL_FINGERPRINT "" // SSL fingerprint of the server
  823. #endif
  824. #ifndef MQTT_SECURE_CLIENT_CHECK
  825. #define MQTT_SECURE_CLIENT_CHECK SECURE_CLIENT_CHECK // Use global verification setting by default
  826. #endif
  827. #ifndef MQTT_SECURE_CLIENT_MFLN
  828. #define MQTT_SECURE_CLIENT_MFLN SECURE_CLIENT_MFLN // Use global MFLN setting by default
  829. #endif
  830. #ifndef MQTT_SECURE_CLIENT_INCLUDE_CA
  831. #define MQTT_SECURE_CLIENT_INCLUDE_CA 0 // Use user-provided CA. Only PROGMEM PEM option is supported.
  832. // When enabled, current implementation includes "static/mqtt_client_trusted_root_ca.h" with
  833. // const char _mqtt_client_trusted_root_ca[] PROGMEM = "...PEM data...";
  834. // By default, using LetsEncrypt X3 root in "static/letsencrypt_isrgroot_pem.h"
  835. #endif
  836. #ifndef MQTT_ENABLED
  837. #define MQTT_ENABLED 0 // Do not enable MQTT connection by default
  838. #endif
  839. #ifndef MQTT_AUTOCONNECT
  840. #define MQTT_AUTOCONNECT 1 // If enabled and MDNS_SERVER_SUPPORT=1 will perform an autodiscover and
  841. // autoconnect to the first MQTT broker found if none defined
  842. #endif
  843. #ifndef MQTT_SERVER
  844. #define MQTT_SERVER "" // Default MQTT broker address
  845. #endif
  846. #ifndef MQTT_USER
  847. #define MQTT_USER "" // Default MQTT broker usename
  848. #endif
  849. #ifndef MQTT_PASS
  850. #define MQTT_PASS "" // Default MQTT broker password
  851. #endif
  852. #ifndef MQTT_PORT
  853. #define MQTT_PORT 1883 // MQTT broker port
  854. #endif
  855. #ifndef MQTT_TOPIC
  856. #define MQTT_TOPIC "{hostname}" // Default MQTT base topic
  857. #endif
  858. #ifndef MQTT_RETAIN
  859. #define MQTT_RETAIN true // MQTT retain flag
  860. #endif
  861. #ifndef MQTT_QOS
  862. #define MQTT_QOS 0 // MQTT QoS value for all messages
  863. #endif
  864. #ifndef MQTT_KEEPALIVE
  865. #define MQTT_KEEPALIVE 120 // MQTT keepalive value
  866. #endif
  867. #ifndef MQTT_RECONNECT_DELAY_MIN
  868. #define MQTT_RECONNECT_DELAY_MIN 5000 // Try to reconnect in 5 seconds upon disconnection
  869. #endif
  870. #ifndef MQTT_RECONNECT_DELAY_STEP
  871. #define MQTT_RECONNECT_DELAY_STEP 5000 // Increase the reconnect delay in 5 seconds after each failed attempt
  872. #endif
  873. #ifndef MQTT_RECONNECT_DELAY_MAX
  874. #define MQTT_RECONNECT_DELAY_MAX 120000 // Set reconnect time to 2 minutes at most
  875. #endif
  876. #ifndef MQTT_SKIP_TIME
  877. #define MQTT_SKIP_TIME 0 // Skip messages for N ms after connection. Disabled by default
  878. #endif
  879. #ifndef MQTT_USE_JSON
  880. #define MQTT_USE_JSON 0 // Don't group messages in a JSON body by default
  881. #endif
  882. #ifndef MQTT_USE_JSON_DELAY
  883. #define MQTT_USE_JSON_DELAY 100 // Wait this many ms before grouping messages
  884. #endif
  885. #ifndef MQTT_QUEUE_MAX_SIZE
  886. #define MQTT_QUEUE_MAX_SIZE 20 // Size of the MQTT queue when MQTT_USE_JSON is enabled
  887. #endif
  888. #ifndef MQTT_BUFFER_MAX_SIZE
  889. #define MQTT_BUFFER_MAX_SIZE 1024 // Size of the MQTT payload buffer for MQTT_MESSAGE_EVENT. Large messages will only be available via MQTT_MESSAGE_RAW_EVENT.
  890. // Note: When using MQTT_LIBRARY_PUBSUBCLIENT, MQTT_MAX_PACKET_SIZE should not be more than this value.
  891. #endif
  892. // These are the properties that will be sent when useJson is true
  893. #ifndef MQTT_ENQUEUE_IP
  894. #define MQTT_ENQUEUE_IP 1
  895. #endif
  896. #ifndef MQTT_ENQUEUE_MAC
  897. #define MQTT_ENQUEUE_MAC 1
  898. #endif
  899. #ifndef MQTT_ENQUEUE_HOSTNAME
  900. #define MQTT_ENQUEUE_HOSTNAME 1
  901. #endif
  902. #ifndef MQTT_ENQUEUE_DATETIME
  903. #define MQTT_ENQUEUE_DATETIME 1
  904. #endif
  905. #ifndef MQTT_ENQUEUE_MESSAGE_ID
  906. #define MQTT_ENQUEUE_MESSAGE_ID 1
  907. #endif
  908. // These particles will be concatenated to the MQTT_TOPIC base to form the actual topic
  909. #define MQTT_TOPIC_JSON "data"
  910. #define MQTT_TOPIC_ACTION "action"
  911. #define MQTT_TOPIC_RELAY "relay"
  912. #define MQTT_TOPIC_LED "led"
  913. #define MQTT_TOPIC_BUTTON "button"
  914. #define MQTT_TOPIC_IP "ip"
  915. #define MQTT_TOPIC_SSID "ssid"
  916. #define MQTT_TOPIC_BSSID "bssid"
  917. #define MQTT_TOPIC_VERSION "version"
  918. #define MQTT_TOPIC_UPTIME "uptime"
  919. #define MQTT_TOPIC_DATETIME "datetime"
  920. #define MQTT_TOPIC_TIMESTAMP "timestamp"
  921. #define MQTT_TOPIC_FREEHEAP "freeheap"
  922. #define MQTT_TOPIC_VCC "vcc"
  923. #ifndef MQTT_TOPIC_STATUS
  924. #define MQTT_TOPIC_STATUS "status"
  925. #endif
  926. #define MQTT_TOPIC_MAC "mac"
  927. #define MQTT_TOPIC_RSSI "rssi"
  928. #define MQTT_TOPIC_MESSAGE_ID "id"
  929. #define MQTT_TOPIC_APP "app"
  930. #define MQTT_TOPIC_INTERVAL "interval"
  931. #define MQTT_TOPIC_HOSTNAME "host"
  932. #define MQTT_TOPIC_DESCRIPTION "desc"
  933. #define MQTT_TOPIC_TIME "time"
  934. #define MQTT_TOPIC_RFOUT "rfout"
  935. #define MQTT_TOPIC_RFIN "rfin"
  936. #define MQTT_TOPIC_RFLEARN "rflearn"
  937. #define MQTT_TOPIC_RFRAW "rfraw"
  938. #define MQTT_TOPIC_UARTIN "uartin"
  939. #define MQTT_TOPIC_UARTOUT "uartout"
  940. #define MQTT_TOPIC_LOADAVG "loadavg"
  941. #define MQTT_TOPIC_BOARD "board"
  942. #define MQTT_TOPIC_PULSE "pulse"
  943. #define MQTT_TOPIC_SPEED "speed"
  944. #define MQTT_TOPIC_IRIN "irin"
  945. #define MQTT_TOPIC_IROUT "irout"
  946. #define MQTT_TOPIC_OTA "ota"
  947. #define MQTT_TOPIC_TELNET_REVERSE "telnet_reverse"
  948. #define MQTT_TOPIC_CURTAIN "curtain"
  949. #define MQTT_TOPIC_CMD "cmd"
  950. // Light module
  951. #define MQTT_TOPIC_CHANNEL "channel"
  952. #define MQTT_TOPIC_COLOR_RGB "rgb"
  953. #define MQTT_TOPIC_COLOR_HSV "hsv"
  954. #define MQTT_TOPIC_ANIM_MODE "anim_mode"
  955. #define MQTT_TOPIC_ANIM_SPEED "anim_speed"
  956. #define MQTT_TOPIC_BRIGHTNESS "brightness"
  957. #define MQTT_TOPIC_MIRED "mired"
  958. #define MQTT_TOPIC_KELVIN "kelvin"
  959. #define MQTT_TOPIC_TRANSITION "transition"
  960. // Thermostat module
  961. #define MQTT_TOPIC_HOLD_TEMP "hold_temp"
  962. #define MQTT_TOPIC_HOLD_TEMP_MIN "min"
  963. #define MQTT_TOPIC_HOLD_TEMP_MAX "max"
  964. #define MQTT_TOPIC_REMOTE_TEMP "remote_temp"
  965. #define MQTT_TOPIC_ASK_TEMP_RANGE "ask_temp_range"
  966. #define MQTT_TOPIC_NOTIFY_TEMP_RANGE_MIN "notify_temp_range_min"
  967. #define MQTT_TOPIC_NOTIFY_TEMP_RANGE_MAX "notify_temp_range_max"
  968. #ifndef MQTT_STATUS_ONLINE
  969. #define MQTT_STATUS_ONLINE "1" // Value for the device ON message
  970. #endif
  971. #ifndef MQTT_STATUS_OFFLINE
  972. #define MQTT_STATUS_OFFLINE "0" // Value for the device OFF message (will)
  973. #endif
  974. #define MQTT_ACTION_RESET "reboot" // RESET MQTT topic particle
  975. // Custom get and set postfixes
  976. // Use something like "/status" or "/set", with leading slash
  977. // Since 1.9.0 the default value is "" for getter and "/set" for setter
  978. #ifndef MQTT_GETTER
  979. #define MQTT_GETTER ""
  980. #endif
  981. #ifndef MQTT_SETTER
  982. #define MQTT_SETTER "/set"
  983. #endif
  984. // -----------------------------------------------------------------------------
  985. // BROKER
  986. // -----------------------------------------------------------------------------
  987. #ifndef BROKER_SUPPORT
  988. #define BROKER_SUPPORT 1 // The broker is a poor-man's pubsub manager
  989. #endif
  990. // -----------------------------------------------------------------------------
  991. // SETTINGS
  992. // -----------------------------------------------------------------------------
  993. #ifndef SETTINGS_AUTOSAVE
  994. #define SETTINGS_AUTOSAVE 1 // Autosave settings or force manual commit
  995. #endif
  996. #define SETTINGS_MAX_LIST_COUNT 16 // Maximum index for settings lists
  997. // -----------------------------------------------------------------------------
  998. // LIGHT
  999. // -----------------------------------------------------------------------------
  1000. // LIGHT_PROVIDER_DIMMER can have from 1 to 5 different channels.
  1001. // They have to be defined for each device in the hardware.h file.
  1002. // If 3 or more channels first 3 will be considered RGB.
  1003. // Usual configurations are:
  1004. // 1 channels => W
  1005. // 2 channels => WW
  1006. // 3 channels => RGB
  1007. // 4 channels => RGBW
  1008. // 5 channels => RGBWW
  1009. #ifndef LIGHT_SAVE_ENABLED
  1010. #define LIGHT_SAVE_ENABLED 1 // Light channel values saved by default after each change
  1011. #endif
  1012. #ifndef LIGHT_COMMS_DELAY
  1013. #define LIGHT_COMMS_DELAY 100 // Delay communication after light update (in ms)
  1014. #endif
  1015. #ifndef LIGHT_SAVE_DELAY
  1016. #define LIGHT_SAVE_DELAY 5 // Persist color after 5 seconds to avoid wearing out
  1017. #endif
  1018. #ifndef LIGHT_MIN_PWM
  1019. #define LIGHT_MIN_PWM 0
  1020. #endif
  1021. #ifndef LIGHT_MAX_PWM
  1022. #if LIGHT_PROVIDER == LIGHT_PROVIDER_MY92XX
  1023. #define LIGHT_MAX_PWM 255
  1024. #elif LIGHT_PROVIDER == LIGHT_PROVIDER_DIMMER
  1025. #define LIGHT_MAX_PWM 10000 // 10000 * 200ns => 2 kHz
  1026. #else
  1027. #define LIGHT_MAX_PWM 0
  1028. #endif
  1029. #endif // LIGHT_MAX_PWM
  1030. #ifndef LIGHT_LIMIT_PWM
  1031. #define LIGHT_LIMIT_PWM LIGHT_MAX_PWM // Limit PWM to this value (prevent 100% power)
  1032. #endif
  1033. #ifndef LIGHT_MIN_VALUE
  1034. #define LIGHT_MIN_VALUE 0 // Minimum light value
  1035. #endif
  1036. #ifndef LIGHT_MAX_VALUE
  1037. #define LIGHT_MAX_VALUE 255 // Maximum light value
  1038. #endif
  1039. #ifndef LIGHT_MIN_BRIGHTNESS
  1040. #define LIGHT_MIN_BRIGHTNESS 0 // Minimum brightness value
  1041. #endif
  1042. #ifndef LIGHT_MAX_BRIGHTNESS
  1043. #define LIGHT_MAX_BRIGHTNESS 255 // Maximum brightness value
  1044. #endif
  1045. // Default mireds & kelvin to the Philips Hue limits
  1046. // https://developers.meethue.com/documentation/core-concepts
  1047. //
  1048. // Home Assistant also uses these, see Light::min_mireds, Light::max_mireds
  1049. // https://github.com/home-assistant/home-assistant/blob/dev/homeassistant/components/light/__init__.py
  1050. // Used when LIGHT_USE_WHITE AND LIGHT_USE_CCT is 1 - (1000000/Kelvin = MiReds)
  1051. // Warning! Don't change this yet, NOT FULLY IMPLEMENTED!
  1052. #ifndef LIGHT_COLDWHITE_MIRED
  1053. #define LIGHT_COLDWHITE_MIRED 153 // Coldwhite Strip, Value must be __BELOW__ W2!! (Default: 6535 Kelvin/153 MiRed)
  1054. #endif
  1055. #ifndef LIGHT_WARMWHITE_MIRED
  1056. #define LIGHT_WARMWHITE_MIRED 500 // Warmwhite Strip, Value must be __ABOVE__ W1!! (Default: 2000 Kelvin/500 MiRed)
  1057. #endif
  1058. #ifndef LIGHT_STEP
  1059. #define LIGHT_STEP 32 // Step size
  1060. #endif
  1061. #ifndef LIGHT_USE_COLOR
  1062. #define LIGHT_USE_COLOR 1 // Use 3 first channels as RGB
  1063. #endif
  1064. #ifndef LIGHT_USE_WHITE
  1065. #define LIGHT_USE_WHITE 0 // Use the 4th channel as (Warm-)White LEDs
  1066. #endif
  1067. #ifndef LIGHT_USE_CCT
  1068. #define LIGHT_USE_CCT 0 // Use the 5th channel as Coldwhite LEDs, LIGHT_USE_WHITE must be 1.
  1069. #endif
  1070. #ifndef LIGHT_USE_GAMMA
  1071. #define LIGHT_USE_GAMMA 0 // Use gamma correction for color channels
  1072. #endif
  1073. #ifndef LIGHT_USE_CSS
  1074. #define LIGHT_USE_CSS 1 // Use CSS style to report colors (1=> "#FF0000", 0=> "255,0,0")
  1075. #endif
  1076. #ifndef LIGHT_USE_RGB
  1077. #define LIGHT_USE_RGB 0 // Use RGB color selector (1=> RGB, 0=> HSV)
  1078. #endif
  1079. #ifndef LIGHT_WHITE_FACTOR
  1080. #define LIGHT_WHITE_FACTOR 1 // When using LIGHT_USE_WHITE with uneven brightness LEDs,
  1081. // this factor is used to scale the white channel to match brightness
  1082. #endif
  1083. #ifndef LIGHT_USE_TRANSITIONS
  1084. #define LIGHT_USE_TRANSITIONS 1 // Transitions between colors
  1085. #endif
  1086. #ifndef LIGHT_TRANSITION_STEP
  1087. #define LIGHT_TRANSITION_STEP 10 // Time in millis between each transtion step
  1088. #endif
  1089. #ifndef LIGHT_TRANSITION_TIME
  1090. #define LIGHT_TRANSITION_TIME 500 // Time in millis from color to color
  1091. #endif
  1092. // -----------------------------------------------------------------------------
  1093. // DOMOTICZ
  1094. // -----------------------------------------------------------------------------
  1095. #ifndef DOMOTICZ_SUPPORT
  1096. #define DOMOTICZ_SUPPORT MQTT_SUPPORT // Build with domoticz (if MQTT) support (1.72Kb)
  1097. #endif
  1098. #ifndef DOMOTICZ_ENABLED
  1099. #define DOMOTICZ_ENABLED 0 // Disable domoticz by default
  1100. #endif
  1101. #ifndef DOMOTICZ_IN_TOPIC
  1102. #define DOMOTICZ_IN_TOPIC "domoticz/in" // Default subscription topic
  1103. #endif
  1104. #ifndef DOMOTICZ_OUT_TOPIC
  1105. #define DOMOTICZ_OUT_TOPIC "domoticz/out" // Default publication topic
  1106. #endif
  1107. // -----------------------------------------------------------------------------
  1108. // HOME ASSISTANT
  1109. // -----------------------------------------------------------------------------
  1110. #ifndef HOMEASSISTANT_SUPPORT
  1111. #define HOMEASSISTANT_SUPPORT MQTT_SUPPORT // Build with home assistant support (if MQTT, 1.64Kb)
  1112. #endif
  1113. #ifndef HOMEASSISTANT_ENABLED
  1114. #define HOMEASSISTANT_ENABLED 0 // Integration not enabled by default
  1115. #endif
  1116. #ifndef HOMEASSISTANT_PREFIX
  1117. #define HOMEASSISTANT_PREFIX "homeassistant" // Default MQTT prefix
  1118. #endif
  1119. // -----------------------------------------------------------------------------
  1120. // INFLUXDB
  1121. // -----------------------------------------------------------------------------
  1122. #ifndef INFLUXDB_SUPPORT
  1123. #define INFLUXDB_SUPPORT 0 // Disable InfluxDB support by default (4.38Kb)
  1124. #endif
  1125. #ifndef INFLUXDB_ENABLED
  1126. #define INFLUXDB_ENABLED 0 // InfluxDB disabled by default
  1127. #endif
  1128. #ifndef INFLUXDB_HOST
  1129. #define INFLUXDB_HOST "" // Default server
  1130. #endif
  1131. #ifndef INFLUXDB_PORT
  1132. #define INFLUXDB_PORT 8086 // Default InfluxDB port
  1133. #endif
  1134. #ifndef INFLUXDB_DATABASE
  1135. #define INFLUXDB_DATABASE "" // Default database
  1136. #endif
  1137. #ifndef INFLUXDB_USERNAME
  1138. #define INFLUXDB_USERNAME "" // Default username
  1139. #endif
  1140. #ifndef INFLUXDB_PASSWORD
  1141. #define INFLUXDB_PASSWORD "" // Default password
  1142. #endif
  1143. // -----------------------------------------------------------------------------
  1144. // THINGSPEAK
  1145. // -----------------------------------------------------------------------------
  1146. #ifndef THINGSPEAK_SUPPORT
  1147. #define THINGSPEAK_SUPPORT 1 // Enable Thingspeak support by default (2.56Kb)
  1148. #endif
  1149. #ifndef THINGSPEAK_ENABLED
  1150. #define THINGSPEAK_ENABLED 0 // Thingspeak disabled by default
  1151. #endif
  1152. #ifndef THINGSPEAK_APIKEY
  1153. #define THINGSPEAK_APIKEY "" // Default API KEY
  1154. #endif
  1155. #ifndef THINGSPEAK_CLEAR_CACHE
  1156. #define THINGSPEAK_CLEAR_CACHE 1 // Clear cache after sending values
  1157. // Not clearing it will result in latest values for each field being sent every time
  1158. #endif
  1159. #ifndef THINGSPEAK_USE_ASYNC
  1160. #define THINGSPEAK_USE_ASYNC 1 // Use AsyncClient instead of WiFiClientSecure
  1161. #endif
  1162. // THINGSPEAK OVER SSL
  1163. // Using THINGSPEAK over SSL works well but generates problems with the web interface,
  1164. // so you should compile it with WEB_SUPPORT to 0.
  1165. // When THINGSPEAK_USE_ASYNC is 1, requires EspAsyncTCP to be built with ASYNC_TCP_SSL_ENABLED=1 and ESP8266 Arduino Core >= 2.4.0.
  1166. // When THINGSPEAK_USE_ASYNC is 0, requires Arduino Core >= 2.6.0 and SECURE_CLIENT_BEARSSL
  1167. //
  1168. // WARNING: Thingspeak servers do not support MFLN right now, connection requires at least 30KB of free RAM.
  1169. // Also see MQTT comments above.
  1170. #ifndef THINGSPEAK_USE_SSL
  1171. #define THINGSPEAK_USE_SSL 0 // Use secure connection
  1172. #endif
  1173. #ifndef THINGSPEAK_SECURE_CLIENT_CHECK
  1174. #define THINGSPEAK_SECURE_CLIENT_CHECK SECURE_CLIENT_CHECK
  1175. #endif
  1176. #ifndef THINGSPEAK_SECURE_CLIENT_MFLN
  1177. #define THINGSPEAK_SECURE_CLIENT_MFLN SECURE_CLIENT_MFLN
  1178. #endif
  1179. #ifndef THINGSPEAK_FINGERPRINT
  1180. #define THINGSPEAK_FINGERPRINT "78 60 18 44 81 35 BF DF 77 84 D4 0A 22 0D 9B 4E 6C DC 57 2C"
  1181. #endif
  1182. #ifndef THINGSPEAK_ADDRESS
  1183. #if THINGSPEAK_USE_SSL
  1184. #define THINGSPEAK_ADDRESS "https://api.thingspeak.com/update"
  1185. #else
  1186. #define THINGSPEAK_ADDRESS "http://api.thingspeak.com/update"
  1187. #endif
  1188. #endif // ifndef THINGSPEAK_ADDRESS
  1189. #ifndef THINGSPEAK_TRIES
  1190. #define THINGSPEAK_TRIES 3 // Number of tries when sending data (minimum 1)
  1191. #endif
  1192. #define THINGSPEAK_MIN_INTERVAL 15000 // Minimum interval between POSTs (in millis)
  1193. #define THINGSPEAK_FIELDS 8 // Number of fields
  1194. // -----------------------------------------------------------------------------
  1195. // SCHEDULER
  1196. // -----------------------------------------------------------------------------
  1197. #ifndef SCHEDULER_SUPPORT
  1198. #define SCHEDULER_SUPPORT 1 // Enable scheduler (2.45Kb)
  1199. #endif
  1200. #ifndef SCHEDULER_MAX_SCHEDULES
  1201. #define SCHEDULER_MAX_SCHEDULES 10 // Max schedules alowed
  1202. #endif
  1203. #ifndef SCHEDULER_RESTORE_LAST_SCHEDULE
  1204. #define SCHEDULER_RESTORE_LAST_SCHEDULE 0 // Restore the last schedule state on the device boot
  1205. #endif
  1206. #ifndef SCHEDULER_WEEKDAYS
  1207. #define SCHEDULER_WEEKDAYS "1,2,3,4,5,6,7" // (Default - Run the schedules every day)
  1208. #endif
  1209. // -----------------------------------------------------------------------------
  1210. // RPN RULES
  1211. // -----------------------------------------------------------------------------
  1212. #ifndef RPN_RULES_SUPPORT
  1213. #define RPN_RULES_SUPPORT 0 // Enable RPN Rules (8.6Kb)
  1214. #endif
  1215. #ifndef RPN_DELAY
  1216. #define RPN_DELAY 100 // Execute rules after 100ms without messages
  1217. #endif
  1218. #ifndef RPN_STICKY
  1219. #define RPN_STICKY 1 // Keeps variable after rule execution
  1220. #endif
  1221. // -----------------------------------------------------------------------------
  1222. // NTP
  1223. // -----------------------------------------------------------------------------
  1224. #ifndef NTP_SUPPORT
  1225. #define NTP_SUPPORT 1 // Build with NTP support by default (depends on Core version)
  1226. #endif
  1227. #ifndef NTP_SERVER
  1228. #define NTP_SERVER "pool.ntp.org" // Default NTP server
  1229. #endif
  1230. #ifndef NTP_TIMEZONE
  1231. #define NTP_TIMEZONE TZ_Etc_UTC // POSIX TZ variable. Default to UTC from TZ.h (which is PSTR("UTC0"))
  1232. // For the format documentation, see:
  1233. // - https://www.gnu.org/software/libc/manual/html_node/TZ-Variable.html
  1234. // ESP8266 Core provides human-readable aliases for POSIX format, see:
  1235. // - Latest: https://github.com/esp8266/Arduino/blob/master/cores/esp8266/TZ.h
  1236. // - PlatformIO: ~/.platformio/packages/framework-arduinoespressif8266/cores/esp8266/TZ.h
  1237. // (or, possibly, c:\.platformio\... on Windows)
  1238. // - Arduino IDE: depends on platform, see `/dist/arduino_ide/README.md`
  1239. #endif
  1240. #ifndef NTP_UPDATE_INTERVAL
  1241. #define NTP_UPDATE_INTERVAL 1800 // NTP check every 30 minutes
  1242. #endif
  1243. #ifndef NTP_START_DELAY
  1244. #define NTP_START_DELAY 3 // Delay NTP start for 3 seconds
  1245. #endif
  1246. #ifndef NTP_WAIT_FOR_SYNC
  1247. #define NTP_WAIT_FOR_SYNC 1 // Do not report any datetime until NTP sync'ed
  1248. #endif
  1249. // -----------------------------------------------------------------------------
  1250. // ALEXA
  1251. // -----------------------------------------------------------------------------
  1252. // This setting defines whether Alexa support should be built into the firmware
  1253. #ifndef ALEXA_SUPPORT
  1254. #define ALEXA_SUPPORT 1 // Enable Alexa support by default (10.84Kb)
  1255. #endif
  1256. // This is default value for the alexaEnabled setting that defines whether
  1257. // this device should be discoberable and respond to Alexa commands.
  1258. // Both ALEXA_SUPPORT and alexaEnabled should be 1 for Alexa support to work.
  1259. #ifndef ALEXA_ENABLED
  1260. #define ALEXA_ENABLED 1
  1261. #endif
  1262. #ifndef ALEXA_HOSTNAME
  1263. #define ALEXA_HOSTNAME ""
  1264. #endif
  1265. // -----------------------------------------------------------------------------
  1266. // RF BRIDGE
  1267. // -----------------------------------------------------------------------------
  1268. #ifndef RFB_SUPPORT
  1269. #define RFB_SUPPORT 0
  1270. #endif
  1271. #ifndef RFB_SEND_REPEATS
  1272. #define RFB_SEND_REPEATS 1 // How many times to send the message
  1273. #endif
  1274. // - RFB_PROVIDER_EFM8BB1
  1275. // Default option for the ITEAD_SONOFF_RFBRIDGE or any custom firmware implementing the protocol
  1276. // - RFB_PROVIDER_RCSWITCH
  1277. // Originally implemented for SONOFF BASIC
  1278. // https://tinkerman.cat/adding-rf-to-a-non-rf-itead-sonoff/
  1279. // Also possible to use with SONOFF RF BRIDGE, thanks to @wildwiz
  1280. // https://github.com/xoseperez/espurna/wiki/Hardware-Itead-Sonoff-RF-Bridge---Direct-Hack
  1281. #ifndef RFB_PROVIDER
  1282. #define RFB_PROVIDER RFB_PROVIDER_RCSWITCH
  1283. #endif
  1284. #ifndef RFB_RX_PIN
  1285. #define RFB_RX_PIN GPIO_NONE
  1286. #endif
  1287. #ifndef RFB_TX_PIN
  1288. #define RFB_TX_PIN GPIO_NONE
  1289. #endif
  1290. #ifndef RFB_LEARN_TIMEOUT
  1291. #define RFB_LEARN_TIMEOUT 15000
  1292. #endif
  1293. #ifndef RFB_SEND_DELAY
  1294. #define RFB_SEND_DELAY 500 // Interval between sendings in ms
  1295. #endif
  1296. #ifndef RFB_RECEIVE_DELAY
  1297. #define RFB_RECEIVE_DELAY 500 // Interval between recieving in ms (avoid bouncing)
  1298. #endif
  1299. #ifndef RFB_TRANSMIT_REPEATS
  1300. #define RFB_TRANSMIT_REPEATS 5 // How many times RCSwitch will repeat the message
  1301. #endif
  1302. // -----------------------------------------------------------------------------
  1303. // IR Bridge
  1304. // -----------------------------------------------------------------------------
  1305. #ifndef IR_SUPPORT
  1306. #define IR_SUPPORT 0 // Do not build with IR support by default (10.25Kb)
  1307. #endif
  1308. //#define IR_RX_PIN 5 // GPIO the receiver is connected to
  1309. //#define IR_TX_PIN 4 // GPIO the transmitter is connected to
  1310. #ifndef IR_USE_RAW
  1311. #define IR_USE_RAW 0 // Use raw codes
  1312. #endif
  1313. #ifndef IR_BUFFER_SIZE
  1314. #define IR_BUFFER_SIZE 1024
  1315. #endif
  1316. #ifndef IR_TIMEOUT
  1317. #define IR_TIMEOUT 15U
  1318. #endif
  1319. #ifndef IR_REPEAT
  1320. #define IR_REPEAT 1
  1321. #endif
  1322. #ifndef IR_DELAY
  1323. #define IR_DELAY 100
  1324. #endif
  1325. #ifndef IR_DEBOUNCE
  1326. #define IR_DEBOUNCE 500 // IR debounce time in milliseconds
  1327. #endif
  1328. #ifndef IR_BUTTON_SET
  1329. #define IR_BUTTON_SET 0 // IR button set to use (see ../ir_button.h)
  1330. #endif
  1331. //--------------------------------------------------------------------------------
  1332. // Custom RFM69 to MQTT bridge
  1333. // Check http://tinkerman.cat/rfm69-wifi-gateway/
  1334. // Enable support by passing RFM69_SUPPORT=1 build flag
  1335. //--------------------------------------------------------------------------------
  1336. #ifndef RFM69_SUPPORT
  1337. #define RFM69_SUPPORT 0
  1338. #endif
  1339. #ifndef RFM69_MAX_TOPICS
  1340. #define RFM69_MAX_TOPICS 50
  1341. #endif
  1342. #ifndef RFM69_MAX_NODES
  1343. #define RFM69_MAX_NODES 255
  1344. #endif
  1345. #ifndef RFM69_DEFAULT_TOPIC
  1346. #define RFM69_DEFAULT_TOPIC "/rfm69gw/{node}/{key}"
  1347. #endif
  1348. #ifndef RFM69_NODE_ID
  1349. #define RFM69_NODE_ID 1
  1350. #endif
  1351. #ifndef RFM69_GATEWAY_ID
  1352. #define RFM69_GATEWAY_ID 1
  1353. #endif
  1354. #ifndef RFM69_NETWORK_ID
  1355. #define RFM69_NETWORK_ID 164
  1356. #endif
  1357. #ifndef RFM69_PROMISCUOUS
  1358. #define RFM69_PROMISCUOUS 0
  1359. #endif
  1360. #ifndef RFM69_PROMISCUOUS_SENDS
  1361. #define RFM69_PROMISCUOUS_SENDS 0
  1362. #endif
  1363. #ifndef RFM69_FREQUENCY
  1364. #define RFM69_FREQUENCY RF69_868MHZ
  1365. #endif
  1366. #ifndef RFM69_ENCRYPTKEY
  1367. #define RFM69_ENCRYPTKEY "fibonacci0123456"
  1368. #endif
  1369. #ifndef RFM69_CS_PIN
  1370. #define RFM69_CS_PIN SS
  1371. #endif
  1372. #ifndef RFM69_IRQ_PIN
  1373. #define RFM69_IRQ_PIN 5
  1374. #endif
  1375. #ifndef RFM69_RESET_PIN
  1376. #define RFM69_RESET_PIN 7
  1377. #endif
  1378. #ifndef RFM69_IS_RFM69HW
  1379. #define RFM69_IS_RFM69HW 0
  1380. #endif
  1381. //--------------------------------------------------------------------------------
  1382. // TUYA switch & dimmer support
  1383. //--------------------------------------------------------------------------------
  1384. #ifndef TUYA_SUPPORT
  1385. #define TUYA_SUPPORT 0
  1386. #endif
  1387. #ifndef TUYA_SERIAL
  1388. #define TUYA_SERIAL Serial
  1389. #endif
  1390. //--------------------------------------------------------------------------------
  1391. // Support expander MCP23S08
  1392. //--------------------------------------------------------------------------------
  1393. #ifndef MCP23S08_SUPPORT
  1394. #define MCP23S08_SUPPORT 0
  1395. #endif
  1396. //--------------------------------------------------------------------------------
  1397. // Support prometheus metrics export
  1398. //--------------------------------------------------------------------------------
  1399. #ifndef PROMETHEUS_SUPPORT
  1400. #define PROMETHEUS_SUPPORT 0
  1401. #endif
  1402. // =============================================================================
  1403. // Configuration helpers
  1404. // =============================================================================
  1405. //------------------------------------------------------------------------------
  1406. // Provide generic way to detect debugging support
  1407. //------------------------------------------------------------------------------
  1408. #ifndef DEBUG_SUPPORT
  1409. #define DEBUG_SUPPORT ( \
  1410. DEBUG_SERIAL_SUPPORT || \
  1411. DEBUG_UDP_SUPPORT || \
  1412. DEBUG_TELNET_SUPPORT || \
  1413. DEBUG_WEB_SUPPORT \
  1414. )
  1415. #endif