Configuration - Breezedude/breezedudeWindSensor GitHub Wiki

Location (GPS coordinates), altitude and sensor orientation are set via a text file on the device and can be adjusted manually or via the configurator.

To do so, connect the Breezedude to your computer via USB, press reset once and read in the "settings.txt" file on the mass storage device. Then download the revised configuration file from the configurator and copy it to the Breezedude flash device (overwrite). The filename of the active file must be settings.txt.

Parameter

[!IMPORTANT] Switches are enabled with 1 and disabled with 0. Not all parameters need to be present in the configuration. If a parameter is missing, the default value listed below is used. Times are given in seconds. Decimals always use ..

Station

  • NAME=?Test Station name of the station being broadcast. The ? keeps whitespace. The altitude is added to the name automatically when sent via FANET (breezedude.de moves it from the name to the altitude field).
  • LAT=47.891249 latitude of the station, WGS84.
  • LON=12.194196 longitude of the station, WGS84.
  • ALT=460 altitude above mean sea level (MSL) in meters.
  • HEADING_OFFSET=0 offset in degrees between the sensor's 'north' and true north. Use the configurator for a graphical setup. Default 0.

Wind sensor

Enable exactly one wind sensor. If several are enabled, the last one in the file wins. Without a wind sensor the station only works as a repeater.

  • SENSOR_WS85_UART=1 Ecowitt WS85 in UART mode (see modification).
  • SENSOR_WSXX=1 Ecowitt WS80 or WS85, type detected automatically.
  • SENSOR_DAVIS6410=1 Davis 6410 anemometer.
  • SENSOR_WINDNERD=1 Windnerd Core.
  • SENSOR_WS80=1 / SENSOR_WS85=1 legacy names, kept for old configuration files. Use SENSOR_WSXX instead.
  • SENSOR_INTEGRATION_TIME=12 Davis 6410 only: time window in seconds over which pulses are counted; sets the gust resolution. Default 12.

Other sensors

  • SENSOR_BARO=1 use the barometer on the Breezedude (type detected automatically). Disable it if it delivers wrong values or an external barometer is used. A failing barometer never holds back the wind data. Default 0, the configurator sets 1.
  • SENSOR_GPS=0 read the position from a GPS module. Default 0.
  • GPS_BAUD=9600 baud rate of the GPS module. Default 9600.
  • SENSOR_IMU=0 use the IMU/compass. Default 0.

Averaging and intervals

  • WIND_AGE=30 seconds over which the wind is averaged as 'current wind'. Default 30.
  • GUST_AGE=600 seconds in which the gust is determined as 'current gust'. Default 600.
  • BROADCAST_INTERVAL_WEATHER=40 interval in seconds for weather messages; 0 disables them. Default 40.
  • BROADCAST_INTERVAL_NAME=300 interval in seconds for the station name; 0 disables it. Default 300.
  • REDU_INTERV_VOLT=3.38 below this battery voltage the broadcast intervals are lengthened to save energy. Default 3.38.

Radio

  • LORA_FREQ=868.2 LoRa frequency in MHz. EU is 868.2 MHz, North America 920.8 MHz. Selected automatically from the coordinates; manual override only. See Protocol.
  • LORA_BW=250 LoRa bandwidth in kHz. EU 250 kHz, North America 500 kHz. Manual override only.
  • LBT=0 Listen Before Talk: check the channel before sending and retry later if it is busy. Slightly higher consumption, better delivery on busy channels. Default 0.
  • LBT_RSSI_THRESHOLD=-104 channel counts as busy above this RSSI in dBm. Default -104.

Forwarding and repeater

A repeater only forwards packets that carry the forward flag.

  • FORWARD_DATA=0 set the forward flag on this station's own packets (weather, name, status). Enable on stations that reach the ground station only through a repeater. Default 0.
  • FANET_SMART_FORWARD=0 the station receives and forwards weak packets only while its battery is full and the solar panel delivers surplus energy. No external solar panel needed, but no reliable forwarding. Default 0.
  • REPEATER=0 repeater mode: the receiver is on whenever the station is not sending, and every packet with the forward flag is forwarded. Requires an external 5 V solar panel. Default 0.
  • REPEATER_SCHED=0 together with REPEATER=1, firmware 1.2 or newer: the repeater learns the transmit rhythm of every station it forwards and switches the receiver on only around the expected packets. A fraction of the current of REPEATER=1 alone. With a full battery and solar surplus it listens continuously. Default 0.
  • REPEATER_SCAN_INTERVAL=3600 with REPEATER_SCHED=1: seconds from one scan window to the next. During a scan window the repeater listens continuously to find new stations or changed rhythms. Default 3600.
  • REPEATER_SCAN_DURATION=360 with REPEATER_SCHED=1: length of a scan window in seconds. It should be longer than the longest broadcast interval of the forwarded stations. 0 disables scanning, so only stations already known are forwarded. Default 360.

Hardware

  • HW_REVISION=25 pins the pin map to hardware 2.5 (25) or 2.4 and older (24). Detected automatically; only needed if the detection fails.

Updates

  • OTA_ENABLE=1 allow firmware and configuration updates over the air. Default 1.
  • OTA_FAST=0 announce update readiness 20 s after boot instead of after 10 min. For testing. Default 0.

Logging and testing

  • DEBUG=1 print log messages on the debug UART. Can be left enabled. Default 0.
  • ERRORS=0 print additional error messages. Default 0.
  • USB_VERBOSE=0 detailed log per wakeup instead of the compact one-line log. Default 0.
  • UART_WAKE=0 let the debug UART wake the station, so console commands are accepted at any time. Costs standby current. Default 0.
  • TESTMODE=0 send test values without a wind sensor to check the FANET coverage. Testing only. Default 0.
  • DIV_CPU_SLOW=1 CPU clock divider during sleep. Development only. Default 1.
  • WDT=1 watchdog. Always on in the field; WDT=0 is for development only and is not stored. Default 1.

[!IMPORTANT] Comments can be added with # at the start of a line. Whitespace is removed automatically, except in values starting with ?.

Intervals

Recommended broadcast intervals are 40 sec for weather data and 300 sec for the station name. These values are tested. With more frequent transmissions the battery may deplete. In shaded locations it may be necessary to increase the intervals slightly or to use a housing with a bigger solar cell. Below REDU_INTERV_VOLT the station lengthens its intervals automatically.

[!NOTE] The configuration can also be edited using an Android cell phone or tablet. It is best to prepare the file in advance and only copy it to the Breezedude. In my case, the Android device could not use the mass storage without formatting it first. This should be possible without any problems and should also work afterwards (red LED must remain off). Depending on the file manager/app used, the file is not always written properly when editing (opening directly on the Breezedude drive, the file exists but is 0kb in size). Therefore it is better to just copy it, that works better. If you want to do this with your cell phone, it is best to try out the process at home in peace.