configGway.h 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313
  1. // 1-channel LoRa Gateway for ESP8266
  2. // Copyright (c) 2016, 2017, 2018, 2019 Maarten Westenberg version for ESP8266
  3. // Specify the correct version and date of your gateway here.
  4. // Normally it is provided with the GitHub version
  5. #define VERSION "V.6.1.7.E.EU868; 191228a"
  6. //
  7. // Based on work done by Thomas Telkamp for Raspberry PI 1ch gateway and many others.
  8. // Contibutions of Dorijan Morelj and Andreas Spies for OLED support.
  9. //
  10. // All rights reserved. This program and the accompanying materials
  11. // are made available under the terms of the MIT License
  12. // which accompanies this distribution, and is available at
  13. // https://opensource.org/licenses/mit-license.php
  14. //
  15. // NO WARRANTY OF ANY KIND IS PROVIDED
  16. //
  17. // Author: Maarten Westenberg (mw12554@hotmail.com)
  18. //
  19. // This file contains a number of compile-time settings that can be set on (=1) or off (=0)
  20. // The disadvantage of compile time is minor compared to the memory gain of not having
  21. // too much code compiled and loaded on your ESP device.
  22. //
  23. // NOTE:
  24. // If version is for ESP32 Heltec board, compile with ESP32 setting and board
  25. // "ESP32 Dev Module" or "Heltec WiFi Lora 32"
  26. //
  27. // For ESP8266 Wemos: compile with "Wemos R1 D1" and choose
  28. // the right _PIN_OUT below. Selecting OLED while that is not connected does not
  29. // really matter.
  30. //
  31. // ========================================================================================
  32. // Define whether we should do a formatting of SPIFFS when starting the gateway
  33. // This is usually a good idea if the webserver is interrupted halfway a writing
  34. // operation. Also to be used when software is upgraded
  35. // Normally, value 0 is a good default and should not be changed.
  36. #define _SPIFF_FORMAT 0
  37. // Define the CLASS mode of the gateway
  38. // A: Baseline Class
  39. // B: Beacon/Battery Class
  40. // C: Continuous Listen Class
  41. #define _CLASS "A"
  42. // Debug message will be put on Serial is this one is set.
  43. // If set to 0, no printing to USB devices is done.
  44. // Set to 1 it will print all user level messages (with correct debug set)
  45. // If set to 2 it will also print interrupt messages (not recommended)
  46. #define _DUSB 1
  47. // Define the monitor screen. When it is greater than 0 then logging is displayed in
  48. // the special screen at the GUI.
  49. // If _DUSB is also set to 1 then most messages will also be copied to USB devices.
  50. #define _MONITOR 20
  51. // Gather statistics on sensor and Wifi status
  52. // 0= No statistics
  53. // 1= Keep track of messages statistics, number determined by MAX_STAT
  54. // 2= Option 1 + Keep track of messages received PER each SF (default)
  55. // 3= See Option 2, but with extra channel info (Not used when Hopping is not selected)
  56. #define _STATISTICS 3
  57. // Define the frequency band the gateway will listen on. Valid options are
  58. // EU863_870 Europe
  59. // US902_928 North America
  60. // AU925_928 Australia
  61. // CN470_510 China
  62. // IN865_867 India
  63. // CN779-787 (Not Used!)
  64. // EU433 Europe
  65. // AS923 (Not Used)
  66. // You can find the definitions in "loraModem.h" and frequencies in
  67. // See https://www.thethingsnetwork.org/docs/lorawan/frequency-plans.html
  68. #define EU863_870 1
  69. // Define whether to use the old Semtech gateway API, which is still supported by TTN,
  70. // but is more lightweight than the new TTN tcp based protocol.
  71. // NOTE: Only one of the two should be defined! TTN Router project has stopped
  72. //
  73. #define _UDPROUTER 1
  74. //#define _TTNROUTER 1
  75. // The spreading factor is the most important parameter to set for a single channel
  76. // gateway. It specifies the speed/datarate in which the gateway and node communicate.
  77. // As the name says, in principle the single channel gateway listens to one channel/frequency
  78. // and to one spreading factor only.
  79. // This parameters contains the default value of SF, the actual version can be set with
  80. // the webserver and it will be stored in SPIFF
  81. // NOTE: The frequency is set in the loraModem.h file and is default 868.100000 MHz.
  82. #define _SPREADING SF9
  83. // Channel Activity Detection
  84. // This function will scan for valid LoRa headers and determine the Spreading
  85. // factor accordingly. If set to 1 we will use this function which means the
  86. // 1-channel gateway will become even more versatile. If set to 0 we will use the
  87. // continuous listen mode.
  88. // Using this function means that we HAVE to use more dio pins on the RFM95/sx1276
  89. // device and also connect enable dio1 to detect this state.
  90. #define _CAD 1
  91. // CRCCHECK
  92. // Defines whether we should check on the CRC of RXDONE messages (see stateMachine.ino)
  93. // This should prevent us from getting a lot os stranges messgages of unknown nodes.
  94. // Note: DIO3 must be connected for this to work (Heltec and later Wemos gateways).
  95. #define _CRCCHECK 1
  96. // Definitions for the admin webserver.
  97. // A_SERVER determines whether or not the admin webpage is included in the sketch.
  98. // Normally, leave it in!
  99. #define A_SERVER 1 // Define local WebServer only if this define is set
  100. #define A_REFRESH 1 // Allow the webserver refresh or not?
  101. #define A_SERVERPORT 80 // Local webserver port (normally 80)
  102. #define A_MAXBUFSIZE 192 // Must be larger than 128, but small enough to work
  103. // Definitions for over the air updates. At the moment we support OTA with IDE
  104. // Make sure that tou have installed Python version 2.7 and have Bonjour in your network.
  105. // Bonjour is included in iTunes (which is free) and OTA is recommended to install
  106. // the firmware on your router witout having to be really close to the gateway and
  107. // connect with USB.
  108. #define A_OTA 1
  109. // We support a few pin-out configurations out-of-the-box: HALLARD, COMPRESULT and TTGO ESP32.
  110. // If you use one of these two, just set the parameter to the right value.
  111. // If your pin definitions are different, update the loraModem.h file to reflect these settings.
  112. // 1: HALLARD
  113. // 2: COMRESULT pin out
  114. // 3: ESP32 Wemos pin out
  115. // 4: ESP32 TTGO pin out (should work for Heltec, 433 and OLED too).
  116. // 5: Other, define your own in loraModem.h (does not include GPS Code)
  117. #define _PIN_OUT 4
  118. // Single channel gateways if they behave strict should only use one frequency
  119. // channel and one, or in case _CAD all, spreading factors.
  120. // The TTN backend replies on RX1 timeslot for spreading factors SF9-SF12.
  121. // If the 1ch gateway is working in and for nodes that ONLY transmit and receive on the set
  122. // and agreed frequency and spreading factor. make sure to set STRICT to 1.
  123. // In this case, the frequency and spreading factor for downlink messages is adapted by this
  124. // gateway
  125. // NOTE: If your node has only one frequency enabled and one SF, you must set this to 1
  126. // in order to receive downlink messages. This is the default mode.
  127. // NOTE: In all other cases, value 0 works for most gateways with CAD enabled
  128. #define _STRICT_1CH 1
  129. //
  130. // Also, normally the server will respond with SF12 in the RX2 timeslot.
  131. // For TTN, thr RX2 timeslot is SF9, and we should use that one for TTN
  132. #define _RX2_SF 9
  133. // Allows configuration through WifiManager AP setup. Must be 0 or 1
  134. #define _WIFIMANAGER 0
  135. // Define the name of the accesspoint if the gateway is in accesspoint mode (is
  136. // getting WiFi SSID and password using WiFiManager)
  137. #define AP_NAME "ESP8266-Gway-Things4U"
  138. #define AP_PASSWD "ttnAutoPw"
  139. // This section defines whether we use the gateway as a repeater
  140. // For his, we use another output channel as the channel (default==0) we are
  141. // receiving the messages on.
  142. #define _REPEATER 0
  143. // Will we use Mutex or not?
  144. // +SPI is input for SPI, SPO is output for SPI
  145. #define MUTEX 0
  146. // Define if OLED Display is connected to I2C bus. Note that defining an OLED display does not
  147. // impact performance very much, certainly if no OLED is connected. Wrong OLED will not show
  148. // sensible results on display
  149. // OLED==0; No OLED display connected
  150. // OLED==1; 0.9 Oled Screen based on SSD1306
  151. // OLED==2; 1"3 Oled screens for Wemos, 128x64 SH1106
  152. #define OLED 1
  153. // Define whether we want to manage the gateway over UDP (next to management
  154. // thru webinterface).
  155. // This will allow us to send messages over the UDP connection to manage the gateway
  156. // and its parameters. Sometimes the gateway is not accesible from remote,
  157. // in this case we would allow it to use the SERVER UDP connection to receive
  158. // messages as well.
  159. // NOTE: Be aware that these messages are NOT LoRa and NOT LoRa Gateway spec compliant.
  160. // However that should not interfere with regular gateway operation but instead offer
  161. // functions to set/reset certain parameters from remote.
  162. #define GATEWAYMGT 0
  163. // Do extensive logging
  164. // Use the ESP8266 SPIFS filesystem to do extensive logging.
  165. // We must take care that the filesystem never(!) is full, and for that purpose we
  166. // rather have new records/line of statistics than very old.
  167. // Of course we must store enough records to make the filesystem work
  168. #define STAT_LOG 1
  169. // Set the Server Settings (IMPORTANT)
  170. #define _LOCUDPPORT 1700 // UDP port of gateway! Often 1700 or 1701 is used for upstream comms
  171. // Timing
  172. #define _MSG_INTERVAL 15 // Reset timer in seconds
  173. #define _PULL_INTERVAL 55 // PULL_DATA messages to server to get downstream in milliseconds
  174. #define _STAT_INTERVAL 120 // Send a 'stat' message to server
  175. #define _NTP_INTERVAL 3600 // How often do we want time NTP synchronization
  176. #define _WWW_INTERVAL 60 // Number of seconds before we refresh the WWW page
  177. // This defines whether or not we would use the gateway as
  178. // as sort of backend system for local sensors which decodes
  179. // 1: _LOCALSERVER is used
  180. // 0: Do not use _LOCALSERVER
  181. #define _LOCALSERVER 1 // See server definitions for decodes
  182. // Gateway Ident definitions. Where is the gateway located?
  183. #define _DESCRIPTION "ESP Gateway" // Name of the gateway
  184. #define _EMAIL "mw12554@hotmail.com" // Owner
  185. #define _PLATFORM "ESP8266"
  186. #define _LAT 52.237367
  187. #define _LON 5.978654
  188. #define _ALT 14 // Altitude
  189. // ntp
  190. // Please add daylight saving time to NTP_TIMEZONES when desired
  191. #define NTP_TIMESERVER "nl.pool.ntp.org" // Country and region specific
  192. #define NTP_TIMEZONES 1 // How far is our Timezone from UTC (excl daylight saving/summer time)
  193. #define SECS_IN_HOUR 3600
  194. #define NTP_INTR 0 // Do NTP processing with interrupts or in loop();
  195. // lora sensor code definitions
  196. // Defines whether the gateway will also report sensor/status value on MQTT
  197. // (such as battery and GPS)
  198. // after all, a gateway can be a node to the system as well. Some sensors like GPS can be
  199. // sent to the backend as a parameter, some (like humidity for example) can only be sent
  200. // as a regular sensor value.
  201. // Set its LoRa address and key below in this file, See spec. para 4.3.2
  202. #define GATEWAYNODE 0
  203. // We can put the gateway in such a mode that it will (only) recognize
  204. // nodes that are put in a list of trusted nodes
  205. // Values:
  206. // 0: Do not use names for trusted Nodes
  207. // 1: Use the nodes as a translation table for hex codes to names (in TLN)
  208. // 2: Same as 1, but is nodes NOT in the nodes list below they are NOT shown
  209. // NOTE: We probably will make this list dynamic!
  210. #define _TRUSTED_NODES 1
  211. #define _TRUSTED_DECODE 1
  212. // ========================================================================
  213. // DO NOT CHANGE BELOW THIS LINE
  214. // Probably do not change items below this line, only if lists or
  215. // configurations on configNode.h are not large enough for example.
  216. // ========================================================================
  217. // Maximum number of Message History statistics records gathered. 20 is a good maximum
  218. // (memory intensive). For ESP32 maybe 30 could be used as well
  219. #define MAX_STAT 20
  220. // We will log a list of LoRa nodes that was forwarded using this gateway.
  221. // For eacht node we record:
  222. // - node Number, or known node name
  223. // - Last seen 'seconds since 1/1/1970'
  224. // - SF seen (8-bit integer with SF per bit)
  225. // The initial version _NUMMAX stores max this many nodes, please make
  226. // _SEENMAX==0 when not used
  227. #define _SEENMAX 20
  228. #define _SEENFILE "/gwayNum.txt"
  229. // Name of he configfile in SPIFFs filesystem
  230. // In this file we store the configuration and other relevant info that should
  231. // survive a reboot of the gateway
  232. #define CONFIGFILE "/gwayConfig.txt"
  233. // Define the correct radio type that you are using
  234. #define CFG_sx1276_radio
  235. //#define CFG_sx1272_radio
  236. // Serial Port speed
  237. #define _BAUDRATE 115200 // Works for debug messages to serial momitor
  238. // MQTT definitions, these settings should be standard for TTN
  239. // and need no changing
  240. #define _TTNSERVER "router.eu.thethings.network"
  241. #define _TTNPORT 1700 // Standard port for TTN