Providing WIFI Credentials to and Changing Network Settings on Targets, Monitors, and Displays

<< Click to Display Table of Contents >>

Navigation:  Support > Athena Support > Range Equipment > Athena Network Configuration > Configuring Your Own WIFI Network >

Providing WIFI Credentials to and Changing Network Settings on Targets, Monitors, and Displays

Providing WiFi credentials to your EST Units is typically done in the Take Ownership process. However, if your WiFi credentials changed, these steps may be followed to update your EST Units with the new credentials.

To set WIFI credentials on your Targets, Monitors, and Displays use the USB Thumb Drive provided with your system. This thumb drive comes pre-installed with two files, "sharedKey.txt" and "network.json." To specify the credentials the network.json file needs to be updated for your specific network. Then insert the USB Thumb Drive into each component and wait for the unit to reboot.

 

File structure of the USB:

USB Drive (E:)/
├── sharedKey.txt
└── NetworkInfo/
    └── network.json

 

 

sharedKey.txt is a text file that contains a unique shared key value for your system. Each Target, Monitor, and Display has been pre-configured with the same shared key text file. When the USB is inserted the shared key on the unit is compared with the shared key on the USB Thumb drive. If the keys match then the WIFI credentials in network.json are copied over. No action is taken if the shared keys do not match.

network.json is a json formatted text file that needs to be edited with your WIFI network's credentials. It is located in the "NetworkInfo" folder on the USB Thumb drive. While it has many fields, only the "ssid" and "psk" fields, in "Primary" need to be filled in. All other fields can and should remain as empty strings (""). A completed network.json file will look like the following.

{

    "Networks":{

        "Primary": {

            "ssid": "1234-Athena-2.4",

            "psk" : "myNetworksPassword"

        },

        "Secondary": {

            "ssid": "",

            "psk" : ""

        }

    },

    "Capabilities":{

        "IoTHost": "",

        "RootCAPath": "", 

        "Name" : "",

        "HostName": ""

    },

    "NTPServer": "",

    "TimeZone": "",

    "ForceNetworkReset" : false

}

 

network.json Fields

None of these fields are required.

Networks.Primary.ssid

String. The SSID of the primary WiFi network to connect to.

Networks.Primary.psk

String. The PSK (password) of the primary WiFi network to connect to.

Networks.Secondary.ssid

String. The SSID of the secondary WiFi network to connect to.

Networks.Secondary.psk

String. The PSK (password) of the secondary WiFi network to connect to.

Capabilities.IoTHost

String. The IoT endpoint to connect to. Usually best to leave as an empty string or not include unless told by Shooter's Tech's support otherwise.

Capabilities.RootCAPath

String. The full path to the root Certificate Authority file. Usually best to leave as an empty string or not include unless told by Shooter's Tech's support otherwise.

Capabilities.Name

String. The thing name of this EST Unit. Usually best to leave as an empty string or not include unless told by Shooter's Tech's support otherwise.

Capabilities.HostName

String. The hostname of this EST Unit. Usually best to leave as an empty string or not include unless told by Shooter's Tech's support otherwise.

NTPServer

String. The hostname or IP address of the NTP server to synchronize with. Usually best to leave as an empty string or not include unless told by Shooter's Tech's support otherwise.

Must be one of the following values:
   CDT: America/Chicago
  MDT: America/Denver
  EDT: America/New_York
  PDT: America/Los_Angeles
  MST: America/Phoenix
  AKDT: America/Anchorage
  HST: Pacific/Honolulu
  WET: Europe/Lisbon
  CET: Europe/Paris
  EET: Europe/Athens

ForceNetworkReset

Boolean. If true resets the WIFI network, removing all existing WIFI networks. Also, if true, the values in Networks (see above) are ignored.

Default value is false. Unless told by Shooter's Tech's support, best to set to false or not include.

 

In order to provide a unit with WIFI credentials, perform the following steps. These steps assume you are starting with a fresh USB Thumb Drive:

1.On your personal computer (e.g. Mac or Windows), insert a USB Thumb Drive.

2.Once mounted, create a new folder named "NetworkInfo.

3.Open the NetworkInfo folder and create a new text file named network.json. Open that file in your favorite text editor (e.g. Notepad or vi).

4.Copy and paste the network.json template provided above into your file.

5.Type in the values you want to update. Typically this will only be the WIFI network and password in the "ssid" and "psk" fields.

6.In the root of your USB Thumb Drive, create a second file "sharedKey.txt".

7.Open the sharedKey.txt file in your favorite text editor. Copy and paste the value of your shared key, this will be a UUID formatted string.

8.Eject and remove the USB Thumbdrive from your computer.

9.For each Athena Target, Monitor, and Display:

a.Insert the USB Thumbdrive into an open USB slot. Note on the Targets use the USB Drive expansion.

b.After 30 seconds the unit will reboot.

c.After reboot remove the USB Thumbdrive. The unit should now be connected to your WIFI network.

 

Athena Targets, Monitors, and Displays are only compatible with WPA2 WIFI networks using SSID and passwords for authentication. Visit Athena Network Requirements for more information.


See Also

Ethernet Access

Network and Terminal Access