ProGlove Documentation

Connect to Wi-Fi by importing credentials in the network.json file

If you do not want to include your network's password in the configuration file (created on Insight Webportal), you can provide it in the network.json template and upload it directly to your Gateway by following these steps:

Create the network.json file

  1. Open a text editor (E.g. Notepad, Sublime Text, VS Code).

  2. Copy the snippet below into the editor.

    {
  "wifi": {
	"wifi_auth": [
		{
		    "ssid": "Your SSID",
		    "visibility": "ACCESS_POINT_VISIBILITY_VISIBLE",
		    "wpa_psk": {
		        "psk": "Your Password"
		    }
		}
	]
  }
}
    Table 9. File settings

    Field Name

    Description

    Type

    Example

    Default Value

    Comment

    ssid

    The SSID of the access point

    String

    0xx00x

    SSID is a required value and its max length is 32 characters.

    visibility

    The visibility of the access point

    String

    ACCESS_POINT_VISIBILITY_VISIBLE; ACCESS_POINT_VISIBILITY_HIDDEN

    ACCESS_POINT_VISIBILITY_VISIBLE

    psk

    The Pre-Shared key

    String

    000000000

    Required.



    Note

    • The example snippet uses the default WPA Personal authentication protocol. To learn more about different authentication protocols, see Additional Wi-Fi settings.

    • The field visibility is set to ACCESS_POINT_VISIBILITY_VISIBLE by default. If the network is hidden, replace it with ACCESS_POINT_VISIBILITY_HIDDEN.

    For a proxy connection, the file needs to contain the following code:

    {
    "proxy_settings": {
        "hostname": "192.168.178.124",
        "port": 8888,
        "ignore_os_level_proxy_settings": true
    }
}

    The proxy settings may contain other fields below, which are relevant for usage on Gateway. Those settings will be ignored on Insight Mobile (Android).

    Table 10. Proxy settings

    Field Name

    Description

    Type

    Example

    Default Value

    Comment

    hostname

    Host name of the proxy server that should be used

    String, URL format without protocol (http, https prefix)

    "mycompanyproxy.com", "192.168.101.1", null

    null

    If this is null, port is expected to be null as well, and no proxy will be set.

    port

    Port number of the proxy server that should be used

    Integer, valid port number

    "8080", null

    null

    If this is null, hostname should be null as well, and no proxy will be set.

    ignore_os_level_proxy_settings

    In case of no specified proxy, check whether to use or ignore proxy settings configured on OS Wi-Fi connection level.

    Boolean

    true, false

    false

    If no proxy is configured, by default OS level proxy will be used. You must specify as "true" if that proxy should be ignored.



  3. Under ssid, replace Your SSID with the name of your Wi-Fi network.

  4. Under psk, replace Your Password with the password for the entered ssid.

  5. Save the file as network.json.

  6. Create a .zip archive of the network.json file.

    Note

    For proxy settings, the .zip file should be named network_config.zip. The .zip file can contain other files as well, those will simply be ignored.

Apply the network.json file

  1. Connect the Gateway's USB cable to your desktop.

    The Gateway boots up in about 1 minute. The USB LED glows green constantly.

  2. Scan the barcode on the Gateway with your scanner.

    The scanner connects to the Gateway and the Scanner LED glows green.

  3. Scan the barcode below to enable the Gateway as a Mass Storage device.

    PEP_EnableMassStorage.png

    The Gateway displays as a Mass storage device on your desktop.

  4. Upload the network.zip file to the Gateway Mass storage device.

    Warning

    Make sure that you upload the zipped archive of your network.json file, that is network.zip. Uploading the flat network.json will not work.

  5. Eject the Gateway Mass Storage device.

    The upload takes a few seconds. All three LEDs flash green when done. The Gateway automatically connects to Wi-Fi and Insight Webportal and Cloud LED glows green.

    Note

    Once the network.json file is processed by the Gateway, it is no longer accessible anywhere on the Mass storage device, therefore the network details are not exposed anywhere.

Note

Ejecting the Mass storage device may vary depending on your operating system.

Make sure to Safely Remove / Eject the Mass storage device on your desktop but do NOT disconnect the Gateway’s USB cable during upload.

In this section: