This article applies to all TeamViewer IoT users that want to install TeamViewer IoT Agent on Raspberry devices.
General
TeamViewer IoT already had instructions on how to install TeamViewer IoT Agent to Raspberry PI devices that comes with preinstalled OS. But how to do with the devices that has no OS installed on them? With this feature we have made it easier for users to have both OS and Agent installed on Raspberry PI device and automatically register the device to the TeamViewer Account.
Compatibility
The feature is tested and is compatible with the following Raspberry PI models:
- Raspberry Pi Zero W
- Raspberry Pi 1
- Raspberry Pi 2
- Raspberry Pi 3
- Raspberry Pi 4
Use cases
Installing the TeamViewer IoT Agent required an access to CLI GUI, so there was a need to connect a keyboard and monitor to your Raspberry PI device. Now when the Agent is installed automatically by the configuration scripts on device boot, no more need to have/connect an extra equipment.
This method can be used for mass deployment of the agent on multiple Raspberry PI devices. Just flash the microSD cards with the required OS and configuration file, insert to the devices and power up. You can have your devices up and running TeamViewer IoT within minutes.
How to Setup
Login in TeamViewer IoT Management Console from navigation panel click on Inventory and from the ADD dropdown menu on the right select Device.
Select the required model of Raspberry PI.
Scroll down and select Empty Raspberry PI.
Now, will get the Configuration settings.
Only the Group field is mandatory in configuration.
If you want to automatically configure your network (LAN or WiFi) parameters on your device, then you need to fill Hostname, WiFi Network Name (SSID), WiFi Password and Country.
Once you are done with the input of your settings, click Download Configuration.
This will download the .zip package which contains scripts and configuration for TeamViewer IoT Agent installation.
Once you downloaded the configuration, download the OS that you want to have on your device. It can be one of the followings:
Note: The links to these images can be found in instructions page for easy reference.
After you downloaded the necessary OS, you would need an image writing tool such as Win32 Disk Imager, Rufus, Etcher, ApplePi-Baker, Acronis True Image, etc.
Make sure that microSD is properly formatted, and partitions are deleted. Write the OS image to the microSD card from Raspberry PI device. After you have the OS on the microSD card, you will notice the “boot” partition. Extract the downloaded Configuration files from earlier step and copy to boot partition on MicroSD card by replacing all the files on boot partition with downloaded configuration file.
Now insert the microSD card back to your Raspberry PI device and power up. Don’t forget to connect the LAN cable if you intend the device to work in LAN network. It will take 3 to 5 minutes for the device to boot and install the TeamViewer IoT Agent on the OS. This will be done by scripts and configuration files you have on microSD card, so no extra step is required.
Once the device is up, go to Inventory, or simply refresh the page if you are already on the page and find your device there. Now you can add sensors, metrics, remote connect and use other features of TeamViewer IoT.
