GRANDSTREAM WP820 Wifi Provision via USB Phone User Guide
- June 6, 2024
- GRANDSTREAM
Table of Contents
Grandstream Networks, Inc. WP820
Wi-Fi Provision via USB Guide
SUPPORTED DEVICES
The following table shows Grandstream products supporting this feature:
Table 1: Supported Devices
| Model | Supported | Firmware |
|---|---|---|
| WP820 | Yes | 1.0.5.5 or higher |
OVERVIEW
In order to facilitate the deployment of Wi-Fi configuration in the field, the
WP820 supports provisioning of the Wi-Fi configuration via a USB flash drive.
The user simply loads the Wi-Fi configuration package on a USB drive and then
plugs it into the device. To ensure the security of the device, the USB
provisioning of the Wi-Fi configuration will first verify the credentials of
the administrator if the screen lock is active and a password is set.
The provision function through the USB flash drive also includes additional
features such as upgrading the firmware and provisioning the device
configuration. When the USB flash drive contains the firmware installation
package, the configuration file, and the Wi-Fi configuration installation
package, the device will process the files as follows: (1) Firmware upgrade
(2) Config provision (3) Wi-Fi configuration provision.
WI-FI PACKAGE DETAILS
Wi-Fi Package Format
The Wi-Fi installation package is a zip file named “wifiAutoConfig.zip.” It contains a configuration file “config.xml” and sample Wi-Fi certificate files as shown below (Note: Certificates are not necessary depending on the Wi-Fi authentication method used and included for demonstration purposes):
Figure 1: Wi-Fi installation file
Config.xml Template
The configuration file “config.xml” provided contains all examples of Wi-Fi
methods that are supported. It is recommended to only use the configuration
that closely matches your network and remove the others. The config.xml format
and instructions are as follows:
<?xml version=”1.0″ encoding=”UTF-8″?>
USB File Path
Place the Wi-Fi package directly in the root directory of the USB flash drive.
USAGE SCENARIOS
Normal Use
- Download the zip file “wifiAutoConfig.zip” from the Grandstream WP820 resources page.
- Configure config.xml and include any necessary certificates.
- Transfer the file “wifiAutoConfig.zip” to a USB flash drive.
- Use a USB OTG cable to connect the USB flash drive to WP820 and confirm the provisioning process.
Limited permission or lock screen enabled with password
In the following situations, the WP820 will prompt for admin password prior to allowing Wi-Fi configuration:
- The web UI setting “Configuration via Keypad Menu” is set to “basic setting only” or “basic setting & network setting” or “constraint mode.”
- The lock screen is enabled with a password
Same Wi-Fi Configuration
If both the
Low Battery
If the USB flash drive is inserted and the power is too low, the Wi-Fi upgrade cannot be performed. The process will need to be retried again when the battery is above 15%.
Call during configuration
The Wi-Fi provision prompt will not display during the call and the system
will wait until the call is ended or canceled before showing the confirmation
prompt.
Web upgrade for firmware during configuration
The Wi-Fi provision prompt will not display during the firmware upgrade and
the system will wait until the upgrade is completed or canceled before showing
the confirmation prompt.
There are firmware packages or CFG config files on the USB drive
In the scenario where there are firmware files, CEG config file, and Wi-Fi
package on the USB drive the behavior will be as follows:
- If a firmware package exists (wp820fw.bin), the upgrade prompt is displayed first.
- If the firmware upgrade prompt is canceled, it will check for the CEG configuration (cfg{mac}.xml) and provide a prompt.
- If the CEG provision is canceled, the device will detect “wifiAutoConfig.zip” and a Wi-Fi configuration prompt will display.
CONFIGURATION ERRORS
Table 2 : Error description
| Error Type | Error Description |
|---|---|
| USER_CANCEL | The config has been cancelled by user. |
| UNZIP_FAIL | /path/wifiAutoConfig.zip:The file does not exist. |
| UNZIP_FAIL | /path/wifiAutoConfig.zip:Unzip path make or clear error. |
| UNZIP_FAIL | /path/wifiAutoConfig.zip:Unzip IO exception. |
| PARSE_FAIL | /path/wifiAutoConfig.zip:config.xml does not exist. |
| PARSE_FAIL | /path/wifiAutoConfig.zip:IO exception occurred during parsing. |
| PARSE_FAIL | /path/wifiAutoConfig.zip:Xml format error. |
| CHECK_FAIL | /path/wifiAutoConfig.zip:’uuid’ of the config is required. |
| CHECK_FAIL | /path/wifiAutoConfig.zip:’id’ or ‘name’ of SSID is required. |
| CHECK_FAIL | SSID_NAME:’security’ of the SSID is invalid. |
| CHECK_FAIL | SSID_NAME: Current security does not require a ‘password’. |
| CHECK_FAIL | SSID_NAME: Current security does not require ‘EAP method’ or |
‘parse2Method’.
CHECK_FAIL| SSID_NAME: Current security does not require ‘CAcert’,’userCert’,’
password or clientPassword’.
CHECK_FAIL| SSID_NAME: Current security does not require ‘identity’ or
‘anonymous
CHECK_FAIL| SSID_NAME: Current security requires ‘password’.
CHECK_FAIL| SSID_NAME:’eapMethod’ of the SSID is invalid.
CHECK_FAIL| SSID_NAME: Current EAP method does not require ‘parse2Method’.
CHECK_FAIL| SSID_NAME:’parse2Method’ of the SSID is invalid.
CHECK_FAIL| SSID_NAME: Current EAP method requires a ‘password’.
CHECK_FAIL| SSID_NAME: Current EAP method requires ‘caCert’.
Error Type| Error Description
---|---
CHECK_FAIL| SSID_NAME:’caCert’ does not contain ‘.’, the correct format is
similar to ‘ca. art.
CHECK_FAIL| SSID_NAME: Current EAP method requires ‘clientCert’.
CHECK_FAIL| SSID_NAME:’clientCert’ does not contain ‘.’, the correct format is
similar to ‘client.art.
CHECK_FAIL| SSID_NAME: IPv4 address cannot be empty.
CHECK_FAIL| SSID_NAME:IPv4 address format error.
CHECK_FAIL| SSID_NAME: IPv4 prefix length beyond range.
CHECK_FAIL| SSID_NAME: IPv4 gateway cannot be empty.
CHECK_FAIL| SSID_NAME: IPv4 gateway format error.
CHECK_FAIL| SSID_NAME:IPv4 DNS address requires at least one entry.
INSTALL_CERT _FAIL| /path/wifiAutoConfig/ca.crt:The file does not exist.
/path/wifiAutoConfig/ca.crt:IO exception. /path/wifiAutoConfig/ca.crt:File
type is not supported. /path/wifiAutoConfig/ca.crt:Certificate installation
Failed.
WP820
Wi-Fi Provision via USB Guide
Read User Manual Online (PDF format)
Read User Manual Online (PDF format) >>