MeshCom Versions - Institute of Citizen Science

Current MeshCom 4.0 MC firmware 4.33e release

2024-08-06 4.33e

New country code code "ON". LoRa parameters SF,CR,BW adjusted
- see table: Country code table

2024-08-01 4.33d

HELTEC V3 new pins for GPS module RX...47, TX...48
Remote control via LoRa messages ... setting outputs
- DM to the callsign of the target node with MCP23007 modules
- {MCP}A9ppppp ...
  {MCP} ... Command ID
  A ... values A or B (see MCP23007)
  9 ... values 0-8 Pin# (see MCP23007)
  ppppp ... Telecontrol password (see command - - passwd ppppp)
New command: - -gateway nopos
- Sets the condition whether position data arriving from the server via UDP should not be sent out via LoRa
SOFTSER with sample app for querying water levels and water temperatures
New commands:
- - softser on/off
- - softser baud
- - softser send
- - softser app
- - softserdebug on/off
- - softser fixed level
- - softser fixtemp

2024-06-04 4.33b

RAK RX/TX Loop adapted to ESP32 (WaitTimer after RX)
Groups are now also transferred from a client to the MeshCom server
All 6 GRC groups are now equivalent for gateway and client

2024-05-30 4.33a

WEBService
- TXPower to SETUP added
- Info extended by INA226 values
New functions for:
- Voltage/current sensor I2C module INA226
- RealType Clock I2C module DS3231
LoRa modules SX126x and SX127x with improved RX/TX loop with interrupt
Country code EU8 and UK8 set the preamble to 8 symbols instead of 32
New commands for Group Call (GRC)
- -setgrc
- Example:
  - Set groups - setgrc 232;2321;2327
  - Delete groups - -setgrc
- The first group entry is also the master group

APP version 4.15
Country code selection
Group Call (GRC) group selection

2024-05-20 4.32e

Check source/destination calls with REGEX (logical checksum for APRS headers)
Group chat (Group Communication Protocol GCP)
Set region selection for modulation and frequency presets with country identifier
"-setctry xx" ... xx [EU, UK, US, VR2, 868, 915]
WEBServer: Group input for GCP inserted, Home-Group, 5-Listener-Groups
WEBServer: Region input in SETUP added

2024-04-27 4.32d

WiFi now also switchable as WiFi AP
"-setwifiap on/off", SSID, PWD are taken from the set values -setssid and -setpwd taken from
Version# including SUB info "a-z" is transferred to the server dashboard
Note: also update the gateways to 4.32d

2024-04-21 4.32c

RAK 13002 Port extension
New user button function
- onetime press...display on/off and forwarding of the last received messages
- double press...sendpos/sendtrack depending on track mode
- tripple press...Track on/off
MCP 23017 I2C port extender 16 I/O with internal 100k pull-up resistor
WEBService - New TAB MCP-STATUS. Remote control of the I2C port extension MCP 23017

2024-04-07 4.32b

WEBService - Various masks/field customizations
WEBService - New TAB LoRx-RX LOG

2024-04-04

DM calls and ACK messages are not filtered correctly - fixed
WEBServer directly from the node - see extra documentation
mDNS service for locating the WEB server
Server delivers incorrect UTC after daylight saving time changeover - fixed

2024-03-28

UTC offset value is not written to flash (ESP32). fixed
T-BEAM SoftRF T22_V1.1 AXP192 power management chip cannot be controlled via I2C - work around
DM to WLNK-1 and APRS2SOTA via gateway - ACK message directly from gateway to node
T-BEAM combined both AXP chip variants (AXP192 and AXP2101) in one firmware. Hardware ID different
Compilation for case sensitive OS - fixed (OE1KHZ)

2024-03-17

