Advanced Network Provisioning Using a MicroSD Card
This guide explains how to configure your Stat Temp monitor’s Wi-Fi connection by creating and editing a JSON file on a MicroSD card.
It covers:
- The most common setup (WPA2 PSK with password, no username)
- How to troubleshoot connection issues
- How to amend your configuration for special cases like adding a username, Enterprise networks, Static IP, and NTP servers
What You’ll Need
- MicroSD card and card reader
Text editor (e.g., Notepad, TextEdit)
Your Wi-Fi network details:
- SSID (network name)
- Password (if required)
Network Requirements:
- Ensure port 443 (HTTPS) is open.
- Ensure DNS resolution is not blocked for *.stat-temp.com.
- Stat Temp Wi-Fi devices support 2.4 GHz networks only and will not connect to 5 GHz.
- If band steering is enabled, it may need to be disabled for the device network.
Captive portals or login pages can prevent devices from authenticating and will require IT involvement to bypass.
Allow TCP port 8883 outbound (MQTT over SSL) to the following:
- Host: iot.stattemp.io
- AWS endpoint: a2d9b7364deag5-ats.iot.us-east-1.amazonaws.com
- IP addresses: 54.173.251.106, 3.221.75.93
- Allow port 123 (NTP) to pool.ntp.org for time synchronization.
- Avoid deep packet inspection or SSL termination that interferes with encrypted cloud traffic.
- If a proxy server is in use, configure exceptions for Stat Temp domains.
Step 1: Prepare the Monitor
Before configuring Wi-Fi, prepare the device to connect to WiFi:
For V2 Firmware Devices - these monitors have a black power toggle
- Press both buttons on top of the monitor at the same time. The bottom left LED will turn solid purple, indicating you are in the menu.
- Use the white button to scroll down in the Main Menu until you reach “Administrative Activities.”
- Select “Administrative Activities” using the blue or black button.
- Use the white button again to scroll down to “Factory Reset.”
- Select “Factory Reset” using the blue or black button. The monitor will restart and display “Factory Resetting Device.”
For V3 Firmware Devices - these monitors have a red power button
- Turn off the monitor using the red power button.
- Once the device is off, press and hold all three buttons (white, black, and red) until the ‘Factory Reset Confirmation’ screen appears.
- Release all the buttons when you see the confirmation screen.
- Press the white button to confirm the reset.
- The device will restart and display a QR code with the message: “Let’s connect to WiFi.”
Step 2: Access the MicroSD Card
- Locate the MicroSD card slot at the bottom of the monitor (between USB and sensor ports).
- Press gently to eject the card.
- Insert the MicroSD card into your computer’s card reader.
- Open the MicroSD drive to view its contents.
Step 3: Edit/Create the Provisioning File
- If provisioning.json already exists, right-click it and open it with Notepad.
- If it doesn’t, create a new file with your text editor and save it as provisioning.json(make sure the file extension is .json ).
Step 4: Write the File
Most Common Setup - WPA2 PSK
Copy and paste this template into your provisioning.json file.
{
"delete_after": false,
"wifi": {
"enabled": true,
"mode": "station",
"ssid": "YourNetworkName",
"security": "WPA2_PSK",
"password": "YourNetworkPassword"
}
}
Update these required fields:
ssid: Your Wi-Fi network name (case-sensitive).
security: Your Wi-Fi security type (usually "WPA2_PSK" ).
- Other security types include:
- OPEN
- WEP
- WPA_PSK
- WPA2_PSK
- WPA_WPA2_PSK
- WPA2_ENTERPRISE
- WPA3_PSK
- WPA2_WPA3_PSK
- Other security types include:
- password: Your Wi-Fi password (case-sensitive). Remove this line if your network is open.
Important Notes About JSON Editing:
- Use double quotes " " for all text values.
- Every line except the last inside an object or array must end with a comma.
- Be careful removing lines; don’t leave trailing commas.
Step 5: Validate and Save
- Validate your JSON usinghttps://jsonformatter.curiousconcept.com/.
- Paste your whole JSON file into the editor to check for errors and formatting issues
- Fix any errors reported.
- Save the file as provisioning.json(ensure the .json extension is used).
- Copy the file to the MicroSD card.
Step 6: Install the MicroSD Card and Power On
- Insert the MicroSD card back into the Stat Temp monitor (metal contacts facing you and angled slightly upward).
- Power on the device.
- The monitor will read and apply the configuration automatically if the JSON file is valid.
Step 7: Troubleshooting
- If the device does not connect using the new settings, clear network credentials:
- Press both buttons on top of the monitor until the bottom-left LED glows solid purple.
- Use the white button to scroll to Administrative Activities, press the black button to select.
- Scroll to Clear Network Credentials, press the black button to confirm.
- The device will restart and reapply the configuration.
- If the device shows an error reading provisioning.json, power off and check your file for syntax errors, re-validate, and rewrite it to the MicroSD card.
Special Setup Instructions
Use these only if your network requires features beyond the most common WPA2-PSK setup.
Adding a Username
If your Wi-Fi network requires a username along with a password, add the "username" field:
{
"delete_after": false,
"wifi": {
"enabled": true,
"mode": "station",
"ssid": "YourNetworkName",
"security": "WPA2_PSK",
"username": "YourUsername",
"password": "YourNetworkPassword"
}
}
Configuring Enterprise Wi-Fi Networks
For Enterprise (certificate-based) networks, add the "enterprise" section as shown:
{
"delete_after": false,
"wifi": {
"enabled": true,
"mode": "station",
"ssid": "YourEnterpriseSSID",
"security": "WPA2_ENTERPRISE",
"password": "YourPassword",
"enterprise": {
"identity": "DOMAIN\\username",
"root_ca": "-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----",
"client_cert": "-----BEGIN CERTIFICATE-----...-----END CERTIFICATE-----",
"client_key": "-----BEGIN PRIVATE KEY-----...-----END PRIVATE KEY-----"
}
}
}
- Certificates must be a single line without line breaks.
- "identity" usually follows DOMAIN\usernameformat.
Assigning a Static IP Address
If DHCP is not used, specify static IP configuration:
{
"delete_after": false,
"wifi": {
"enabled": true,
"mode": "station",
"ssid": "YourSSID",
"security": "WPA2_PSK",
"password": "YourPassword",
"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"
}
}
}
- Set "method" to "manual" to enable static IP.
Configuring NTP Servers
To use custom NTP servers, add the "ntp" array:
{
"delete_after": false,
"wifi": {
"enabled": true,
"mode": "station",
"ssid": "YourSSID",
"security": "WPA2_PSK",
"password": "YourPassword",
"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"
]
}