Skip to content

Commit bcd14db

Browse files
committed
Content update (firmware update, maintenance)
1 parent 2add5f8 commit bcd14db

File tree

3 files changed

+200
-24
lines changed

3 files changed

+200
-24
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,180 @@
1+
Readme:
2+
3+
==================================================================================
4+
Note: WisGateOS 2 is available only for version 2 WisGate Edge gateways.
5+
The supported models are:
6+
7+
WisGate Edge Pro version 2: RAK7289V2, RAK7289CV2, RAK7289V2H, RAK7289CV2H
8+
9+
WisGate Edge Lite 2 version 2: RAK7268V2, RAK7268CV2, RAK7268V2H, RAK7268CV2H
10+
11+
WisGate Edge Prime version 2: RAK7240V2, RAK7240CV2, RAK7240V2H, RAK7240CV2H
12+
13+
==================================================================================
14+
15+
16+
====================WisGateOS 2 v2.2.2====================
17+
February 27, 2024
18+
19+
IMPORTANT UPDATE NOTICE:
20+
- The WisGateOS2 firmware has been updated significantly. After this update, it is no longer possible to revert to previous versions of WisDM or the local WebUI. All WisGateOS2 2.2.x extensions are digitally signed. During this process, extensions will automatically update. Contact RAK support before updating the WireGuard Extension.
21+
- An internet connection is mandatory for the update process. This is because the new firmware signature needs to be confirmed, and the Extension Gallery should be accessible to update the already installed extensions.
22+
23+
New Features:
24+
- Upgraded OpenWRT to version 2102 to enhance system security and reliability.
25+
- Online extension updated with signature verification.
26+
- Added Chinese Language support in gateway UI.
27+
- Display syslog in sequence in gateway UI for download.
28+
- Now supports spaces in ESSID.
29+
- TDOA support in gateway UI.
30+
- ChirpStack V4 (MQTT Bridge) integration.
31+
- WisDM agent updated to v1.2.5 to allow adding gateways in Basics Station mode without erasing individual keys.
32+
- Support Client ID for user to fill in when the gateway works in Build-in NS mode.
33+
34+
Fixed bugs:
35+
36+
WisGateOS2 related
37+
• Checks PF-UDP server address inaccurately.
38+
• No IP is assigned to the connected via the Wi-Fi AP device.
39+
• Safe Mode is activated if the reset button is pressed during the gateway reset procedure.
40+
• In UDP Packet Forwarder mode, the region number in the topic does not match the actual value.
41+
• In UDP Packet Forwardr mode, the topic sent to the Built-In NS is incorrect.
42+
• In Built-In NS mode, the value of maxEIRP in the "TxParamSetupReq" is wrong.
43+
• In Built-In NS mode, devices which statistical data have been viewed, will have wrong statistical data.
44+
• For RAK72xxV2/CV2, NO ETH LED after upgrading to WisGateOS2 2.2.1.
45+
• WisGateOS2.x OpenVPN lost the client configuration after firmware update.
46+
• For a gateways without LTE, If both ETH and FiWi are configured and ETH is with Priority 2, the ETH is still used as Primary.
47+
• Failed to add Trackit to gateway on WisGateOS2 2.2.0_b68.
48+
• When both Cellular and ETH connections are presented Wireguard fails to connect normally.
49+
• After update to WisGateOS2 2.2.x failed to install extension due to "wes" missing.
50+
• Slow loading of the gateway overview page when there's no 4G module.
51+
• Missing some mandatory channels for the RU864 region.
52+
• Loss of a customized logo after firmware upgrade.
53+
• When creating a gateway for the AS923 region on the TTN server, no frequency is assigned.
54+
• Errors encountered after connecting the gateway to AWS IOT Core/TTN.
55+
• Incomplete devEUI display in the subscribed topic when sending uplink data to the AWS server.
56+
• Slow gateway loading and status issues when adjusting the priority of one of the Multi-WAN networks.
57+
• Inability to receive confirm-ok data after a node sends uplink data via FSK or STD frequency.
58+
• Abnormal status of wan0 (apcli0) on the Multi-WAN page when Wi-Fi is set to static IP.
59+
• The ap_client process doesn't stop after changing Wi-Fi mode from AP STA to AP.
60+
• Specification requirement for the maximum payload size of downlink in the LoRaWAN protocol.
61+
• Gateway doesn't return a new channel plan after receiving an End Device's uplink data for regions KR920/AS923-1/AS923-2/AS923-3/AS923-4.
62+
• Built-in ns enters a dead loop when the MQTT client TLS version doesn't match the MQTT broker.
63+
• The gateway stops functioning normally after connecting to ChirpStack in BS mode for 2 days.
64+
• Connection failures to ChirpStack via TLS authentication in Basics Station mode.
65+
• Incorrect status information is displayed when the Ethernet protocol type is set to a static address.
66+
• Some extensions with added MD5 hash become unusable after upgrading to version 2.2.x.
67+
• MQTT password now supports a null value (no password).
68+
• LAN-Wi-Fi exhibits abnormalities after enabling WAN-Wi-Fi.
69+
• The previous client IP remains available after switching from AP + Client.
70+
• Abnormal status of wan0 (apcli0) on the Multi-WAN page when Wi-Fi is configured as a static IP.
71+
72+
73+
74+
75+
====================WisGateOS 2 v2.1.8====================
76+
September 15, 2023
77+
78+
Improvement and New Features:
79+
80+
• Beacon even in Basics Station mode is added to the system log
81+
• CA-certificates updated to 20230311 (Azure IoT root certs)
82+
• WisSM Agent updated to version 1.2.3
83+
• WiFi Password support space
84+
• WisSM Agent updated to version 1.2.4 fixing onboarding to WisDM error.
85+
86+
Fixed bugs:
87+
88+
• Failed to obtain the beacons from AWS IoT Core for LoRaWAN in Basics Station mode, Class B end devices
89+
• In case the end device/s sends uplink data every 3 seconds(too frequently), the gateway reports an error "ERROR: [up] failed packet fetch, exiting"
90+
• China cannot be selected on the "Change your country" page for CN470 gateways
91+
• ASS923 band only - After a node sends uplink data through FSK or STD frequency, it cannot receive confirm-ok data
92+
• The maximum payload size of the downlink should be specified in the LoRaWan protocol.
93+
• In Build-in server mode, AS923 band, downlink phy payload size larger than the max limit
94+
• The frame count stored in DB by NS is inconsistent after restarting the server.
95+
• In Basics Station mode, connected to Chirp Stack, an error failed to open COM port /dev/ttyACM0
96+
• NS mode, Adding "/" at the beginning when configuring the Downlink Topic in Integration Interface Parameters will cause an NS error.
97+
• Enhanced the NTP server synchronization function. Users requiring time stamps from the NTP server will experience improved accuracy, addressing previous issues with incorrect time stamp synchronization.
98+
• Fixed global integration topic. The update rectifies the issue of incomplete devEUI displays in the subscribed topic when transmitting uplink data and connecting to an AWS server.
99+
• Resolved an issue where the Packet Forwarder occasionally failed to initialize after starting the gateway.
100+
101+
102+
103+
104+
====================WisGateOS 2 v2.1.4====================
105+
March 24, 2023
106+
107+
New Features:
108+
• WisDM redirection in WisGateOS - a quick link to the WisDM is added to the WebUI footer.
109+
• Pre-Upgrade announcement - provides the most important release notes for the new firmware before the update from the WebUI.
110+
• Add "enable automatic data recovery" for Packet Forwarder mode.
111+
112+
Fixed bugs:
113+
• Downlinks are rejected by the forwarder sometimes.
114+
• The Built-in NS will fall in an infinite loop when the MQTT client tls version does not match the MQTT-broker.
115+
• If using the AWS IoT MQTT client to get 64 bytes uplink data, failed to get the data if the data is more than 64 bytes.
116+
• Basics Station won't connect to Actility NS after the gateway is rebooted.
117+
• Default ping interval field setting to 10 minutes in MultiWAN.
118+
• The RSSI value of FSK channel data displayed on the gateway exceeds the expected range.
119+
• 4G default Ping interval revised to reduce the SIM data consumption
120+
• In the AS923 band, after connecting to TTN, devices cannot join normally.
121+
• Support "-" or "_",”!” in the WiFi WAN/LAN password.
122+
• Timestamp report to Chirpstack the fineTimestampType is always"NONE".
123+
• Cellular connection can not be established after reboot in some cases.
124+
• After configuring the whitelist, the parameters do not take effect
125+
• Packet Filter, White List, and Network ID cannot be set to 0
126+
• Basics Station can not start successfully in some cases.
127+
• Support config Json type(array/object) auto-detection for sx1302
128+
• Logic error causes Packet Forwarder to keep restarting
129+
• MAC Commands with uplink are not displayed in the gateway packet capture.
130+
• After setting the SSL/TLS Mode to Self-signed server & client certification and configuring the certificate, the process is with abnormal behavior
131+
132+
Coming soon:
133+
WisGateOS2.2
134+
• Chinese Language support in UI.
135+
• OpenWRT 2102.
136+
• Syslog display in sequence
137+
• Online extension Gallery.
138+
139+
140+
141+
====================WisGateOS 2 v2.1.2====================
142+
January 13, 2023
143+
144+
Improvement and New Features:
145+
146+
• Support full-duplex for RAK7289V2/RAK7289CV2 Full Duplex gateway.
147+
• Fix Join and connection issue with TTN
148+
• Fix Rejected downlinks by the forwarder in some cases.
149+
• Fix BasicsStation backup of the certificates issued.
150+
151+
152+
====================WisGateOS 2 v2.1.1====================
153+
October 18, 2022
154+
155+
Improvement and New Features:
156+
157+
• Support LBT feature. Country settings Extension.
158+
• Fix statistics lost in the AWS IoT Core connection scenario.
159+
• Fix BasicsStation reconnect issues in case of LTE failure.
160+
• Fix the RSSI value issue in the RU864 band.
161+
162+
163+
====================WisGateOS 2 v2.1.0====================
164+
September 13, 2022
165+
166+
Improvement and New Features:
167+
• WisDM agent update
168+
• RSSI statistics fix
169+
• Breathing Light(RAk7268V2/RAK7268CV2) fix
170+
• Support for LBT extension/Country settings
171+
172+
====================WisGateOS 2 v2.0.1====================
173+
June 10, 2022
174+
175+
176+
Improvement and New Features:
177+
• UI/UX Improvements - Redesigned UI for a great experience with Responsive Design for quick and easy gateway configuration and monitoring.
178+
• Extensions - Extensions allow adding more features and tools to the WisGateOS2. Available extensions are available here https://docs.rakwireless.com/Product-Categories/Software-APIs-and-Libraries/WisGateOS-2-Extensions/
179+
• Support the latest OpenSSL version 1.1.1.
180+
• Improved security and performance (Optimized TSL handshake, new encryption algorithm, attack security improvement).