Merging the gateway function for RAK modules with ETH hardware
Automatic RECONNECT of RAK modules with gateways via ETH hardware after server failure
Messages from the node to the APP are provided with a timestamp of the creation
- The APP can then display these messages at the correct time when called up later
MHeard of the own node is no longer sent to the APP
MHeard calculates the distance of the node neighbors heard to your own node and displays it
MHeard is passed to the APP when connecting for the first time to display current information
UTC offset was introduced so that the time display on the node is local time (LT)
The current time is sent from the smartphone to the node after a connect. This means that the timestamp is immediately available
The first messages after a reconnect of the APP to the node are transmitted by the node with a slight delay so that the BT stack is fully established
The information from the node to the APP is transferred in Json format and sent with a time interval
APRS/EMAIL using WLNK-1 commands (documentation on winlink.org) can be sent via LoRa
- with WLNK-1 registration, mail retrieval, SMS short messages and email sending are possible
From 4.30, the message ID consists of 10-bit MAC (LSB) + 6-bit sequential number 0-999
LoRa position does not send stable weather values from the sensors so that the telemetry graphic display is not disturbed
If no TRACK is activated, the node module also sends the POS at least every 3 minutes via the MeshCom frequency (if this has changed)
APP: The smartphone/tablet time is sent when connecting to the node during reconnect
ESP32 DisplayWaitTimer adjusted for a text message
Display of own IP address in info call if gateway is activated

2023-12-31

Firmware MC 4.29h
Fixed - Pixel on the right edge when using the 1.3″ OLED display
-

2023-12-08

Firmware MC 4.29a
BMP/BME280, OneWire temperature measurement
- Values now also with a negative sign
BME680 - new I2C sensor
CU-811 - new I2C sensor with CO2
Fixed - LAT/LON /N/S/W/E also in the transfer to the APP (new APP required)
UTC Time Offset
- new command -utcoff +/-99.9
- This uses the time received from the GPS to get the local time for the display
RAK Firmware
- OTA-BLE update via Nordic Connect and DFU app
- Onewire sensor via RAK13002 I/O board
- BME680 Sensor RAK1906

2023-12-09
Firmware MC 4.29b

-utcoff +/- 99.9 activated (UTC offset to local time)
-showi2c activated for RAK
-680 on/off activated for all modules

2023-12-12

Firmware MC 4.29c / prerelease

if TRACK ON and APP are connected via BLE, the positions are also transmitted to the APP
if TRACK ON then a current position is also sent via MeshCom every 20 minutes

2023-06-20

Firmware MC 4.23
new there is only one firmware which can run as client or gateway. Only for RAK modules, which have an ETH socket as module, there is an own gateway firmware
- How to activate a gateway?
  - first set the callsign -setcall xx0xxx-12
  - dann den SSID-Code des erreichbaren WLAN-Netzes setzen — setssid <WlanSSID>
  - dann das Password für den WLAN-Zugriff setzen ..setpwd <WlanPWD>
  - after approx. 10 sec. the module restarts automatically
- Which new commands (see also Command list) are there?
  - -gps on/off (please set again after a firmware flash)
  - -button on/off activates the request for a user button. If none is available please leave disabled
  - -setinfo on/off by default the display of received and transmitted LoRa packets is not active. This makes it easier to edit the basic configuration.
  - -wx if BME280/BMP280 chip is present, -wx displays the current values
  - -track on The display shows in detail the GPS data (module must be present).
    - New is the display of#
      - Indication whether a "fix" has been reached. The values become usable only after a fix
      - Number of visible satellites
      - HDOP gibt die Genauigkeit der empfangenen GPS-Daten an eine Zahl < 500 ist anzustreben
      - The direction and distance traveled since the last GPS O point detected.
- BME/BMP208 with
  - -bme on or bmp on enable
  - -bmx off disables the module
- New function flow for better detection of MeshCom packet collisions
- Various minor firmware improvements
- Instructions for activating new hardware add-ons

2023-06-06

Firmware CL 4.21
new GPS with external module now also at:
- HELTEC V2 and V3 and EBYTE_E22 prepared.
- HELTEC V2/V3 RX of UBLOX connected to PIN 36 and TX connected to PIN 37.
- E22 with TX 17 and RX 16
- Hint: Please activate the UBLOX module with "- - gps on".

