Provisioning

Provisioning Your Devices to TelemetryTV

TelemetryTV offers a streamlined process to provision your devices. Provisioning refers to the process of setting up a device to work with specific settings or software—in this case, to work seamlessly with TelemetryTV. It locks your device to your account. Here's a step-by-step guide on how to do it:

Step 1: Log into TelemetryTV

Open your web browser, navigate to the TelemetryTV login page, and enter your account credentials to log in.

Step 2: Access the Provisioning Tokens

Once you're logged in, navigate to the 'Settings' tab. You can find this tab represented by a gear icon in the TelemetryTV interface. Within the 'Settings' section, select 'Provisioning Tokens.'

Step 3: Create a New Provisioning Token

In the 'Provisioning Tokens' section, click on 'Add' to create a new provisioning token. This token will generate a file with the necessary information to provision your device.

Step 4: Download the Provisioning Token

After the token is created, click the download icon. This will download the provisioning file to your computer.

Step 5: Rename the Provisioning File

Once the provisioning file has been downloaded to your computer, Rename the downloaded file to "telemetry_config.json".

❗️

Renaming the File

It is essential to re-name the provisioning file to "telemetry_config.json". This is a crucial step as the file name is how TelemetryOS recognizes the provisioning token

Step 6: Preparing the USB Stick

Format the USB storage stick with File Allocation Table 32 (FAT32).

❗️

Important Notes for Formatting the USB stick with FAT32

  • the USB stick must be formatted with FAT32 and "Master Boot Record" schema
  • this must be the only partition on the USB stick

FAT32 is a file system used for storing data on USB sticks, hard drives and memory cards. Please note, formatting the USB stick will erase any files that are currently stored on the stick. To ensure that these files are not lost, ensure they are migrated off of the stick prior to formatting it.

Step 7: Rooting the file on the USB Stick

Migrate the previously renamed configuration file: "telemetry_config.json" into the root of the filesystem of the USB stick.

Step 8: Provision the TelemetryOS Device

  1. Power on your TelemetryOS device.
  2. Upon reaching the Network Setup Screen and observing the message "Insert USB key to provision" at the bottom right corner, proceed to insert the USB stick that holds the "telemetry_config.json" file.
  3. Next, wait until you see a green “Provisioning Successful” message. Please allow for up to 30 seconds for the device to provision
  4. Lastly, click the "Done" button located in the top right corner of the screen. The device will read the file and automatically provision itself with the settings defined in the token.

👍

Provisioning Successful

Once these steps are complete, a message will appear stating that the provisioning was successful. If no message appears, please ensure all previous steps are completed correctly.

If you do not receive this message after completing this process, please fully reboot the device prior to attempting to provision again

Special Note for ChromeOS Users

If you're provisioning a ChromeOS device, the process is slightly different. Instead of transferring the provisioning file to a USB stick, you'll need to upload the file to the Google Admin Console. For detailed instructions, please refer to our specific documentation on how to set up ChromeOS devices with TelemetryTV.

Remember, if you have any questions or encounter any issues during the provisioning process, our support team is always ready to assist.