content/hardware/05.pro-solutions/solutions-and-kits/wisgate-edge-lite-2/tutorials/update-firmware/content.md

+20-24
Original file line numberDiff line numberDiff line change
@@ -15,61 +15,57 @@ This tutorial will show you how to update the firmware of your **WisGate Edge**
1515

1616
## Goals
1717

18-
The goals of this article are:
18+
The goals of this tutorial are the following:
1919

20-
- Download the latest Firmware version.
21-
- Connect to the Gateway
22-
- Open the dashboard panel
23-
- Upload the new version
20+
- Download the latest firmware version for the Wisgate Edge gateway
21+
- Install the latest firmware version on the Wisgate Edge gateway
2422

25-
## Hardware & Software Needed
23+
## Hardware and Software Needed
2624

2725
- [WisGate Edge Pro or WisGate Edge Lite 2](https://store.arduino.cc/pages/wisgate-lora-gateways)
2826

2927
## Requirements
3028

31-
We assume that you already connected the gateway to your local network, and you can connect to it using your favorite method.
32-
33-
You can check out the needed steps on the [Getting Started tutorial](../getting-started/).
29+
In this tutorial, we assume that you have already connected the gateway to your local network and that you can access it using your preferred method. Please refer to the [Getting Started with WisGate Edge Gateway Devices tutorial](../getting-started/) for detailed guidance.
3430

3531
## Instructions
3632

3733
### Download the Latest Firmware Version
3834

39-
To update the firmware of your product click here to download the [**Latest Firmware Version**](https://content.arduino.cc/assets/WisGateOS_2.1.8_ARDUINO_b108_RAK636.zip).
35+
To update your product's firmware, click here to download the [**latest firmware version**](assets/WisGateOS_2.2.2_ARDUINO_RAK.zip). You will receive a ZIP file named `WisGateOS_<version>_ARDUINO_RAK.zip`. Unzip this file to extract the required firmware files.
4036

41-
You will get a zip file called `WisGateOS_<version>_ARDUINO_RAK.zip`. Unzip it and you will have the required firmware files.
37+
***The latest version of the WisGate Edge Gateway devices is 2.2.2; download the release notes [here](assets/Release_Notes_WisGateOS_2.2.2_ARDUINO_RAK.txt).***
4238

4339
### Connect to the WisGate Dashboard
4440

45-
There are different ways to access the WisGate (default values):
41+
There are several methods to access the WisGate dashboard (using default values):
4642

47-
* Connecting to its Wi-Fi® Access Point (dashboard IP: `192.168.230.1`)
48-
* Ethernet cable from your Computer to the Gateway (dashboard IP: `192.168.230.1`)
49-
* Connecting your Gateway to your LAN, getting its DHCP IP (You will need to discover the device's IP)
43+
* Connecting via the Wi-Fi® Access Point of the device (Dashboard IP: `192.168.230.1`)
44+
* Use an Ethernet cable to connect your computer directly to the gateway (Dashboard IP: `192.168.230.1`)
45+
* Connect the Gateway to your LAN and obtain its DHCP IP address (You will need to discover the device's IP)
5046

5147
![WisGate dashboard](assets/wisgate-dashboard-overview.png)
5248

5349
### Upload the Firmware
5450

5551
On the WisGate Dashboard, open the Settings page and click on the "Firmware" tab.
5652

57-
![WisGate dashboard Settings page](assets/wisgate-firmware-settings.png)
53+
![WisGate gateway dashboard settings page](assets/wisgate-firmware-settings.png)
5854

59-
Now drag and drop or open the browse file option to select the firmware file downloaded in the previous step, it is the file with the `.bin.rwi` format, as you can see in the screenshot.
55+
Now, drag and drop or open the browse file option to select the firmware file downloaded in the previous step. As you can see in the image below, it is in `.bin.rwi` format.
6056

61-
![WisGate firmware zip uploaded](assets/wisgate-firmware-update.png)
57+
![WisGate firmware file uploaded to the gateway](assets/wisgate-firmware-update.png)
6258

6359
### Flash the Firmware
6460

65-
Click update and you will flash the gateway with the new firmware version.
61+
With the latest firmware uploaded, now click on the "Update" button. This will flash the new firmware to your gateway.
6662

67-
***To not erase the settings remember to check the box "Keep settings after updating"***
63+
***Remember to check the box "Keep settings after updating" not to erase your gateway's settings***
6864

69-
![WisGate firmware flashing](assets/wisgate-firmware-flashing.png)
65+
![WisGate new firmware flashing process](assets/wisgate-firmware-flashing.png)
7066

71-
After flashing the new firmware the gateway will reboot itself, it may be unavailable for some minutes.
67+
After flashing the new firmware, your gateway will reboot itself, and it may be unavailable for a few minutes.
7268

73-
## Next Step
69+
## Next Steps
7470

75-
Make sure to check periodically if your device is up-to-date to avoid bugs and security issues.
71+
Make sure to check periodically to see if your gateway has the latest firmware to avoid bugs and security issues.

0 commit comments

Comments
 (0)