2023-05-30

Firmware CL 4.20
- new GPS SmartBeaconing
  - The default repetition rate for GPS positions is 30 minutes.
  - When the location changes, the repetition rate is changed. The repetition rate in minutes for a distance traveled of:
    - 1 minute - up to 120 m in 10 sec
    - 2 minutes - up to 420 m in 10 sec
    - 3 minutes - up to 1100 m in 10 sec
    - 5 minutes above
  - Furthermore, an additional position message is sent if the direction changes by more than 15°.
- new Display positions
  - Direction in ° to the displayed callsign
  - Distance in km to the displayed callsign
- new User button on the T-Beam. The display shows up to four stored text messages per button operation. If no message is stored, the display is shown with its own information. Another button operation switches the display off (but is not stored permanently). If you leave a displayed message or the own information, the display of the incoming positions will be shown again after 30 seconds.
  - activate with -button on
  - disable with -button off

2023-05-27

Firmware CL 4.19
- new CL
  - TBEAM User Button
    After a short press on the middle button first
    - the last (up to three) text messages (most recent first) are displayed
    - after the last (stored) message the display is set to off
  - Time is shown second by second in the display as top line.
    The time is sent from MeshCom server to the mesh cloud every 5 minutes.
    Until the first reception of the server time is started at 00:00:00.
    When GPS is received, the time is synchronized to the GPS signal
- fixed CL
  - TBEAM Battery Volt/Proz improved

2023-05-24

Firmware CL 4.18 and GW 4.20
- fixed GW
  - display off is automatically set to off again after displaying a message
- fixed CL
  - Time indication in seconds on the display

2023-05-21

Firmware CL 4.17 and GW 4.19
- new CL & GW:
  - All LAT/LON only with 4 digits after the decimal point (also at DashBoard)
  - DM (Direct Message) !Important! CL & GW only from this version
- fixed GW:
  - Volt display
    - -info command
    - Display
  - Date/Time as CEST
  - -volt in flash memory
- fixed CL:
  - -display off into the flash memory
  - Start info remains on display for 5sec
  - Node parameters always on display at startup

2023-05-18

Firmware CL 4.16 and GW 4.17
- fixed:
  - BLE set to +9dBm again
  - TX Delay Variation BETA Test
  - Remove ACK from text

2023-05-17

Firmware CL 4.15 and GW 4.16
- fixed:
  - Time is continuously shown on displays with position info. The time is synchronized either via on-board GPS or according to a time message sent by the MeshCom server at 10-minute intervals.
  - REBOOT hold from
    - -display settings
    - -volt or -proz
  - FAVOR
    - -volt for display of the ACCU voltage in volts.
    - -proz additionally to show the indication of the ACCU charge in percent.
    - -help was supplemented with new commands
    - -maxv This can be used to enter the system-specific final landing voltage in volts. Thus the percentage calculation is referred to this value.
  - Display of -info adjusted for CL and GW.
  - Position is sent after reboot or power on after approx. 10 seconds so that the CL appears immediately in the dashboard.
- new:
  - Support of HELTEC-V3
  - Direct messages (DM) are acknowledged by the destination node in accordance with APRS (ACK). Messages to All (*) are acknowledged by the next gateway (ACK).
  - User Button
    - T-BEAM, HELTEC-V3 currently the function toggle display on/off (but is not stored in the flash). More functions in the next version.

2023-05-13

Firmware CL 4.14 and GW 4.15
- fixed:
  - HELTEC ESP32 GPS pins prepared for external connection
  - APRS protocol adapted for battery% and sea level in feet
  - Messages in aprs.fi complete again
  - Display on dashboard also complete again

2023-05-11

