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.

223 lines
7.5 KiB

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
  1. //------------------------------------------------------------------------------
  2. // Do not change this file unless you know what you are doing
  3. // Configuration settings are in the general.h file
  4. //------------------------------------------------------------------------------
  5. #pragma once
  6. //------------------------------------------------------------------------------
  7. // Various modules configuration
  8. #if DEBUG_TELNET_SUPPORT
  9. #undef TELNET_SUPPORT
  10. #define TELNET_SUPPORT 1
  11. #endif
  12. #if not WEB_SUPPORT
  13. #undef DEBUG_WEB_SUPPORT
  14. #define DEBUG_WEB_SUPPORT 0
  15. #endif
  16. #if not WEB_SUPPORT
  17. #undef API_SUPPORT
  18. #define API_SUPPORT 0 // API support requires web support
  19. #endif
  20. #if not WEB_SUPPORT
  21. #undef SSDP_SUPPORT
  22. #define SSDP_SUPPORT 0 // SSDP support requires web support
  23. #endif
  24. #if UART_MQTT_SUPPORT
  25. #undef MQTT_SUPPORT
  26. #define MQTT_SUPPORT 1 // UART<->MQTT requires MQTT and no serial debug
  27. #undef DEBUG_SERIAL_SUPPORT
  28. #define DEBUG_SERIAL_SUPPORT 0 // TODO: compare UART_MQTT_PORT with DEBUG_PORT? (as strings)
  29. #endif
  30. #if ALEXA_SUPPORT
  31. #undef BROKER_SUPPORT
  32. #define BROKER_SUPPORT 1 // If Alexa enabled enable BROKER
  33. #undef RELAY_SUPPORT
  34. #define RELAY_SUPPORT 1 // and switches
  35. #endif
  36. #if RPN_RULES_SUPPORT
  37. #undef BROKER_SUPPORT
  38. #define BROKER_SUPPORT 1 // If RPN Rules enabled enable BROKER
  39. #undef MQTT_SUPPORT
  40. #define MQTT_SUPPORT 1
  41. #endif
  42. #if RF_SUPPORT
  43. #undef RELAY_SUPPORT
  44. #define RELAY_SUPPORT 1
  45. #endif
  46. #if LED_SUPPORT
  47. #undef BROKER_SUPPORT
  48. #define BROKER_SUPPORT 1 // If LED is enabled enable BROKER to supply status changes
  49. #endif
  50. #if INFLUXDB_SUPPORT
  51. #undef BROKER_SUPPORT
  52. #define BROKER_SUPPORT 1 // If InfluxDB enabled enable BROKER
  53. #endif
  54. #if DOMOTICZ_SUPPORT
  55. #undef BROKER_SUPPORT
  56. #define BROKER_SUPPORT 1 // If Domoticz enabled enable BROKER
  57. #undef MQTT_SUPPORT
  58. #define MQTT_SUPPORT 1 // If Domoticz enabled enable MQTT
  59. #endif
  60. #if HOMEASSISTANT_SUPPORT
  61. #undef MQTT_SUPPORT
  62. #define MQTT_SUPPORT 1 // If Home Assistant enabled enable MQTT
  63. #endif
  64. #if THINGSPEAK_SUPPORT
  65. #undef BROKER_SUPPORT
  66. #define BROKER_SUPPORT 1 // If Thingspeak enabled enable BROKER
  67. #endif
  68. #if THERMOSTAT_SUPPORT
  69. #undef MQTT_USE_JSON
  70. #define MQTT_USE_JSON 1 // Thermostat depends on group messages in a JSON body
  71. #undef RELAY_SUPPORT
  72. #define RELAY_SUPPORT 1 // Thermostat depends on switches
  73. #endif
  74. #if SCHEDULER_SUPPORT
  75. #undef NTP_SUPPORT
  76. #define NTP_SUPPORT 1 // Scheduler needs NTP to work
  77. #undef BROKER_SUPPORT
  78. #define BROKER_SUPPORT 1 // Scheduler needs Broker to trigger every minute
  79. #undef RELAY_SUPPORT
  80. #define RELAY_SUPPORT 1 // Scheduler needs relays
  81. #endif
  82. #if LWIP_VERSION_MAJOR != 1
  83. #undef MDNS_CLIENT_SUPPORT
  84. #define MDNS_CLIENT_SUPPORT 0 // default resolver already handles this
  85. #endif
  86. #if not defined(ARDUINO_ESP8266_RELEASE_2_3_0)
  87. #undef TELNET_SERVER_ASYNC_BUFFERED
  88. #define TELNET_SERVER_ASYNC_BUFFERED 1 // enable buffered telnet by default on latest Cores
  89. #endif
  90. #if LIGHT_PROVIDER == LIGHT_PROVIDER_TUYA
  91. #undef TUYA_SUPPORT
  92. #define TUYA_SUPPORT 1 // Need base Tuya module for this to work
  93. #undef LIGHT_USE_TRANSITIONS
  94. #define LIGHT_USE_TRANSITIONS 0 // TODO: temporary, maybe slower step instead?
  95. #endif
  96. #if TUYA_SUPPORT
  97. #undef BROKER_SUPPORT
  98. #define BROKER_SUPPORT 1 // Broker is required to process relay & lights events
  99. #undef RELAY_SUPPORT
  100. #define RELAY_SUPPORT 1 // Most of the time we require it
  101. #endif
  102. #if TERMINAL_WEB_API_SUPPORT
  103. #undef TERMINAL_SUPPORT
  104. #define TERMINAL_SUPPORT 1 // Need terminal command line parser and commands
  105. #undef WEB_SUPPORT
  106. #define WEB_SUPPORT 1 // Registered as web server request handler
  107. #endif
  108. #if TERMINAL_MQTT_SUPPORT
  109. #undef TERMINAL_SUPPORT
  110. #define TERMINAL_SUPPORT 1 // Need terminal command line parser and commands
  111. #undef MQTT_SUPPORT
  112. #define MQTT_SUPPORT 1 // Subscribe and publish things
  113. #endif
  114. //------------------------------------------------------------------------------
  115. // Hint about ESPAsyncTCP options and our internal one
  116. // TODO: clean-up SSL_ENABLED and USE_SSL settings for 1.15.0
  117. #if ASYNC_TCP_SSL_ENABLED && SECURE_CLIENT == SECURE_CLIENT_NONE
  118. #undef SECURE_CLIENT
  119. #define SECURE_CLIENT SECURE_CLIENT_AXTLS
  120. #endif
  121. #if THINGSPEAK_USE_SSL && THINGSPEAK_USE_ASYNC && (!ASYNC_TCP_SSL_ENABLED)
  122. #warning "Thingspeak in ASYNC mode requires a globally defined ASYNC_TCP_SSL_ENABLED=1"
  123. #undef THINGSPEAK_SUPPORT
  124. #define THINGSPEAK_SUPPORT 0 // Thingspeak in ASYNC mode requires ASYNC_TCP_SSL_ENABLED
  125. #endif
  126. #if WEB_SUPPORT && WEB_SSL_ENABLED && (!ASYNC_TCP_SSL_ENABLED)
  127. #warning "WEB_SUPPORT with SSL requires a globally defined ASYNC_TCP_SSL_ENABLED=1"
  128. #undef WEB_SSL_ENABLED
  129. #define WEB_SSL_ENABLED 0 // WEB_SUPPORT mode th SSL requires ASYNC_TCP_SSL_ENABLED
  130. #endif
  131. #if !DEBUG_SUPPORT
  132. #undef DEBUG_LOG_BUFFER_SUPPORT
  133. #define DEBUG_LOG_BUFFER_SUPPORT 0 // Can't buffer if there is no debugging enabled.
  134. // Helps to avoid checking twice for both DEBUG_SUPPORT and BUFFER_LOG_SUPPORT
  135. #endif
  136. //------------------------------------------------------------------------------
  137. // These depend on newest Core libraries
  138. #if LLMNR_SUPPORT && defined(ARDUINO_ESP8266_RELEASE_2_3_0)
  139. #undef LLMNR_SUPPORT
  140. #define LLMNR_SUPPORT 0
  141. #endif
  142. #if NETBIOS_SUPPORT && defined(ARDUINO_ESP8266_RELEASE_2_3_0)
  143. #undef NETBIOS_SUPPORT
  144. #define NETBIOS_SUPPORT 0
  145. #endif
  146. #if SSDP_SUPPORT && defined(ARDUINO_ESP8266_RELEASE_2_3_0)
  147. #undef SSDP_SUPPORT
  148. #define SSDP_SUPPORT 0
  149. #endif
  150. //------------------------------------------------------------------------------
  151. // Change ntp module depending on Core version
  152. #if NTP_SUPPORT && defined(ARDUINO_ESP8266_RELEASE_2_3_0)
  153. #define NTP_LEGACY_SUPPORT 1
  154. #else
  155. #define NTP_LEGACY_SUPPORT 0
  156. #endif
  157. //------------------------------------------------------------------------------
  158. // When using Dual / Lightfox Dual, notify that Serial should be used
  159. #if (BUTTON_EVENTS_SOURCE == BUTTON_EVENTS_SOURCE_ITEAD_SONOFF_DUAL) || \
  160. (BUTTON_EVENTS_SOURCE == BUTTON_EVENTS_SOURCE_FOXEL_LIGHTFOX_DUAL)
  161. #if DEBUG_SERIAL_SUPPORT
  162. #warning "DEBUG_SERIAL_SUPPORT conflicts with the current BUTTON_EVENTS_SOURCE"
  163. #undef DEBUG_SERIAL_SUPPORT
  164. #define DEBUG_SERIAL_SUPPORT 0
  165. #endif
  166. #endif
  167. //------------------------------------------------------------------------------
  168. // It looks more natural that one click will enable display
  169. // and long click will switch relay
  170. #if THERMOSTAT_DISPLAY_SUPPORT
  171. #undef BUTTON1_CLICK
  172. #define BUTTON1_CLICK BUTTON_ACTION_DISPLAY_ON
  173. #undef BUTTON1_LNGCLICK
  174. #define BUTTON1_LNGCLICK BUTTON_ACTION_TOGGLE
  175. #endif
  176. //------------------------------------------------------------------------------
  177. // We should always set MQTT_MAX_PACKET_SIZE
  178. //
  179. #if MQTT_LIBRARY == MQTT_LIBRARY_PUBSUBCLIENT
  180. #if not defined(MQTT_MAX_PACKET_SIZE)
  181. #warning "MQTT_MAX_PACKET_SIZE should be set in `build_flags = ...` of the environment! Default value is used instead."
  182. #endif
  183. #endif