Advanced Wi-Fi Configuration - Stat Temp v2
Our Stat Temp hardware allows for an alternative method of network provisioning that does not require a separate application. This method is specifically useful in the following circumstances:
- IP information must be manually configured
- The wireless network utilizes Enterprise authentication/encryption
- Connecting to a hidden network that is not broadcasting its SSID.
- You have a large number of devices you are deploying
There are a few items and pieces of information that you will need:
- A Micro SD card reader
- A text editor (such as notepad)
- The required network configuration information
- SSID - network name
- Password
Prepare the monitor:
- Enter the menu by pressing the white and black buttons on top of the monitor.
- From the Main Menu, use the white button to scroll down to Administrative Activities, then use the black button to select it. Use the white button to scroll down to Factory Reset, and use the black button to select it. Your device will restart and display "Factory Resetting Device".
**If you see "policies" on your monitor, press the white button firmly. This will take you back to the submenu. Then use the white button to scroll down to "Up on level (back)." Then follow the steps to get to Administrative Activities.
- Once it resets and the QR is displayed, power your Stat Temp monitor off.
- Locate the MicroSD card slot on the bottom of the monitor, between the USB port and the first sensor port. To eject the MicroSD card, use a fingernail or small object to lightly push up on the SD card and release.
- Insert the Micro SD card into the SD card reader and attach it to your computer.
- Open the USB port where the contents of the SD card are listed.
- Open the provisioning.json file in your favorite editor, such as Notepad.
- You may have to right-click on the file, click “Open with,” and then select the text editor of your choice.
- If the file does not exist, create a new file in the text editor of your choice and name it provisioning.json.
Configure the new file:
- In the text editor, use the information below to create your .json file. This information will be the start of your Wi-Fi configuration. (you can copy the code below to start).
- Once you have all information needed for advanced configuration, visit this Site: https://jsonformatter.curiousconcept.com/
- Copy and paste your JSON file content into the designated field on the site.
- Click the "Process" button to validate your JSON file.
- If errors appear, carefully review the error messages, correct your JSON file, and reprocess it until no errors remain.
- Once your JSON file is error-free, copy the code from the first box.
Save the File:
- Paste the validated JSON code into the editor.
- Click "File," then "Save As."
- Name the file
provisioning.json
and ensure the file type is set to.json
. - Transfer to SD Card: Save the
provisioning.json
file and copy it to your SD card.
Installation:
- Insert the SD Card into the Stat Temp Monitor with the contacts or metal part facing you.
- Turn on the Stat Temp monitor.
- If the provisioning.json file is found, and there are no errors, the device will apply the network configuration specified in the file and connect to the network.
- If the device starts up and doesn't use the new file you created to connect to the network, you will have to access the menu to Clear Network Credentials.
- To enter the menu, press both buttons on top of the monitor together. The LED on the bottom left will turn solid purple.
- From the Main Menu, use the white button to scroll down to 'Administrative Activities', then use the black button to select it. Use the white button to scroll down to 'Clear Network Credentials', and use the black button to select it. Your device will restart.
- Allow the device to reboot after clearing network credentials.
- This will apply the new network configuration from the provisioning.json file.
Troubleshooting (If Provisioning Fails): If there are issues with the provisioning.json file or the device fails to join the configured network, the device will display an error message on the screen indicating that the file cannot be read. In this case, power off the device. Examine the provisioning.json file for errors, correct them if necessary, and ensure it's properly written to the SD card.
Writing the File
In the text editor, copy the information below and paste it into your .json file. This information will be the start of your Wi-Fi configuration.
{ "delete_after": false, "wifi": { "enabled": true, "mode": "station", "ssid": "FaciclityWifi", "security": "WPA2_PSK", "password": "password", "username": "gates" (optional) } }
“ssid”:
Enter the name of the network you are connecting your Stat Temp monitor to. This is case-sensitive.
“security”:
This option defaults to WPA2_PSK but it is recommended to be very explicit and set the correct value. Available options are:
- OPEN
- WEP
- WPA_PSK
- WPA2_PSK
- WPA_WPA2_PSK
- WPA2_ENTERPRISE
- WPA3_PSK
- WPA2_WPA3_PSK
“password”:
If your network is password protected, enter the password here. If it is not, you can exclude this field from your .json file. This is case-sensitive.
“username”:
If you are setting up a PSK network with a user name, you can set the "username" option to the correct user name. If this field is not required, you can exclude it from your .json file. This is case-sensitive.
If you are setting up Enterprise, Static IP, or need to set ntp values, instructions for configuring those values are below.
How to set Enterprise
Here are the steps to connect your Stat Temp monitor to a WiFi network with Enterprise authentication:
{ "delete_after": false, "wifi": { "enabled": true, "mode": "station", "ssid": "temptest", "security": "WPA2_ENTERPRISE", "password": "password", "username": "..." "enterprise" { "identity": "...", ({domain}\\{username}) "root_ca": "...", (optional) "client_cert": "...", (optional) "client_key": "..." (optional) } } }
“enterprise”:
In enterprise WiFi environments, authentication is typically achieved through the exchange of certificates. This information is usually found in the "enterprise" section of the relevant documentation. When inputting these certificates, it is important to ensure that they are placed on a single line with no line breaks, including the start and end indicators.
“identity”:
Set the "identity" option to the username or identity that you use to authenticate with the network. This is an unencrypted form of the password used for security utilizing a pre-shared key (PSK). ({domain}\\{username})
“root_ca”: optional
This is the Root CA certificate that created the client certificate.
“client_cert”: optional
This is the client certificate assigned to the device.
“client_key”: optional
This is the client key assigned to this device.
How to set Static IP
By default, devices are configured to retrieve their network settings dynamically from the DHCP server. However, if this is not the case, you can use this section to manually specify the IP information that the monitor will use to communicate on the network.
{ "delete_after": false, "wifi": { "enabled": true, "mode": "station", "ssid": "...", "security": "WPA2_PSK", "password": "secret", "ipconfig": { "method": "manual", "address": "192.168.1.10", "netmask": "255.255.255.0", "gateway": "192.168.1.1", "primarydns": "8.8.8.8", "secondarydns": "8.8.4.4" } } }
“ipconfig”:
Including this in the configuration file informs the device that you are specifying your own network settings.
“method”:
The method defines if the device is connecting utilizing DHCP or manually. The default value is DHCP.
“address”:
When configuring manually, this is the IP address you would like to have assigned to this device.
“netmask”:
When configuring manually, this is the netmask of the network you would like to use with this device.
“gateway”:
When configuring manually, this is the gateway address for the network.
“primarydns”, “secondarydns”:
When configuring manually, this is the primary and secondary DNS server to access.
How to set ntp
NTP is used for network time synchronization. By default, the US NIST pool is accessed. You may provide up to three alternative NTP servers if you like.
{ "delete_after": false, "wifi": { "enabled": true, "mode": "station", "ssid": "...", "security": "WPA2_PSK", "password": "thesecretis", "ipconfig": { "method": "manual", "address": "192.168.1.10", "netmask": "255.255.255.0", "gateway": "192.168.1.1", "primarydns": "8.8.8.8", "secondarydns": "8.8.4.4" } }, "ntp": [ "132.163.97.5", "132.163.96.5", "128.138.141.177" ] }