跳至主要内容

Advantech EdgeHub Suite for Windows Release Notes

July 19, 2024

Please read this document carefully. It includes late-breaking information about Advantech EdgeHub Suite for Windows.

Version Information​

[Download the latest release from GitHub](https://github.com/Advantech-IIoT/edgehub-suite/releases)

### V1.4.7 (2024/07/19)
* Upgrade Advantech EdgeHub Device Agent to 1.5.8
  - Add mass deployment (bootstrap server) support
  - Add API: PUT /edgehub/api/bootstrap/config
  - Replace "localhost" with "127.0.0.1"
  - Register service by mDNS with name: "_edgehub._tcp.local"
  - Mass deployment bootstrap client skip self-signed certificate automatically
  - Set QoS to 1 to support iothub GWV2
* Upgrade Advantech Platform Portal Service to 1.4.0 (web portal version 1.4.0)
  - Add mess deployment (bootstrap setting) UI
  - Add remote desktop UI
  - Replace "localhost" with "127.0.0.1"
  - Try to create the device in "LOGIN TO EDGEHUB"
  - Get the EdgeHub station list online
* Upgrade Platform REST API Service to 1.3.3
  - Add remote desktop support
  - Add API: POST /platform/api/rdesk/config
  - Add WebSocket API: GET wss://[host:port]/platform/api/rdesk/:id
  - The Windows installer will install Winvnc 1.4.3.6 by default

### V1.3.4 (2023/10/27)

* Upgrade Advantech Authentication Service to 1.11.0
  - Update auth-server HTTPS port to 56443 to prevent conflicts with the Kubernetes API server
  - Upgrade Advantech EdgeHub Device Agent to 1.4.1
  - Add a protection mechanism to prevent multiple service instances from running simultaneously and improve overall stability.
  - Support detection of revoked certificates, enhancing security by promptly identifying potentially compromised connections.
  - Support real-time status updates of connection storms.
  - Support X.509 certificates to enhance security and authentication capabilities for secure communications.
  - Rename Edge365 to EdgeHub
* Upgrade Advantech Platform Portal Service to 1.2.0 (web portal version 1.2.2)
  - Update UI/UX to provide a more intuitive and visually appealing interaction.
* Add a full project to build an installer, including the WISE-Agent V1.4.45

### V1.1.6 (2023/07/07)

* Upgrade Advantech Edge365 Device Agent from 1.0.5 to 1.0.7
  - Upgrade MQTT broker to 2.2.12
  - Fixed the agent crash issue if the WISE-Agent was not installed
  - Complete the shutdown process when the AppHub and Wise-Agent services are force-stopped and disconnected (connection lost)
* Add a compact project to build an installer without including the AppHub

### V1.1.4 (2023/05/26)
* Upgrade Advantech Edge365 Device Agent to 1.0.5
  - Add AppHub config file manager
  - Add DeviceOn config file manager
  - Add Edge Bus service (Embedded MQTT Broker)
  - IoTHub MQTT using the host's CA set by default
  - Get AppHub location from registry instead of %PATH%
  - Update MQTT broker to 2.2.11
  - Fix Edge365 widget LED function detection error
  - Fix the issue of AppHub cannot reconnect to cloud MQTT when the EdgeBus is turned off
  - Fix the typo bug of the command line (service uninstall usage)
* Upgrade Advantech Platform Portal Service to 1.0.1 (web portal version 1.0.3)
  - Add functions of Services, Terminal, Display On/Off, and Edge365 Setting UI
  - Fix the typo bug of the command line (service uninstall usage)
* Upgrade Platform REST API Service to 1.0.3
  - Add OS Service APIs
  - Add Web Terminal APIs
  - Add Display On/Off APIs
  - Add Linux LED support
  - Fix GPIO-related APIs panic issue
  - Fix the typo bug of the command line (service uninstall usage)
* Upgrade Authentication Service from to 1.9.1
  - Fix the typo bug of the command line (service uninstall usage)
* Upgrade Advantech EdgeX Helper to 1.0.1
  - Fix the typo bug of the command line (service uninstall usage)

### V1.0.9 (2023/04/27)

* Upgrade Advantech Edge365 Device Agent from 0.17.1 to 1.19.1
  - Disable DeviceOn iBMCPlugin by default
  - Refine AppHub config file management
  - Upgrade the MQTT library to 1.4.2
  - Fixed goroutine leak issue
  - Disable the AppHub log file and set the log level to “error” by default to manipulate the config file directly
  - Convert tags of model name to the profile
* Upgrade Advantech Platform Portal Service from 0.18.1 to 0.18.2 (web portal version 0.17.2)
  - Get rid of the BI station
  - Redirect to the current route after re-login
  - Add desktop shortcut
* Upgrade Platform REST API Service from 0.19.1 to 0.21.1
  - BIOS version from EAPI/SUSI API, version from SMBIOS Type 0 only if there is no EAPI/SUSI API
  - Use windows.NewLazySystemDLL to prevent DLL hijacking
  - To minimize the lock scope and refine resource protection to avoid race condition
  - Support lock screen screenshot
  - Support NVRAM disk direct access mode
  - Call EApiLibInitialize once to avoid the crash and check the EAPI function pointer before calling to avoid panic
* Upgrade AppHub-Edge from 1.0.12 to 1.1.6
  - Add option to enable/disable log file
  - Add option to set up log level to display as an error or info

### V1.0.7 (2022/12/23)

* Support remote shutdown and restart of the target device.
* Support AppHub-Edge Windows version
* Add a Dashboard webpage that summarizes system information and a WISE-Edge365 widget.
* Add a Disk webpage that provides an overview of disks, including model name, size, partition list, usage, and S.M.A.R.T. information(if available).
* Add a Process Monitor webpage that provides information about running processes and could search or kill these processes.
* Add a Networking webpage that allows users to monitor network adapters.
* Add a Trap Receiver webpage that receives the SNMP Traps and the Variable Bindings.
* Add EdgeX webpage that serves between physical sensing and actuating "things" and our information technology (IT) systems.
* Add Settings webpage that supports DeviceOn/BI and WISE-Edge365 Connection.

## Software Package List

* Advantech EdgeHub Suite 1.4.7
  * Advantech Authentication Service 1.11.0
  * Advantech EdgeHub Device Agent 1.5.8
  * Advantech Platform Portal Service 1.4.0 / web portal-potal 1.4.0
  * Advantech Platform REST API Service 1.3.3
  * AppHub-Edge 1.1.6 (Windows)
* Advantech EdgeHub Suite Compact 1.4.7 (* without AppHub)
  * Advantech Authentication Service 1.11.0
  * Advantech EdgeHub Device Agent 1.5.8
  * Advantech Platform Portal Service 1.4.0 / web portal-potal 1.4.0
  * Advantech Platform REST API Service 1.3.3
* Advantech EdgeHub Suite Full 1.4.7 (* including Wise-Agent)
  * Advantech Authentication Service 1.11.0
  * Advantech EdgeHub Device Agent 1.5.8
  * Advantech Platform Portal Service 1.4.0 / web portal-potal 1.4.0
  * Advantech Platform REST API Service 1.3.3
  * AppHub-Edge 1.1.6 (Windows)
  * Wise-Agent 1.4.45 (Windows only)

## Software Prerequisite

* AdvLmsensor V1.06.001 or later.
* AdvSNMPSubagent V2.0.000 or later (Option)
* AdvWDT V3.10.002 or later.
* Docker Desktop V4.13.1 or later. (Option, for EdgeX)
* PlatFormSDK V1.6.4 or later.

## OS support list

* Windows 10 1809(OS Build 17763)
* Windows 10 21H2(OS Build 19044)
* Windows 11 21H2(OS Build 22000)
* Windows 11 24H2(OS Build 26100)

## HW Validation list

* UNO-137-E1
* UNO-137_V2
* UNO-148
* UNO-2372G-J121AE
* UNO-2372G_V2
* UNO-238_V2
* UNO-2473G
* UNO-2484G-653xAE
* UNO-2484G_V2
* TPC-300-R87xA
* TPC-B520
* PPC-6151C-7760

## Notes

* Installation Steps
  * Run **Advantech EdgeHub Suite_x.y.z.exe** as administrator to install all packages.
    After the installation is complete, you will find packages in these folders:
    * Advantech Authentication Service: C:\Program Files\Advantech\auth-server
    * Advantech EdgeHub Device Agent Service: C:\Program Files\Advantech\edgehub-agent
    * Advantech Platform Portal Service: C:\Program Files\Advantech\portal-service
    * Advantech Platform REST API Service: C:\Program Files\Advantech\rest-server

## Important Features

* Advantech Platform Portal
  Advantech Platform Portal is a device management and debugging tool that lets you configure and manage device settings and view diagnostic information over HTTP from a web browser.

* Web Browser Support
  Suggest using Google Chrome in the desktop version. (Internet Explorer is not supported)

* Login password & setting
  Login Advantech Platform Portal with the following:

  * OS Account
  * Admin Account (must change the password on the first login)
    Username: **admin**
    Password: **p@ssw0rd**

  Advantech Platform Portal, login time session is limited to 15 mins.  During this period user has modification right.

* Certificate
  Under the same domain, the client can connect to the server through a web browser using HostName. URL: "`https://{IP address of the desktop}:17443"`

* EdgeHub
  Support enabling and disabling the connection to the EdgeHub station.

* REST API
  All Platform Portal functionality is built on REST APIs that developers can call directly to access resources and control their devices programmatically.
  
## Checksum Information

Filename | MD5 | CRC32 | SHA-256 | File Size |
-------- | -------- | -------- | -------- | -------- |
Advantech EdgeHub Suite_1.4.7.exe|2e22e4bd88c55dce1b293915603f01ae|b374463a|300bf26712d2801c2bfa9cad2e6d761a93d11fb0ad06c9dd2ed96697fea5b8ff|74,755,896 |
Advantech EdgeHub Suite Compact_1.4.7.exe|c726312919a718528de798acc15562c7|eb8c349a|2051504c8c16c7fa231667b78dfd4193baed4dfd58eb88eed6bac8f2cd4bd633|31,404,096|
Advantech EdgeHub Suite Full_1.4.7.exe|fb02599f53808c62c7a62184a2d4a281|ec4cd02a|adfd93caf2b6a47de03217e5b52f22792fd9d953929e11943e90fe04408915c1|188,876,440|

# Advantech EdgeHub Suite for Linux Release Notes

July 19, 2024

Please read this document carefully. It includes late-breaking information about Advantech EdgeHub Suite for Linux.

## Version Information

[Download the latest release from GitHub](https://github.com/Advantech-IIoT/edgehub-suite/releases)

### V1.4.7 (2024/07/19)

* Upgrade Advantech EdgeHub Device Agent to 1.5.8
  * Add mass deployment (bootstrap server) support
  * Add API: PUT /edgehub/api/bootstrap/config
  * Replace "localhost" with "127.0.0.1"
  * Register service by mDNS with name: "_edgehub._tcp.local"
  * Mass deployment bootstrap client skip self-signed certificate automatically
  * Set QoS to 1 to support iothub GWV2
* Upgrade Advantech Platform Portal Service to 1.4.0 (web portal version 1.4.0)
  * Add mess deployment (bootstrap setting) UI
  * Add remote desktop UI
  * Replace "localhost" with "127.0.0.1"
  * Try to create the device in "LOGIN TO EDGEHUB"
  * Get the EdgeHub station list online
* Upgrade Platform REST API Service to 1.3.3
  * Add remote desktop support
  * Add API: POST /platform/api/rdesk/config
  * Add WebSocket API: GET wss://[host:port]/platform/api/rdesk/:id
  * The Linux installer will try to install the VNC server by the system package manager

### V1.3.4 (2023/10/27)

* Upgrade Advantech Authentication Service to 1.11.0
  - Update auth-server HTTPS port to 56443 to prevent conflicts with the Kubernetes API server
  - Upgrade Advantech EdgeHub Device Agent to 1.4.1
  - Add a protection mechanism to prevent multiple service instances from running simultaneously and improve overall stability.
  - Support detection of revoked certificates, enhancing security by promptly identifying potentially compromised connections.
  - Support real-time status updates of connection storms.
  - Support X.509 certificates to enhance security and authentication capabilities for secure communications.
  - Rename Edge365 to EdgeHub
* Upgrade Advantech Platform Portal Service to 1.2.0 (web portal version 1.2.2)
  - Update UI/UX to provide a more intuitive and visually appealing interaction.

### V1.1.6 (2023/07/07)

* Upgrade Advantech Edge365 Device Agent from 1.0.5 to 1.0.7
  - Upgrade MQTT broker to 2.2.12
  - Fixed the agent crash issue if the WISE-Agent was not installed
  - Complete the shutdown process when the AppHub and Wise-Agent services are force-stopped and disconnected (connection lost)
* Add a compact project to build an installer without including the AppHub

### V1.1.4 (2023/05/26)

* Upgrade Advantech Edge365 Device Agent to 1.0.5
  * Add AppHub config file manager
  * Add DeviceOn config file manager
  * Add Edge Bus service (Embedded MQTT Broker)
  * IoTHub MQTT using the host's CA set by default
  * Get AppHub location from registry instead of %PATH%
  * Update MQTT broker to 2.2.11
  * Fix Edge365 widget LED function detection error
  * Fix the typo bug of the command line. (service uninstall usage)
  * Fix the issue of AppHub cannot reconnect to cloud MQTT when the EdgeBus is turned off
* Upgrade Platform REST API Service to 1.0.3
  * Add OS Service APIs
  * Add Web Terminal APIs
  * Add Display On/Off APIs
  * Add Linux LED support
  * Fix GPIO-related APIs panic issue
  * Fix the typo bug of the command line. (service uninstall usage)
* Upgrade Advantech Platform Portal Service to 1.0.1 (web portal version 1.0.3)
  * Add functions of Services, Terminal, Display On/Off, and Edge365 Setting UI
* Fix the typo bug of the command line. (service uninstall usage)
  * Upgrade Advantech EdgeX Helper to 1.0.1
* Fix the typo bug of the command line. (service uninstall usage)
  * Upgrade Authentication Service to 1.9.1
* Fix the typo bug of the command line. (service uninstall usage)

### V1.0.9 (2023/04/28)

* Upgrade Advantech Edge365 Device Agent from 0.17.1 to 0.19.1
  * Convert tags of model name to the profile
  * Disable the AppHub log file and set the log level to “error” by default to manipulate the config file directly
  * Disable the deviceon iBMCPlugin by default
  * Fixed goroutine leak (client->reconnect)
  * Refine AppHub config file management
  * Upgrade MQTT library to 1.4.2
* Upgrade Advantech Platform REST API Service from 0.19.1 to 0.21.1
  * Call EApiLibInitialize once to avoid the crash, and check the EAPI function pointer before calling to avoid panic.
  * To minimize the lock scope and refine resource protection to avoid race condition
* Upgrade Advantech Platform Portal Service from 0.14.1 to 0.17.2
  * Get rid of the BI station.
  * Redirect to the current route after re-login.
  * Upgrade AppHub-Edge from 1.0.12 to 1.1.3
  * Add option to enable/disable log file.
  * Add option to set up log level to display as error or information.

### V1.0.7 (2022/12/23)

* Support running on amd64, arm64 and armhf platforms.
* Support remote shutdown and restart of the target device.
* Support AppHub-Edge Linux version.
* Support WatchDog function.
* Add a Dashboard webpage that summarizes system information and a WISE-Edge365 widget.
* Add a Disk webpage that provides an overview of disks, including model name, size, partition list, usage, and S.M.A.R.T. information(if available).
* Add a Process Monitor webpage that provides information about running processes and could search or kill these processes.
* Add a Networking webpage that allows users to monitor network adapters.
* Add a Trap Receiver webpage that receives the SNMP Traps and the Variable Bindings.
* Add EdgeX webpage that serves between physical sensing and actuating "things" and our information technology (IT) systems.
* Add Settings webpage that supports DeviceOn/BI and WISE-Edge365 Connection.

## Software Package List
* Advantech EdgeHub Suite 1.4.7
  * Advantech Authentication Service 1.11.0
  * Advantech EdgeHub Device Agent 1.5.8
  * Advantech Platform Portal Service 1.4.0 (Portal: 1.4.0)
  * Advantech Platform REST API Service 1.3.3
  * AppHub-Edge 1.1.3 (Linux)
* Advantech EdgeHub Suite Compact 1.4.7 (without AppHub)
  * Advantech Authentication Service 1.11.0
  * Advantech EdgeHub Device Agent 1.5.6
  * Advantech Platform Portal Service 1.4.0 (Portal: 1.4.0)
  * Advantech Platform REST API Service 1.3.3

## OS support list
* amd64
  AdvLinuxTU_x64_V3.4.1
  AdvLinuxTU-IOTG_V4.0.4
* arm64
  AdvRaspbian_V1.0.2_arm64
* armhf
  wise710a1-ubuntu1804-v2.0.6
  wise710a1-2g-ubuntu1804-v2.0.6

## HW Validation list
* amd64
  UNO-137-E1
  UNO-148
  UNO-348
  UNO-2372G-J121AE
  UNO-2484G-653xAE
  UNO-2484G-673xAE
  UNO-2484G_V2
* arm64
  UNO-220
* armhf
  WISE-710

## Notes

* Installation Steps
  1. Untar edgehub-suite_x.x.x_linux-[amd64|arm64|armhf].tar.gz
     `tar zxvf edgehub-suite_x.x.x_linux-[amd64|arm64|armhf].tar.gz`
  2. Apply executable permissions to **install.sh** and run **install.sh** as root privilege to install all packages.
     ```shell
     cd edgehub-suite_x.x.x_linux-[amd64|arm64|armhf]

sudo chmod +x install.sh sudo ./install.sh


After the install is done, you will find the packages are these folders:
* Advantech Authentication Service: /opt/auth-server
* Advantech EdgeHub Device Agent Service: /opt/edgehub-agent
* Advantech Platform Portal Service: /opt/portal-service
* Advantech Platform REST API Service: /opt/rest-server

* The following functions are not supported on the **Advantech Platform Portal** of the Linux version.
* System Devices
* Networking - StaticIP Setting
* Networking - WiFi
* Networking - Routing
* Application Monitor

## Important Features

* Advantech Platform Portal
Advantech Platform Portal is a device management and debugging tool that lets you configure and manage device settings and view diagnostic information over HTTP from a web browser.

* Web Browser Support
Suggest using Google Chrome in the desktop version. (Internet Explorer is not supported)

* Login password & setting
Login Advantech Platform Portal with the following:

* OS Account
* Admin Account (must change the password on the first login)
Username: **admin**
Password: **p@ssw0rd**

Advantech Platform Portal, login time session is limited to 15 mins.  During this period user has modification right.

* Certificate
Under the same domain, the client can connect to the server through a web browser using HostName. URL: "`https://{IP address of the desktop}:17443"`

* EdgeHub
Support enabling and disabling the connection to the EdgeHub station.

* REST API
All Platform Portal functionality is built on REST APIs that developers can call directly to access resources and control their devices programmatically.

## Known Issues

* GPIO
#30327 The device with EC driver will be popping the error message "GPIOGetDirection/GPIOGetLevel: This function or ID is not supported at the actual hardware environment".
#32477 The GPIO function does not suppot UNO-2484G_V2/UNO-1372G-E3AE and it will be fixed at next AdvLinuxTU image.
* Hardware Monitor
#30362 The temperature value of WISE-710 is wrong on Platform Portal and it will be retrieved at next release.
* LED
#32873 The LED function does not support and it will be fixed at next AdvLinuxTU image.
* System
#32414 The model name is not displayed correctly on Platform Portal.
#30649 After Install edgehub-suite, the WISE-710 device will reboot repeatedly and it will be retrieved at next release.
* WatchDog
#30368 After enabling WDT on Platform Portal, the device WISE-710 will be popping the error message "failed to enable WDT inappropriate ioctl for device" and it will be retrieved at next release.
#30576 After setting WDT timeout value on Platform Portal, the device UNO-220 will be popping the error message "ffailed to update WDT timeout: invalid argument" because UNO-220 does not support set timeout function.

## Checksum Information

| Filename | MD5 | CRC32 | SHA-256 | File Size |
| -------- | -------- | -------- | -------- | -------- |
edgehub-suite_1.4.7_linux-amd64.tar.gz|24765439823c2dd6040ce7193aa120dd|b4faa234|12bd32164b818632cb5bce062047174a9f4b73f52e4643a69d7c50c1acd04aac|92,296,935|
edgehub-suite_1.4.7_linux-arm64.tar.gz|b87f4b28e3caf2b984535a0f7c98852f|17e49012|f7c00e6e2fd978ea9bb3cb83be7bf6528520672b346e86b4f8737de00053a10a|89,910,894|
edgehub-suite_1.4.7_linux-armhf.tar.gz|e73f4ef8486ebcb21ba70951b9cb4dab|8fd05167|d073c2e23aae656e490cc715535b3de4dc4dec14076720ab01b8df8ae3a10b9e|90,831,184|
edgehub-suite-compact_1.4.7_linux-amd64.tar.gz|8471f1377e285e0d3f9f19ee96866681|d0b0e78a|ebef64ed61c2d5d81bed8bb05677a1044eabc4a433d1193c59c8b9152fc85ca5|28,347,325|
edgehub-suite-compact_1.4.7_linux-arm64.tar.gz|a16216f17939e7d94a0600893e27687e|622794ca|d9fe8eb1c4b1bf91887f7097cca15e73a078b2f4dab13ebe652692a831e78096|25,962,846|
edgehub-suite-compact_1.4.7_linux-armhf.tar.gz|90fb99d99cc8ce6820b26f7610c915bc|db2e3be1|

On this page ...

Is this helpful?