Firmware CL 4.12 and GW 4.13
- new:
  - Timer with sync via server timer message and/or sync from GPS
  - Display off GW node (--display off) switches the display off permanently
  - Display off CL-Node (--display off) switches the display off. Messages are displayed but after 30 seconds the display switches off automatically.
  - New commands:
    - --volt toggle display Batt-% or Batt-Volt on OLED display
    - --mheard (short --mh) Gives a list of LoRa nodes heard directly via HF.
    - --setdate so that the timer can be set to manual
      (Example: --setdate 2023-05-11 15:25:02)
    - --setnoinfo is used to import multiple command lines at once.
    - After entering --setcall, --setssid, --setpwd, --sethamnet and --setinet the autom. reboot is delayed (approx. 5 seconds).

- fixed:
  - New way of battery measurement
  - Various length checks
    - max. LoRa message with Path, Type, Message and FCS 255 byte
    - max. CallSign length 14 bytes
    - max. SSID, PWD 40 bytes))

Version history

2023-05-07

Firmware CL 4.11 and GW 4.12 in download:
- MAC address error (OE5ERN) fixed
- IPhone display in general CL-xxxx-OE1KBC-99
-Android display of RAK modules CL-xxxx-OE1KBC-99
-Android display of ESP modules CL-xxxx- (Rainer and I will try to trick the standard lib later)
-ESP32 BLE power adapted to RAK +9 dBM

2023-05-05

fixed:
BLE name length max. 8 chars - delete pairing entry once

2023-05-04

fixed:
ESP32 Client & Gateways ready for IPhone APP now with PINCODE 000000
New command "- -display off" ... display on client is switched off. But with the next text message it will be activated automatically
New command "- -display on" ... display on client will be switched on.
new:
Store&Forward to the APP - if the APP is not connected to the client, (only) the text messages are collected and will be delivered at the next CONNECT.

2023-05-03

- fixed
ESP32 client & gateways ready for IPhone APP
GPS repetition CL&GW set to 30 minutes (dynamic follows)
New command "- -reboot

2023-04-27

- new Time is now displayed as CEST
- fixed GPS module support for various UBLOX modules

2023-04-24

- new
Client FW version is sent in the log

2023-04-22

- Fixed
BLE name shorter
minor adjustments

History client firmware

2023-05-07
Firmware CL 4.11 and GW 4.12 in download:
- MAC address error (OE5ERN) fixed
- IPhone display in general CL-xxxx-OE1KBC-99
-Android display of RAK modules CL-xxxx-OE1KBC-99
-Android display of ESP modules CL-xxxx- (Rainer and I will try to trick the standard lib later)
-ESP32 BLE power adapted to RAK +9 dBM

2023-05-05
fixed: BLE max. 8 chars - delete pairing entry once
new: - -display on/off

2023-05-03
- fixed
ESP32 client & gateways ready for IPhone APP
GPS retry CL&GW set to 30 minutes (dynamically follows)
ESP32 WiFi auto reconnect time in 5 wait time levels 30,60,90,120,150 seconds therefore max. wait time for a reconnect 150 seconds
New command "- -reboot

2023-04-29
- new get SSID &b PWD via APP
- fixed DHCP now stable in slow switches

2023-04-28:
- new Settings:
-reboot to restart the gateway
-all to show text and position messages on the display
-msg only text messages are shown on the display
- fixed restart after -setssid and -setpwd but without autom. change of settings

2023-04-27:
- new Time is now displayed as CEST
- fixed GPS module support for various UBLOX modules
- fixed restart after -setssid command does not hang anymore

2023-04-24:
- new
Gateway FW version is sent in the log

2023-04-23
- fixed
GW now also sends messages received from the server to the SmartPhone APP

2023-04-23:
- Fixed
All UDP, LoRa RX,TX messages are shown on the display, no hold time for TX messages.
Firmware version is shown on display and transmitted to DashBoard
Erroneous double transmissions to LoRa removed

2023-04-22:
- Fixed
ESP32 receiving messages now correct
ALL If gateway is used as node. Display of server transmission (cloud with hackerl) now OK.

- new commands
"- -sethamnet" uses HAMNET IP for the server
"- -setinet" uses I-NET IP for the server (default)