TeamViewer IoT Documentation

Here you’ll learn the basics of every TeamViewer IoT Solution and how to set up a TeamViewer IoT Network quickly.

• What is TeamViewer IoT – a basic overview on the topic.
• Glossary – an overview on all used terms and additional information on how to use this documentation.
• Safety – an overview of all guidelines to help ensure your safety and protect the device from damage.
• System Requirements – an overview on required hardware and software.

TeamViewer Internet of Things enables you to instantly connect, monitor, and operate machines and devices securely – from anywhere.

Get full visibility into all IoT devices with real-time status alerts and early insights, so you can react quickly to mitigate risks and proactively solve issues, before they impact your business:

• Combine remote control functionalities with monitoring capabilities
• Operate endpoints remotely for faster, more economical operations – at the enterprise scale
• Receive alerts based on monitored IoT Data, enabling you to react quickly to incidents
• Enables remote assistance and support to fix devices and machine issues as they occur
• Accelerate roll-out time for your IoT solution with out-of-the-box connectivity – no complicated IoT VPNs

Components

The TeamViewer IoT Solution comprises the following core components:

• Your personal edge devices you want to control remotely.
• The TeamViewer IoT Agent Software which enables remote control of your devices.
• The TeamViewer Edge Management Software which enables additional features on your devices like Rule Management and a Web User Interface.
• The TeamViewer IoT Cloud which manages your devices and enables the visualization of data of the device and many more (e.g. reading sensor data or commanding motors). It also enables advanced users to automate processes via scripting. You access the cloud via the TeamViewer IoT Management Console.
• The TeamViewer IoT Agent API (MQTT based) which enables advanced users to access the device data, e.g. using data for your custom IoT cloud service or many other cloud services like Amazon Web Services.
• The TeamViewer IoT SDKs (for C, Node.js and Python) which enables advanced users to create custom applications within the TeamViewer IoT Solution, e.g. automation of processes.

Quickly set up secure Remote Operations, Remote Assistance, and Remote Alarming for distributed endpoints with an easy-to-use, reliable, and scalable cloud IoT solution.

The diagram shows the core components and the basic workflow.

Create new Solutions with TeamViewer IoT

The TeamViewer IoT Agent API and the TeamViewer IoT SDKs enable advanced users to use the full potential of creating custom automation and commands to communicate with the devices and cloud services.

Read this documentation before using any of the referenced products. Heed all safety notices.

Scope

This documentation describes the following products:

• TeamViewer IoT Starter Kit (Dell Edge Gateway, Bosch Sensor XDK110, Power over Ethernet Wall Plug Adapter)
• TeamViewer IoT Software Solution – for remote controlling a device and its connected parts

The TeamViewer IoT Starter Kit contains preconfigured hardware and software to implement your IoT use cases quickly.

Target groups

The products and their documentations address specific target groups. Each target group must have the specified knowledge level to fulfil the tasks and to handle all products safely.

This glossary is intended to assist you when using this documentation.

Used Terms

Heed the terms below to enhance your experience with this documentation.

Used Formats

Heed the formats below to enhance your experience with this documentation.

For example: To save click OK.

For example: On the right side type into Filename the file name/var/etc/smb/smb.conf.

Notes and Tips

Command line

Commands to type in are displayed in a single line. You can copy and paste a given command when prompted.

ls -a

Some commands to type in are very long. They are displayed in a special box. The following example represents still one single line command. You can copy and paste the whole content when prompted.

Source code / File contents

Source codes or file contents are displayed in multiple lines. You can copy and paste a given content when prompted.

#include 
#include 

int main() {
	std::cout<<"Hello World"<<std::endl;
	return 0;
}

Troubleshoot

Heed the section Troubleshoot (if any) to solve problems while using the product.

Features of this documentation

The following features are enabled to assist you. The use is optional.

• Click the printer symbol () next to a heading to print the current documentation or to save it as PDF.
• Click the hash symbol (#) next to a heading to get the link of the current section.

This section describes the TeamViewer IoT Starter Kit and its components in detail.

The TeamViewer IoT Starter Kit is a preconfigured edge device purchasable from TeamViewer.

See

• Safety
• Technical Data
• Set up the Starter Kit
• Disposal

The following guidelines help ensure your safety and protect the device from damage. The list of guidelines might not address all potentially hazardous situations in your working environment, so be alert and exercise good judgment at all times.

• Perform only the procedures explicitly described in the documentation for this device. Make sure that only authorized service personnel perform other system services.
• Do not perform any actions that create a potential hazard to people or make the equipment unsafe.
• Keep the area around the device clear and free from dust before, during, and after installation.

Edge Gateway (Starter Kit)

• The Edge Gateway must be installed by knowledgeable, skilled persons familiar with local and/or international electrical codes and regulations.
• The Edge Gateway is not designed for use in wet environments. If the Edge Gateway is to be installed in a wet environment, depending on the location and environment, it must be installed in a panel box or enclosure with an Ingress Protection (IP) rating of IP54, IP65, or higher.
• To reduce the risk of electric shock, power to the DC+ and DC- terminals must be provided by a power supply or transformer/rectifier circuit that is designed with double-insulation. The power supply or power circuit source must comply with local codes and regulations; for example, in the USA, NEC Class 2 (SELV/limited energy circuit, or LPS circuitry). If powered by a battery, double-insulation is not required.
• When installing the Edge Gateway, the responsible party or integrator shall use the 12-57 VDC or Power over Ethernet (PoE) power source 37-57 VDC, with a minimum of 13 W power already present as part of the client’s installation.
• Ensure that the power source providing power to the Edge Gateway is reliably grounded and filtered such that the peak-to-peak ripple component is less than 10 percent of the input DC voltage.
• When installing the Edge Gateway 3001 and 3002, use a cable appropriate for the load currents: 3-core cable rated 5 A at 90°C (194°F) minimum, which conform to either IEC 60227 or IEC 60245. The system accepts cables from 0.8 mm to 2 mm. The maximum operating temperature of the Edge Gateway is 70⁰C (158°F). Do not exceed this maximum temperature while operating the Edge Gateway inside an enclosure. Internal heating of the Edge Gateway electronics, other electronics, and the lack of ventilation inside an enclosure can cause the operating temperature of the Edge Gateway to be greater than the outside ambient temperature. Continuous operation of the Edge Gateway at temperatures greater than 70⁰C (158°F) may result in an increased failure rate and a reduction of the product life. Ensure that the maximum operating temperature of the Edge Gateway when placed inside an enclosure is 70⁰C (158°F) or less.
• When installing the Edge Gateway 3003, use a cable appropriate for the load currents: 3-core cable rated 5 A at 90°C (194°F) minimum, which conform to either IEC 60227 or IEC 60245. The system accepts cables from 0.8 mm to 2 mm. The maximum operating temperature of the Edge Gateway is 60⁰C (140°F). Do not exceed this maximum temperature while operating the Edge Gateway inside an enclosure. Internal heating of the Edge Gateway electronics, other electronics, and the lack of ventilation inside an enclosure can cause the operating temperature of the Edge Gateway to be greater than the outside ambient temperature. Continuous operation of the Edge Gateway at temperatures greater than 60⁰C (140°F) may result in an increased failure rate and a reduction of the product life. Ensure that the maximum operating temperature of the Edge Gateway when placed inside an enclosure is 60⁰C (140°F) or less.
• Always ensure that the available power source matches the required input power of the Edge Gateway. Check the input power markings next to power connector(s) before making connections. The 12-57 VDC (1.08-0.23 A) or the PoE power source must be compliant with local Electrical Codes and Regulations.
• To ensure the protection provided by the Edge Gateway is not impaired, do not use or install the system in any manner other than what is specified in this manual.
• If a battery is included as part of the system or network, the battery must be installed within an appropriate enclosure in accordance with local fire and electrical codes and laws.
• The system is for installation in a suitable industrial enclosure (provides electrical, mechanical, and fire hazard protection).
• The core module only can be wall-mounted (without the need for an additional enclosure).

Electrical

• Inspect portable cord-and-plug connected equipment, extension cords, power bars, and electrical fittings for damage or wear before each use. Repair or replace damaged equipment immediately.
• Use extension cords or equipment that is rated for the level of amperage or wattage that you are using.
• Be aware that unusually warm or hot outlets or cords may be a sign that unsafe wiring conditions exists. Unplug any cords or extension cords from these outlets and do not use until a qualified electrician has checked the wiring.
• Switch all products OFF before connecting them to a power supply.

Cleaning

• Do not clean tools or products with flammable or toxic solvents.

This section describes all technical data of the following products contained in the TeamViewer IoT Starter Kit:

• Power over Ethernet Wall Plug Adapter (POE)
• Dell Edge Gateway
• Bosch Sensor XDK110

The Power over Ethernet Wall Plug Adapter (POE) is used to connect the Edge Gateway with a power supply (e.g. wall socket).

See Attached Files to download the full documentation.

Safety Approvals

• cUL / UL
• CE
• SAA
• C-Tick

Diagram

Dimensions and Weight

• Length: 80mm (3.15in)
• Width: 45mm (1.77in)
• Height: 33mm (1.29in)
• Weight: 95g (3.35oz.)
• Data in/Output Connector: RJ45

Output Connections

• Output Connection (Standard Model): +pin 4, 5 / -pins 7, 8
• Output Connection (GigabitModel): +pin 3, 6 / -pins 1, 2

Output Specifications

Characteristics

Input

Output

Environmental

Attached Files

• Download (PDF): PHIHONG Single Port Power over Ethernet Wall Plug Adapter

The Dell Edge Gateway 3001 is the preconfigured edge device of your TeamViewer IoT Starter Kit. It enables you to collect, secure, analyze, and act on data from multiple devices and sensors.

See Attached Files to download the full documentation.

Safety Approvals

• CE
• complies with FCC radiation exposure limits
• complies with IC radiation exposure limits

Dimensions and Weight

Operating Conditions

Radio Frequency (RF) Exposure

This equipment complies with FCC and IC radiation exposure limits for an uncontrolled environment. This equipment should be installed and operated with a minimum distance of 20 cm between the active transceiver and your body.

Use only approved antenna(s). Non-approved antenna(s) may produce spurious or excessive RF transmitting power which may lead to a violation of FCC/IC limits.

Attached Files

• Download (PDF): Dell Edge Gateway 3000 Series Technical Guidebook
• Download (PDF): Dell’s Chemical Use Policy

The Bosch XDK 110 Sensor Kit is a freely programmable sensor which provides eight different measurements. For the TeamViewer IoT Starter Kit it is programmed to send all to the TeamViewer IoT agent which then are visible and usable in the TeamViewer IoT Solution.

See Attached Files to download the full documentation.

Safety Approvals

• CE

Main Components

• Bluetooth 4.0 low energy IEEE 802.15.1Wireless LAN IEEE 802.11b/g/n
• 32-Bit microcontroller (ARM Cortex M3), 1MB Flash, 128 kB RAM
• Internal Li-Ion rechargeable battery 560 mAh
• Integrated antennas
• Built-in sensors: accelerometer, acoustic sensor, digital light sensor, gyroscope, humidity sensor, magnetometer, pressure sensor, temperature sensor

Operating Conditions (Indoor use)

The battery lifetime of the sensor is up to 24 hours depending on environmental conditions like temperature.

Measurement Ranges

Sampling Rate

LED Indicators

The sensor has 4 LEDs on the top side. Each LED indicates a different status.

Troubleshoot

The LED patterns indicate problems with the sensor. Heed the table below and take action.

Attached Files

• Download (PDF): Bosch Cross Domain Development Kit | XDK

Before you begin any of the procedures in this section heed the information in the section Safety.

What you will

Make sure that you have prepared the following points:

• Your TeamViewer credentials. You received them per E-Mail upon ordering the Starter Kit.
• The TeamViewer Client is installed.
  Visit https://www.teamviewer.com/ to download the application.
• A working local network with router.
• Multiple USB power supplies – one for each sensor (5 V, 3 A).

The Starter Kit arrives in a “ready-to-use” state. No further installation of software is needed.

Set up the Starter Kit

Set up the Dell 3001 edge gateway and ensure it is connected to an internet router:

1. Mount the Wi-Fi antenna to the right side of the gateway .
2. Connect your router with one Ethernet cable .
3. Connect that Ethernet cable with the IN female connector of the included PoE power supply .
4. Connect the OUT connector of the PoE supply via the second Ethernet cable with the Dell 3001 edge gateway .
5. Plug the PoE supply into your wall socket.

Connect the Sensors to the Starter Kit

1. Choose a proper location for your Bosch XDK110 sensors .

2. Connect each sensor with a USB cable and plug them into USB power supplies (not included).
3. Switch the sensors ON . Your Starter Kit is now active and pushes sensor data to the TeamViewer IoT Cloud.

The Starter Kit is now ready to use. Use the IoT Management Console to verify it is working correctly.

The TeamViewer IoT Starter Kit contains a built-in GPS receiver.

What you will need

Make sure that you have prepared the following points:

• Your TeamViewer credentials.
• Make sure that the WiFi antenna is connected to the edge device (see Setup the Starter Kit).
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.
• Access the Edge Device via Remote Terminal.

Enable

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Install the needed dependencies for python. In the terminal type in the following commands and press return:

sudo apt-get update

sudo apt-get install -y python3-pip

3. Download the Starter Kit configuration package. In the terminal type in the following commands and press return:

wget -q https://download.teamviewer-iot.com/teamviewer-iot-kit/v2.0.1/teamviewer_iot_kit-2.0.1-py3-none-any.whl

sudo -H pip3 install teamviewer_iot_kit-2.0.1-py3-none-any.whl

4. Configure the location receiver. In the terminal type in the following command and press return.

sudo teamviewer-iot-kit -e location_receiver

5. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
6. Check that you enabled the GPS. From the left menu select Inventory and on the right side from the drop-down-menu select Metrics.

After the GPS receiver has been enabled you can visualize its data with a widget.

More Information

• The GPS data is NMEA 0183 formatted and packed into a JSON object called NMEA 0183: TPV. In the “Metrics” tab you will find the data in the raw format as well as dedicated metrics for each parameter.
• The location receiver provides the NMEA 0183: SKY object as well which is not presented in the Starter Kit. From that object, two metrics are being calculated and presented separately with the names In View and Used.

The table represents all the available parameters/metrics and their descriptions of the location receiver.

The edge device of the TeamViewer IoT Starter Kit has a built-in modem (4G).

What you will need

Make sure that you have prepared the following points:

• Make sure that the Wi-Fi antenna is connected to the edge device (see Set up the Starter Kit).
• An unlocked SIM card to connect with mobile internet.
• The Access Point Name (APN) of your service provider.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.
• Access the Edge Device via Remote Terminal.
• Basic knowledge of the editor nano.

Unlock the SIM card with the edge device

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Edit the SIM configuration. In the terminal type in the following command and press return.

sudo nano /etc/systemd/system/pinunlock.service

3. When the nano editor opens, copy and paste the following text. Replace **** with your pin.

[Unit]
Description=Sim pin unlock
After=network.target
Requires=snap.modem-manager.modemmanager.service
[Service]
Type=idle
ExecStartPre=/bin/sleep 60
ExecStart=/snap/bin/mmcli -i 0 --pin=****
[Install]
WantedBy=multi-user.target

4. Save the file and exit nano.

Enable mobile internet connectivity

1. Unlock the SIM card.
2. Insert the SIM card into the edge device.

3. Access the edge device remotely (Access the Edge Device via Remote Terminal).
4. Check the type of the inbuilt modem. In the terminal type in the following command and press return.

sudo mmcli -L

5. Depending on the output of the last command use one of the following instructions:

sudo nmcli c add type gsm ifname cdc-wdm0 con-name ConnecctionName> apn 

sudo reboot

sudo mmcli -m 0

sudo nmcli c add con-name  type gsm ifname cdc-wdm0 apn 

sudo nmcli r wwan

sudo nmcli c up 

sudo reboot

The edge device reboots. To check the mobile internet connectivity disconnect the edge device from WLAN and LAN and access the edge device remotely.

Use this procedure to move the TeamViewer Starter Kit from the preassigned account to another TeamViewer Account.

This procedure contains 3 basic steps:

1. Unmanage and Reassign the Starter Kit
2. Reconfigure the Digital Inputs/Outputs
3. Apply the Reconfiguration and Restart

What you will need

Make sure that you have prepared the following points:

• Your login credentials for the Starter Kit (user name, and password).
• You created a new TeamViewer Account (see https://teamviewer-iot.com/).
• You have the IP Address of the Edge Device / IoT Agent.
• A tool to access the Starter Kit remotely via ssh (e.g. Putty).
• Basic knowledge of the editor nano.

Unmanage and Reassign the Starter Kit

1. Log in to the Starter Kit and use your credentials by using a ssh-tool.
2. Unmanage the Starter Kit. In the terminal type in the following command and press return.

sudo teamviewer-iot-agent unmanage

3. Assign the Starter Kit to the new TeamViewer Account. In the terminal, type in the following command and press return. Use your new TeamViewer Account credentials when prompted.

sudo teamviewer-iot-agent setup

4. Restore the configuration of the Monitoring Agent for the Bosch XDK sensors. In the terminal type in the following commands and press return.

sudo teamviewer-iot-agent disable system-health

sudo su

sudo cat /var/lib/teamviewer-iot-agent/system_monitors_kit.conf > /var/lib/teamviewer-iot-agent/system_monitors.conf

sudo teamviewer-iot-agent enable system-health

Reconfigure the Digital Inputs/Outputs

To use the Digital Inputs/Outputs (DIOs) of the Starter Kit with the TeamViewer IoT Agent, you need to create corresponding Sensors/Metrics.

1. To log in to the IoT Management Console, open a web browser. Navigate to the IP address of the Starter Kit (obtained by Get the IP Address of the Edge Device / IoT Agent).
2. From the left menu select API Clients.

3. As client name type in Digital Out then click Create.

4. Click Manage API Client.
5. Click New Sensor and name it Digital Outputs.
6. Click to add 8 metrics. Name the metrics Out 0 to Out 7. Set each Value Type to Bool and set each Display Unit to I/O. For example:

7. Optional: When a metric becomes superfluous, click  to remove it.
8. To finish click Create.

You will be provided with new connector, sensor and metric Ids. For example:

Keep this window open. You need these Ids in the step Apply the Reconfiguration and Restart.

Apply the Reconfiguration and Restart

You need the provided Ids from the step Unmanage and Reassign the Starter Kit.

1. Access the Starter Kit remotely (Access the Edge Device via Remote Terminal).
2. Open the teamviewer_gpio.py file with the editor nano. In the terminal type in the following command and press return.

sudo nano teamviewer_gpio.py

3. Replace the client_id, sensor_id and Out0_id to Out7_id on the top of the file with corresponding Ids obtained in step Unmanage and Reassign the Starter Kit. For example:

client_id = "5385da5e6c854abc8d65c0c80b5d79e9"
sensor_id = "e6218136a1144c8e9d117dc55a24297c"
Out0_id = "4ee43a05e70a4a97a20fe13e6baf286e"
Out1_id = "58f38038ea0b48519332a190688a325e"
Out2_id = "cf1aceeb62f3479fb07d81213dd21269"
Out3_id = "05f12c7970704172a374f777bedc83ef"
Out4_id = "d67d349dba2347699096bc0989f638c8"
Out5_id = "8dac154dfeef4d5aa4ec33b39a675ee4"
Out6_id = "cefdd235b1c243a2b6f7d89a6ce639e3"
Out7_id = "50835cca2df34f19bb13b8a5e0873ed2"

4. Save the file and close the nano editor.
5. Restart the service for the General Purpose Inputs/Outputs (GPIOs). In the terminal, type in the following command and press return.

sudo service teamviewer_gpio restart

6. Verify that the DIOs are configured correctly. In the IoT Management Console navigate to Dashboard.
7. Pin (see Add a Widget) the Out0_id to Out7_id metrics to the dashboard. Configure each as a Control with Toggle-Switch function. Use true and false for the control values. For example:

In August of 2005, the European Union (EU) implemented the EU WEEE Directive 2002/96/EC and later the WEEE Recast Directive 2012/19/EU requiring Producers of electronic and electrical equipment (EEE) to manage and finance the collection, reuse, recycling and to appropriately treat WEEE that the Producer places on the EU market after August 13, 2005. The goal of this directive is to minimize the volume of electrical and electronic waste disposal and to encourage re-use and recycling at the end of life.

TeamViewer GmbH has met its national obligations to the EU WEEE Directive by registering in those countries to which TeamViewer GmbH is an importer. TeamViewer GmbH has also elected to join WEEE Compliance Schemes in some countries to help manage customer returns at end-of-life.

If you have purchased TeamViewer GmbH-branded electrical or electronic products in the EU and are intending to discard these products at the end of their useful life, please do not dispose of them with your other household or municipal waste. TeamViewer GmbH has labeled its branded electronic products with the WEEE Symbol (see figure) to alert our customers that products bearing this label should not be disposed of in a landfill or with municipal or household waste in the EU. Instead, please be aware that TeamViewer GmbH is making a return and collection system available to you, free of transportation and recycling costs, for discarding these products.

Products in the Starter Kit

Heed all information about disposal of each product in the Starter Kit.

This section describes the step-by-step installation via the TeamViewer IoT Management Console.

• System Requirements
• Install the IoT Agent on a Device

For information on installing the TeamViewer IoT Solution on designated hardware see Installation on designated Hardware.

The TeamViewer IoT solution has been verified to be compatible with the following platforms / operating systems.

TeamViewer IoT Agent

TeamViewer IoT Cloud – Browser Compatibility

TeamViewer IoT Client for Remote Access

TeamViewer IoT Remote Access is currently available via TeamViewer Client v13.1 (or newer) for Windows.

Internet Explorer 11  (or newer) is required.

The TeamViewer IoT Agent is needed to enable remote access to devices via internet. Installing it is a prerequisite to all remote access and monitoring processes.

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Inventory then click Add Device.
3. Depending on your operating system, select the correct installation package.

4. Select a Group or create a new Group for your device.
5. Follow one of these steps depending on your previously selected  operating system:

The device is automatically added to the Inventory and can be identified by its hostname. It is placed in the selected Group.

Watch How to Set Up Your First Endpoint

This 2-minute video shows you just how simple it is to connect your first IoT Endpoint with your TeamViewer IoT account.

This section describes the installation of the TeamViewer IoT Solution on designated hardware like:

• Easy Installation on Raspberry Devices
• Set up a Yocto Image for Raspberry

The section describes the installation of the TeamViewer IoT Solution on an empty Raspberry (without operating system).

What you will need

Make sure that you have prepared the following points:

• A Raspberry (see System Requirements) connected to keyboard and monitor.
• A properly formatted micro SD card (Minimum 32 GB).
• Your TeamViewer credentials.
• A disk image creation tool is installed on your local PC (e.g. Win32 Disk Imager).
• The Raspberry is connected to the internet.

Setup

1. Download one of the following archives:
   • https://downloads.raspberrypi.org/raspbian_full_latest
   • https://downloads.raspberrypi.org/raspbian_latest
   • https://downloads.raspberrypi.org/raspbian_lite_latest
2. Extract the image from the archive.
3. Use the disk image creation tool to write the image to the micro SD card.

4. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
5. From the left menu select Inventory.
6. On the left side from the drop-down-menu Add select Device.
7. Select the operating system Linux.
8. Select the distribution Debian.
9. Select your Raspberry version.

10. Select Create an OS image with TeamViewer IoT.
11. Configure the operating system:
    • Input the Host Name
    • Optional: Input the Wi-Fi Network Name (SSID) the Wi-Fi Password and select a Wi-Fi Country
    • Select a Group from your Contacts List.

12. Click Download Configuration and save the archive.
13. Extract the contents of the archive into the /boot folder on the micro SD card.

14. Insert the micro SD card into the Raspberry.
15. Boot the Raspberry.

The Yocto Project enables the creation of custom Linux-based systems for embedded devices.

The TeamViewer IoT Agent will run on Yocto Linux devices given minimum requirements and configurations are met.
This article is an example how to build Yocto Image with TeamViewer IoT Agent for Raspberry using the layer provided in GitHub.

For more information visit Information see https://github.com/teamviewer/meta-teamviewer-iot-agent.

What you will need

Make sure that you have prepared the following points:

• The edge device is set up with a TeamViewer IoT Agent.
• The edge device is connected to the internet.
• Your PC is set up with the TeamViewer Client.
• Your login credentials for the edge device (user name, and password).
• Installed dependencies (based on operating system of Raspberry). For more information see Required Packages for the Build Host.

Setup

1. On your PC open the TeamViewer Client and log in.
2. On the left side open the Computers & Contacts tab.
3. Double-click the device.
   The Control Window opens and the connection will be established.
4. In the Control Window on the top open the Remote Terminal tab.
5. Type in your user password and press enter.
6. Clone the poky project’s zeus branch. In the terminal type in the following command and press return.

git clone --branch=zeus git://git.yoctoproject.org/poky.git && cd poky

7. Clone the Raspberry and the TeamViewer IoT Agent meta-packages. In the terminal type in the following commands and press return:

git clone --branch=zeus git://git.yoctoproject.org/meta-raspberrypi

git clone --branch=zeus https://github.com/teamviewer/meta-teamviewer-iot-agent

8. Configure the environment. In the terminal type in the following command and press return.

source oe-init-build-env

9. Add layers to bitbake. In the terminal type in the following commands and press return:

bitbake-layers add-layer ../meta-raspberrypi

bitbake-layers add-layer ../meta-teamviewer-iot-agent

10. Change the target machine on the configuration file and set init manager to systemd. In the terminal type in the following commands and press return:

echo 'MACHINE = "raspberrypi3"' >> conf/local.conf

echo 'DL_DIR = "${TOPDIR}/downloads"'   >> conf/local.conf

echo 'CONNECTIVITY_CHECK_URIS = "https://www.google.com/"' >> conf/local.conf

echo '#Set Systemd to Init Manager' >> conf/local.conf

echo 'DISTRO_FEATURES_append = " systemd"' >> conf/local.conf

echo 'DISTRO_FEATURES_BACKFILL_CONSIDERED += "sysvinit"' >> conf/local.conf

echo 'VIRTUAL-RUNTIME_init_manager = "systemd"' >> conf/local.co

11. Append ssh and TeamViewer IoT Agent layer. In the terminal type in the following commands and press return. Type in user name and password when prompted.

echo '#Append TeamViewer IoT agent layer' >> conf/local.conf

echo 'IMAGE_INSTALL_append += " teamviewer-iot-agent"' >> conf/local.conf

echo 'IMAGE_ROOTFS_EXTRA_SPACE ?= "50000"' >> conf/local.conf

echo 'CORE_IMAGE_EXTRA_INSTALL += "openssh"' >> conf/local.conf

echo 'INHERIT += "extrausers"' >> conf/local.conf

echo 'EXTRA_USERS_PARAMS = "usermod -P raspberry root;"' >> conf/local.conf

12. Optional: Install Xvfb server (see Set up the Remote Screen via X11) on the edge device to be able to use X11 features. In the terminal type in the following command and press return. Type in user name and password when prompted.

echo '#X11' >> conf/local.conf

echo 'DISTRO_FEATURES_append += " X11"' >> conf/local.conf

13. Optional: Enable Edge Management on the edge device. In the terminal type in the following commands and press return. Type in user name and password when prompted.

git clone --branch=zeus git://git.openembedded.org/meta-openembedded ../meta-openembedded

git clone --branch=zeus git://git.yoctoproject.org/meta-virtualization ../meta-virtualization

sed -i '$d' conf/bblayers.conf

echo '  ${TOPDIR}/../meta-openembedded/meta-oe ' >> conf/bblayers.conf

echo '  ${TOPDIR}/../meta-openembedded/meta-multimedia ' >> conf/bblayers.conf

echo '  ${TOPDIR}/../meta-openembedded/meta-networking ' >> conf/bblayers.conf

echo '  ${TOPDIR}/../meta-openembedded/meta-python ' >> conf/bblayers.conf

echo '  ${TOPDIR}/../meta-openembedded/meta-filesystems ' >> conf/bblayers.conf

echo '  ${TOPDIR}/../meta-virtualization ' >> conf/bblayers.conf

echo '  "' >> conf/bblayers.conf

bitbake-layers show-layers

echo '#Docker layer for supporting Edge services' >> conf/local.conf

echo 'DISTRO_FEATURES_append += " virtualization"' >> conf/local.conf

echo 'IMAGE_ROOTFS_EXTRA_SPACE = "400000"' >> conf/local.conf

14. Start the build type. In the terminal type in the following command and press return. Type in user name and password when prompted.

bitbake core-image-minimal

You can find target image tmp/deploy/images/raspberrypi3/ here with core-image-minimal-raspberrypi3 prefix. In case of failure or new bash (terminal) creation, after all steps executed you need to go to project’s directory and start again from step 8 Configure Environment.

The TeamViewer IoT Agent is the software which connects your edge device with your TeamViewer account.

The TeamViewer IoT Agent is needed to enable remote access and other services to devices via internet. Installing the agent is a prerequisite to all remote access and monitoring processes.

Once set up and assigned to a TeamViewer account you can access the IoT Agent and the edge device remotely.

For more information see:

• Install the IoT Agent on a Device
• Check the Version of the IoT Agent
• Update the IoT Agent
• Access the Edge Device via Remote Terminal
• Access via Remote Screen

In case you want to contact the TeamViewer Support, it is helpful to know the concerning agent version.

What you will need

• The edge device is set up with a TeamViewer IoT Agent.
• The edge device is connected to the internet.
• Your PC is set up with the TeamViewer Client.
• Your login credentials for the edge device (user name, and password).

Access

1. On your PC open the TeamViewer Client and log in.
2. On the left side open the Computers & Contacts tab.
3. Double-click the device.
   The Control Window opens and the connection will be established.
4. In the Control Window on the top open the Remote Terminal tab.
5. Type in your user password and press enter.
6. Identify the version of your agent. In the terminal type in the following command and press return.

sudo teamviewer-iot-agent info

The latest version of the TeamViewer IoT Agent will be available for download via TeamViewer IoT Cloud. 

What you will need

Make sure that you have prepared the following points:

• Access the Edge Device via Remote Terminal

Automatic Update

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Get the most recent repository information. In the terminal type in the following command and press return.

sudo -E apt-get update

3. Download and install the update. In the terminal type in the following command and press return.

sudo -E apt-get install teamviewer-iot-agent

The new version replaces the existing IoT Agent. It will start automatically.

Manual Update

Follow the steps outlined in installation.

The new version replaces the existing IoT Agent. It will start automatically.

This procedure is helpful when you need the IP address of your Edge Device / IoT Agent.

What you will need

Make sure that you have prepared the following points:

• Access the Edge Device via Remote Terminal.

Get the IP Address

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. In the terminal type in the following command and press return.

ifconfig

The IP address is displayed in the section eth0. For example inet addr:192.168.1.128:

 eth0      Link encap:Ethernet  HWaddr 00:0F:20:CF:8B:42
           inet addr:192.168.1.128  Bcast:  Mask:255.255.255.192
           UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
           RX packets:2472694671 errors:1 dropped:0 overruns:0 frame:0
           TX packets:44641779 errors:0 dropped:0 overruns:0 carrier:0
           collisions:0 txqueuelen:1000

The Mass Remote Configuration allows you to assign IoT Agent settings from one Edge Device to one or more other Edge Devices. For example, enabling the Edge Management on all your devices without connecting to them single-handedly.

Follow the 2 basic steps:

1. Create a Settings Template.
2. Assign the Settings Template to Edge Devices.

You also can edit existing Settings Templates and unassign or change groups or single Edge Devices.

What you will need

Make sure that you have prepared the following points:

• Your TeamViewer credentials.
• The edge device is connected to the internet.
• All edge devices are set up with a TeamViewer IoT Agent (Version 2.9 or newer).

Create a Settings Template

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Settings Template.
3. On the right side click Create Template.

4. Type in a unique template name.
5. Click to add a configuration. (When a configuration becomes superfluous click to remove it.)
6. Adjust the configuration to your requirements.

7. To finish click Create.

Assign the Settings Template to Edge Devices

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Settings Template.
3. On the right side choose the Settings Template you want to assign to other Edge Devices. From the dropdown menu select Assign.

4. In the popup select the groups or single Edge Devices which you want to receive the Settings Template.

5. To send the Settings Template to the Edge Devices click Save.

Depending on the edge device performance, you need to allow some time for the Settings Template to assign to the device.

Upon assigning to a group, all eligible devices within the group will receive the template assignment as well.

Devices with unsupported IoT Agent Version as well as shared devices will be visible in the list, but you will receive an appropriate warning message.

Edit an existing Settings Template

At any time, you can edit the settings for a template. After each modification, all assigned devices will receive an updated assignment.

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Settings Template.
3. On the right side choose the Settings Template you want to edit. From the dropdown menu select Edit.
4. Adjust the configuration to your requirements.
5. To finish click Save.

Depending on the edge device performance, you need to allow some time for the Settings Template to assign to the device.

Unassign Settings Template from Edge Devices

At any time, you can modify the settings for a template. After each modification, all assigned devices will receive an updated assignment.

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Settings Template.
3. On the right side choose the Settings Template you want to edit. From the dropdown menu select Assign.

4. In the popup remove the groups or single Edge Devices from the selection which you want to unassign.

5. To finish click Save.

Changing Device Group to Receive Settings Template

Once a Settings Template is assigned to a group, user can assign Group’s template to any edge device by adding it to that group.

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Inventory.
3. On the right side choose the Edge Device for which you want to change its group. From the dropdown menu select Properties.

4. In the popup from the dropdown menu select the new group.
5. Activate the field Inherit Group Setting Configurations.

6. To finish click Save.

Depending on the edge device performance, you need to allow some time for the Settings Template to assign to the device.

TeamViewer IoT cloud offers assignments via token functionality which can be used both for single device assignment and for assigning hundreds or thousands of devices in a secure way.

Follow the steps below to create an TeamViewer IoT assignment token:

• Sign in to the TeamViewer IoT Management Console with your IoT account credentials
• In the top navigation, click the chevron for User Settings and choose Assignment token
• Copy the created token to your clipboard by clicking the “Copy/Paste” icon

Important:

• Please keep in mind that with each renewal, existing tokens will become invalid. This may have severe impact on your running systems depending on these tokens.
• Do not share your tokens or make them publicly available! Tokens are vital to your infrastructure and its security.

The journey of the IoT user starts from assigning his edge device to the cloud and the assignment process should be as simple as possible.

The assignment of a single device is mostly done for testing purposes or when evaluating the solution. The time spent on the assignment will not have a significant impact. But when dealing with a big project mostly you have a bunch of devices that should be assigned to the account. This procedure will shorten the time spent on the assignment process up to even without touching the device.

The TeamViewer IoT Cloud offers assignments via token functionality which can be used both for single device assignment and for assigning hundreds or thousands of devices securely.

How it works

For each TeamViewer Account, a unique assignment token is being generated. The assignment token can be used only for the device assignment to the account.

During the assignment process, the device connects to TeamViewer IoT Cloud and presents its assignment token. The assignment service receives the token and connects the device to the account to which the token belongs.

Starting from that moment the edge device continues to work with the assigned account.

What you will need

Make sure that you have prepared the following points:

• The edge device is set up with a TeamViewer IoT Agent.
• Your login credentials for the edge device (user name, and password).
• Your TeamViewer credentials.
• A tool to access the edge device remotely via ssh (e.g. Putty).

Assign the Edge Devices to Your TeamViewer Account

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the top menu click Assignment token.

3. In the popup click Reveal to see the token.

4. Log in to the Edge Device and use your credentials by using a ssh-tool.
5. Assign the Edge Device to your TeamViewer Account. In the terminal type in the following command and press return. Replace TOKEN with the token from the previous step.

sudo teamviewer-iot-agent assign -t TOKEN --accept-license

The TeamViewer IoT Agent acts as a centralized hub bringing the TeamViewer IoT solution to your IoT network. To securely integrate your IoT devices and sensors, you must create trusted Clients (see TeamViewer IoT Agent MQTT API) which can communicate with the TeamViewer IoT Agent.

Remote Clients allows you to extend your clients to trusted remote devices rather than being limited to the localhost (the device hosting the agent).  The following procedure will illustrate how to enable Remote Clients and how to use the TeamViewer IoT Agent MQTT API to remotely create clients and send your sensor data for monitoring and visualization.

What you will need

Make sure that you have prepared the following points:

• Access the Edge Device via Remote Terminal.

Setup

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Enable Remote Connections. In the terminal type in the following command and press return.

teamviewer-iot-agent enable remoteClientProvision

3. From your Edge Device, create a client by generating a trusted certificate.
   • For more information see TeamViewer IoT Agent MQTT API.
   • Replace localhost with the hostname of the device running the TeamViewer IoT Agent in the publish/subscribe examples.
   • Copy the Trusted CA Cert TeamViewerAuthority.crt, referenced in the publish/subscribe examples, to the Edge Device.
4. Once your Client has been created, disable the Remote Client Provisioning access to prevent unauthorized access from other hosts on the network.  Disabling Remote Client Provisioning only allows certificate based secure access from remote hosts. In the terminal type in the following command and press return.

teamviewer-iot-agent disable remoteClientProvision

5. Enable remote data for clients to securely connect to the TeamViewer IoT Agent to send data. In the terminal type in the following command and press return.

teamviewer-iot-agent enable remoteData

6. From your Edge Device, securely register metrics and push data to the TeamViewer IoT Agent.
   • For more information see TeamViewer IoT Agent MQTT API.
   • Replace localhost with the hostname of the device running the TeamViewer IoT Agent in the publish/subscribe examples.
7. To provision additional remote clients enable the Remote Client Provisioning. In the terminal type in the following command and press return.

teamviewer-iot-agent enable remoteClientProvision

Disable Remote Client Provisioning

For security purposes, disable the Remote Client Provisioning access to prevent unauthorized access from other hosts on the network. Disabling Remote Client Provisioning only allows certificate based secure access from remote hosts.

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. In the terminal type in the following command and press return.

teamviewer-iot-agent disable remoteClientProvision

Disable Remote Data

For security purposes, when remote connections are no longer needed for Clients to send data, disable Remote Data.

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. In the terminal type in the following command and press return.

teamviewer-iot-agent disable remoteData

Disable Remote Clients

For security purposes, when remote connections are no longer needed for client provisioning or sending data, disable all Remote Connections.

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. In the terminal type in the following command and press return.

teamviewer-iot-agent disable remoteClients

TeamViewer IoT offers a new supporting platform: TeamViewer IoT Agent on FreeBSD.

• Prerequisites for your IoT Installation
• About FreeBSD / System Requirements
• How to Get Started
• FreeBSD Configuration
• Use Cases for App Control
• Use Cases for Files Transfer
• Troubleshooting of IoT Agent on FreeBSD
• Important File Locations

• TeamViewer IoT version 2.19.5 or higher is installed
• You have created an assignment token

FreeBSD is a free and open-source Unix-like operating system descended from the Berkeley Software Distribution (BSD). According to FreeBSD policies, packages are built by admins for their machines.

This operating system is currently only supported by the teamviewer-iot-agent.

Currently, we support the following connectivity feature sets:

• Remote App Control
• File Transfer

Please see the chapter “General Delivery Flow” to see how a teamviewer-iot-agent package can be created.

Supported Operating System Specification:

Quickstep:

Simply install the TeamViewer IoT Agent with the following command line:

git clone https://github.com/teamviewer/FreeBSD_port_teamviewer-iot-agent.git /tmp/teamviewer-port/
cd  /tmp/teamviewer-port
make install

1. 1. 1. Create the package
         1. Download the ports package from the TeamViewer public GitHub repository: https://github.com/teamviewer/FreeBSD_port_teamviewer-iot-agent
         2. Unpack or clone the ports package or files under path <x>, e.g. /tmp/teamviewer-port/:

            git clone https://github.com/teamviewer/FreeBSD_port_teamviewer-iot-agent.git /tmp/teamviewer-port/

         3. Run make package inside the unpacked/checked out ports folder <x>. The resulted artifact is placed in the subdirectory work/pkg and uses the naming scheme teamviewer-iot-agent-<version>.txz

            cd  /tmp/teamviewer-port
            make package

         4. (end customer) Install the FreeBSD package with the following command:

            pkg add /tmp/teamviewer-port/work/pkg/teamviewer-iot-agent-.[txz/pkg]

2. Create the EULA acceptance flow
   1. Customers who have their permanent residence in the Republic of Korea (ROK) require a separate EULA confirmation flow.
   2. Include the EULA and DPA to be accepted during the provision flow. Important note: The agent will not start without the confirmation of the EULA!
      
      Note: Once the EULA has been accepted:
      – The IoT agent can and should be started with service teamviewer_iot_agent start.
      The assignment does not work without the agent having been started!
3. Assignment
   Prequisite:
   • You have created an assignment token (please see the topic “Create an assignment token“)
   • Please make sure that you have started the agent service beforehand

   Use the following command:

   /usr/local/libexec/teamviewer-iot-agent assign --api-token  --group
    --alias 

   As a result, it will print out the following message displaying the name of the new manager and the group where the device is in:

   Device is assigned to  and located in the <group name> (default = IoT) group.
   Device will be accessible and managed by this account.
   Assignment can be removed using 'unmanage' command.

   If the token assignment was not successful, an error message will be displayed and an exit code other than 0 is returned.

The configuration of the FreeBSD can happen in different stages.

TeamViewer delivers the binary files as well as a recipe to create the package. The FreeBSD platform expects that the admin builds the package for his systems on his own.  The following steps are not required if somebody just wants to get started.

Stage A – Packaging

Every customer can build his own package with the default configuration they want to have:

1. Unpack the dist files package (not the ports package) and changes the teamviewer-iot-agent.conf located at ./etc/teamviewer-iot-agent/.This configuration file is logically the same as the file used for OEM packages on Linux. In this article, we will not describe each setting, as they are described in the file itself.
2. After the configuration file has been changed, the whole unpacked dist folder needs to be packaged again using .tar.gz.
3. A change in the configuration file require the customer to rerun the creation of the checksum: For that the customer should unpack the ports file and run

   setenv TV_PORT_MASTER_SITES 
   sudo --preserve-env=TV_PORT_MASTER_SITES make makesum
   sudo --preserve-env=TV_PORT_MASTER_SITES make package

   Result: The package has the custom configuration included and can be installed on the target system.

Stage B – After the installation

It is mandatory to accept the EULA (see info box above).

The FreeBSD package will be shipped with agent.conf located at /etc/teamviewer-iot-agent/.

This configuration file is logically the same as the file used for OEM packages on Linux. In this article, we will not describe each setting, as they are described within the file. This file can be changed even if the agent is already running. A restart of the agent is required, so the changes are applied to the agent.

In this case the same default behavior is applied for App Control as for the Linux version. This means that port 80 of localhost without TLS will be initially accessed. The configuration of this feature should be done via the agent.conf described on the page Configuration of a FreeBSD Package.

EnableAppControl
= true

EnableAppControl
= false

[int32] EnableAppControl =
1

[int32] EnableAppControl =
0

[strng] AppControlWebServerIPAddress = "192.168.12.2"

[int32] AppControlWebServerIPAddress = 443

AppControlEnableNavigationPanel = true

AppControlEnableNavigationPanel = false

[int32] AppControlEnableNavigationPanel = 1

[int32] AppControlEnableNavigationPanel = 0

[strng] AppControlUrlSuffix
= "/ui"

AppControlEnableTLS = true

AppControlEnableTLS = false

[int32] AppControlEnableTLS = 1

[int32] AppControlEnableTLS = 0

The configuration of this feature should be done via the agent.conf described on the page Configuration of a FreeBSD Package.

Possible values for File Transfer configuration are

AccessControlType = 3

AccessControlType = 10

FileTransferAccessControl = 2

FileTransferAccessControl = 0

FileTransferAccessControl = 1

The IoT agent is writing its logfile in /var/log/teamviewer-iot-agent/teamviewer-iot-agent_logfile.log

Further information about the current package are available at /etc/defaults/teamviewer-iot-agent.conf

A – The agent is not starting

After the installation it is mandatory to approve the EULA of TeamViewer. As long as the EULA is not accepted, the IoT agent will not start.

Although you might have called

service teamviewer_iot_agent start

and the info file shows that the IoT agent is online, even so the output of the start command shows

Starting teamviewer_iot_agent

The log file will also indicate the missing EULA acceptance with an entry of the format:

2021/11/29 09:50:05.555 8794 100830 0!! [Beehive] EULA not accepted. Aborting., Errorcode=2

The EULA has to be accepted via:

/usr/local/libexec/teamviewer-iot-agent/teamviewer-iot-agent eula

Or, if it should be done programmatically without user interaction:

/usr/local/libexec/teamviewer-iot-agent/teamviewer-iot-agent eula -y

B – File transfer is not available

The file transfer is deactivated by default in our FreeBSD package.

It can be activated via the FileTransferAccessControl setting in the agent.conf. Further description can be found on File Transfer on FreeBSD.

C – After an update of the agent, the new behavior/changes are not visible.

On FreeBSD it is expected that the administrator is performing the switch of the loaded binaries. This means, that during the update process, a running IoT agent is not stopped and a the new one is loaded. This has to be done by the administrator.

To solve this issue, simply restart the IoT agent via:

service teamviewer_iot_agent
restart

This overview contains online locations where TeamViewer IoT provides the necessary files.

You can log in to the IoT Management Console. The IoT Management Console lists all your devices, connected sensors and many more information.

To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.

The IoT Management Console has 3 sections. The left menu , the top menu and the main screen .

Hide Menus

Hiding the left menu is helpful e.g. when you want to increase the displayed size of the main screen for presentations.

From the left menu click the menu symbol to show or hide the menu.

Change the Display Language

From the top menu select a language.

Log out

From the top menu click your user name then click Log out.

The TeamViewer IoT Edge Management feature provides real-time visualization of the device, includes a user-friendly GUI for managing and monitoring sensors, metrics and MQTT API clients. Also allows building GUI to control sensors and actuators remotely.

Edge Management is an extension to the TeamViewer IoT Agent.

After the Edge Management is enabled, you can use TeamViewer Client to remotely create secure applications, register sensors and metrics, and view real-time streaming data.

Remote control of edge devices is only supported by TeamViewer Client for Windows.

The TeamViewer IoT Edge Management feature provides real-time visualization of the device, includes a user-friendly GUI for managing and monitoring sensors, metrics and MQTT API clients. Also allows building GUI to control sensors and actuators remotely.

For more information on Docker see https://www.docker.com/.

What you will need

Make sure that you have prepared the following points:

• Access the Edge Device via Remote Terminal.

Enable

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. In the terminal type in the following command and press return.

sudo teamviewer-iot-agent install edge-management

3. To start the application on default port 80, type in the following command and press return.

sudo teamviewer-iot-agent start edge-management

Update the Edge Management to keep the application secure.

What you will need

Make sure that you have prepared the following points:

• Access the Edge Device via Remote Terminal.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.

Update

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Update the Edge Management. In the terminal type in the following command and press return.

sudo teamviewer-iot-agent update edge-management

What you will need

Make sure that you have prepared the following points:

• Access the Edge Device via Remote Terminal.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.

Disable

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Disable the Edge Management. In the terminal type in the following command and press return.

sudo teamviewer-iot-agent uninstall edge-management

What you will need

Make sure that you have prepared the following points:

• Access the Edge Device via Remote Terminal.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.

Change Port

To change the default port you need to restart the Edge Management.

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Stop the Edge Management. In the terminal type in the following command and press return.

sudo teamviewer-iot-agent stop edge-management

3. Restart the Edge Management. In the terminal type in the following command and press return. Replace the value 8080 to your preferred port.

sudo teamviewer-iot-agent start edge-management --port=8080

The TeamViewer IoT Solution enables you to access your edge device remotely.

There are several ways to access your edge device remotely:

• Access the Edge Device via Remote Terminal to implement basic setup and maintenance on your edge device.
• Access the Edge Device via Remote Screen to use the remote graphical user interface (interactive or non-interactive) on your edge device.
• Access the Edge Device via Remote AppControl using a web page on the edge device. The web page needs a running server (e.g. Apache).
• Grab Remote Screen for QT Applications using a QT application (see https://www.qt.io/) on the edge device.

The access via Remote Screen and its control depends on the setup of the remote control feature on the edge device:

The Remote Screen via X11 allows you to see what is displayed on the screen of the edge device and to control it. This is helpful to maintain the device without connecting a monitor or other peripherals.

What you will need

Make sure that you have prepared the following points:

• The edge device is set up with a TeamViewer IoT Agent.
• Access the Edge Device via Remote Terminal.
• Basic knowledge of the editor nano.

Setup

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Install the virtual framebuffer. Type in the following command and press return.

sudo apt update && sudo apt install xvfb -y

3. Run the virtual framebuffer with a display port 1 resolution of 1280x1024 pixels and a color depth of 24 bit. Type in the following command and press return.

Xvfb -ac :1 -screen 0 1280x1024x24 & 

4. To run the virtual framebuffer on every reboot of the edge device modify the global crontab file with the nano editor.

sudo nano /etc/crontab

5. Add the following lines at the end of the file:

#X virtual desktop
@reboot pi Xvfb -ac :1 -screen 0 1280x1024x24

6. Save the file and close the nano editor.
7. To use the display port on every login to the edge device modify the personal session file with the nano editor.

sudo nano /home/pi/.bashrc

8. Add the following lines at the end of the file:

#run export display
export DISPLAY=:1

9. Save the file and close the nano editor.
10. Activate the modifications. Type in the following command and press return.

source ~/.bashrc

11. Restart the TeamViewer IoT Agent. Type in the following commands and press return:

sudo teamviewer-iot-agent configure set EnableRemoteScreen 1

sudo teamviewer-iot-agent configure set RemoteScreenChannels "X11"

sudo teamviewer-iot-agent restart

The setup is complete. You can access the edge device with your TeamViewer Client now.

When accessing the edge device, the user who works on said device gets a notification. You can customize the notification.

Troubleshoot

No screen / the wrong screen is displayed

After accessing the edge device via TeamViewer client no screen or the wrong screen is displayed.

This occurs when your device uses multiple displays.

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Replace 12 with the correct display number. Type in the following commands and press return:

 sudo teamviewer-iot-agent configure set RemoteScreenChannels "X11:12:pi"

sudo teamviewer-iot-agent restart

The Remote Screen via Framebuffer allows you to see what is displayed on the screen of the edge device. This is helpful to monitor a user remotely.

What you will need

Make sure that you have prepared the following points:

• The edge device is set up with a TeamViewer IoT Agent.
• Access the Edge Device via Remote Terminal.

Setup

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. To enable the Remote Screen type in the following command and press return.

sudo teamviewer-iot-agent configure set -p [int32] EnableRemoteScreen 1

3. Find the framebuffer number and write it down (see example below). Type in the following command and press return.

ls /dev/ | grep fb

4. Replace fb0 with the found framebuffer number. Restart the TeamViewer IoT Agent. Type in the following commands and press return:

sudo teamviewer-iot-agent configure set -p [strng] RemoteScreenChannels "FBD:/dev/fb0"

sudo teamviewer-iot-agent restart

The setup is complete. You can access the edge device with your TeamViewer Client now.

When accessing the edge device, the user who works on said device gets a notification. You can customize the notification.

Customize the notifications on the user remote screen.

Notifications are shown to users when their device is accessed remotely. To avoid that users can be monitored without being notified a logo is shown on the local screen of the edge device.

You can customize the position of the logo.

What you will need

Make sure that you have prepared the following points:

• The edge device is set up with a TeamViewer IoT Agent.
• Access the Edge Device via Remote Terminal.
• Basic knowledge of the editor nano.

Positioning the Logo

To change the position of the logo modify the global configuration file. Use one of the following values:

1. Access the edge device Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. To modify the global configuration file open the file with nano:

sudo nano /var/lib/teamviewer-iot-agent/global.conf

3. Scroll to the end of the file and add the following lines. Replace TopLeft with one of the values for the logo position.

#change logo position on user screen
[strng] RemoteScreenLogoPosition = "TopLeft"

4. Save the file and exit nano.

The Remote AppControl lets you access a custom user interface for any device or system that comes without a native graphical user interface. You’ll need to create a user interface as an HTML page which is stored directly on the device.

In this task you’ll need to install a web server to access the web page.

This setup uses a Raspberry Pi with the operating system Raspbian OS. Apache is used as the web server.

The example below is a web page of a digital twin of a pump. So, you can control and read data from the pump directly with TeamViewer Remote AppControl.

What you will need

Make sure that you have prepared the following points:

• Access the Edge Device via Remote Terminal.
• Basic knowledge of how to configure a web server.
• Basic knowledge of how to create web pages (for example see https://www.w3schools.com/html/).

Web servers

A web server can be installed and configured on the Edge Device. Various web servers are available, with different advantages for usage. Below are listed several guides for different web servers installations.

• Apache Web Server setup guide: https://www.raspberrypi.org/documentation/remote-access/web-server/apache.md
• NGINX Web Server setup guide: https://www.raspberrypi.org/documentation/remote-access/web-server/nginx.md
• Python Web Server setup guide: https://projects.raspberrypi.org/en/projects/python-web-server-with-flask
• Node.JS Web Server setup guide: https://tutorials-raspberrypi.com/setup-raspberry-pi-node-js-webserver-control-gpios/

Install the Web Server

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Update your software list and install the web server. In the terminal type in the following command and press return.

sudo apt update && sudo apt install apache2 -y

3. To verify the correct installation use Access the Edge Device via Remote AppControl.

The window shows the default web page of the Apache Web Server. You need to create your web page or put your HTML files on the device depending on your requirements.

For example, see https://www.w3schools.com/html/ and learn how to create web pages for your Edge Device.

The Remote Terminal allows you to maintain the device without connecting a monitor or other peripherals.

What you will need

Make sure that you have prepared the following points:

• The edge device is set up with a TeamViewer IoT Agent.
• The edge device is connected to the internet.
• Your PC is set up with the TeamViewer Client for Windows.
• Your login credentials for the edge device (user name, and password).

Access

1. On your PC open the TeamViewer Client and log in.
2. On the left side open the Computers & Contacts tab.
3. Double-click the device.
   The Control Window opens and the connection will be established.
4. In the Control Window on the top open the Remote Terminal tab.
5. Type in your user password and press enter.

You are now logged on the edge device.

Disconnect from Remote Terminal

In the terminal type in the following command and press enter:

exit

The Remote Screen allows you to see what is displayed on the screen of the edge device.

The access and the control depend on the setup of the remote screen feature on the edge device:

What you will need

Make sure that you have prepared the following points:

• The edge device is set up with the Remote Screen (via X1 or via Framebuffer).
• The edge device is connected to the internet.
• Your PC is set up with the TeamViewer Client.

Access

1. On your PC open the TeamViewer Client and log in.
2. On the left side open the Computers & Contacts tab.
3. Double-click the device.
   The Control Window opens and the connection will be established.
4. In the Control Window on the top open the Remote Screen tab.

The Remote AppControl lets you access a custom user interface for any device or system that comes without a native graphical user interface. You’ll need to create a user interface as an HTML page which is stored directly on the device.

If you have a Premium or Corporate License linked to your TeamViewer account, you can also log sessions for reporting via the IoT Management Console.

You can use the New Browser Engine Support for IoT Devices. This allows your remote app (web page) to use its new technologies.

What you will need

Make sure that you have prepared the following points:

• The edge device is connected to the internet.
• A web page is set up on the edge device.
• Your PC is set up with the TeamViewer Client.

Access

1. On your PC open the TeamViewer Client and log in.
2. On the left side open the Computers & Contacts tab.
3. Double-click the device.
   The Control Window opens and the connection will be established.
4. In the Control Window on the top open the Remote AppControl tab.

This article applies to IoT users who are accessing the web interfaces of the IoT devices using the TeamViewer application

Overview

TeamViewer uses browser engines to render the web content of the Remote AppControl tab in the IoT remote sessions.
Starting with version 15.9, TeamViewer will support the Microsoft Edge WebView2 technology for the IoT Devices.

Microsoft Edge WebView2 is a Chromium-based web control that can handle web technologies not being supported by IE.

Requirements

• A Windows (7, 8.1, 10) machine, with TeamViewer v15.9 or higher.
• A Microsoft Edge WebView2 Runtime installed.
• An IoT Device with a running web application.

How to Activate the New Browser Engine

Before you switch to the new browser engine please make sure that you have the Microsoft Edge WebView2 Runtime installed on your machine. If it is already installed you can skip this step.

There is a chance that your machine already has this component as it could come with other applications using WebView2 technology.

Open TeamViewer Client and navigate to Extras->Options->Advanced->Show advanced options->IoT options. Enable the checkbox for the Use Microsoft Edge WebView2 for Remote AppControl.

On your next connection to the IoT device, Microsoft Edge WebView2 will be used to display the web content.

Below is an example of using the old and the new browser engines for the Remote AppControl tab.

Sensors play a vital role in any IoT Solution. Sensors on your edge device can help you to monitor your edge devices’ health. They also can help you to monitor the entities you attach a sensor to (e.g. robot arms).

To use sensors make sure TeamViewer Edge Management is enabled.

Three basic steps are needed to integrate sensors into your IoT Solution:

1. Connect a sensor physically to your edge device (for example, see Connect the Sensors to the Starter Kit).
2. Assign the sensor (and its metrics) to your TeamViewer Account.
3. Use sensor metrics for monitoring (e.g. widgets) and/or to set alerts and notifications.

Sensor metrics and data is handled as defined by the TeamViewer IoT MQTT API. You will need to then push your sensor data as specified in the MQTT API Push Metric Values section to visualize it in real-time.

The Easy Setup for adding sensors is intended to provide you with an intuitive and easy experience which will lead you through the setup steps in adding the sensors.

The Easy Setup contains 3 basic steps. Follow the sections in this article:

1. Generate a Sensor Script
2. Enable the Sensor Script on the Edge Device
3. Assign the Sensor Script to the Edge Device

The generated Sensor Script is a template.

The Sensor Script prints metric values of a sensor in JSON format and each metric is described as a variable which gets a random value in between 1 and 20.
If you don’t have a ready script, you might need to search for tutorials on how to read your sensor data, find a library or script that works with your sensor and make sure that your script’s output prints the JSON formatted example as presented in the template.
Then place the ready script on the edge device and provide the full path information into the configuration page.

There are thousands of different sensors in the world. Some of them would need special libraries or custom development to get a data from. If you have trouble with the setup of sensors, contact TeamViewer.

What you will need

Make sure that you have prepared the following points:

• Your TeamViewer credentials.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.
• Access the Edge Device via Remote Terminal.
• File Transfer is enabled (see Enable File Transfer).
• A Sensor is connected to the device.
• The edge device is connected to the internet.

Generate a Sensor Script

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Devices.
3. On the right side from the dropdown menu select Add Sensor.

4. Click Easy Setup.

5. From the dropdown menu select the device with the sensor you would like to add.
6. Type in a unique sensor name.
7. Click to add a metric. To configure the metric provide a metric name and an unique ID. The fields Value Type and Value Unit are optional. (When a metric becomes superfluous click to remove it.)

8. When all metrics are configured click Download the generated Template.

The downloaded zip-file contains template examples for Python and Bash.

9. On your local PC extract the zip-file.
10. Pick one of the extracted files as your Sensor Script.

Keep the Management Console open and continue with Enable the Sensor Script on the Edge Device.

Enable the Sensor Script on the Edge Device

In this task you’ll need to transfer the previously downloaded Sensor Script to the Edge Device. Then you’ll give the Sensor Script fitting permissions to be executed.

1. Transfer the Sensor Script to your Edge Device by using the Transfer Files feature. Remember the full path (FULLPATH) of the Sensor Script on the Edge Device.
2. Access the edge device remotely (Access the Edge Device via Remote Terminal).
3. Give the Sensor Script fitting permissions. In the terminal type in the following command and press return. Replace FULLPATH with the full path from the previous step.

sudo chmod +x FULLPATH

Assign the Sensor Script to the Edge Device

After you enabled the Sensor Script on the Edge Device you’ll need to continue where you left off from Generate a Sensor Script.

1. Type in the FULLPATH you remembered from Enable the Sensor Script on the Edge Device.

2. Select the frequency by which the data will be sent to the TeamViewer IoT Cloud. It can be defined in seconds or minutes.

3. To finish the Easy Setup click Add.

This example provides a quick overview of how to use the TeamViewer IoT Agent MQTT API to securely (encrypted and trusted) connect, to register sensors and metrics, to view device inventory, and to push data to the TeamViewer IoT Cloud.

For more information see TeamViewer IoT Agent MQTT API.

You will use three separate terminals to perform this example:

• Terminal 1 will be used to receive messages from the Authentication API.
• Terminal 2 will be used to publish commands to the API.
• Terminal 3 will be used to receive messages from the Registration and Data API.

What you will need

• The edge device is set up with a TeamViewer IoT Agent.
• Your login credentials for the edge device (user name, and password).
• You are logged in to the IoT Management Console. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
• A tool to access the edge device remotely via ssh (e.g. Putty).
• Advanced knowledge of Linux systems and command line operations.

Setup

1. Create Terminal 1. Log in to the Edge Device and use your credentials by using a ssh-tool.
2. Create Terminal 2. Log in to the Edge Device and use your credentials by using a ssh-tool.
3. Create Terminal 3. Log in to the Edge Device and use your credentials by using a ssh-tool.
4. Install the Mosquitto Clients. In the Terminal 1 type in the following command and press return.

sudo apt-get install mosquitto-clients

5. Subscribe to all Authentication and Authorization topics to receive data/messages from the TeamViewer IoT Agent MQTT API. In the Terminal 1 type in the following command and press return.

mosquitto_sub -h localhost -p 18883 --cafile /var/lib/teamviewer-iot-agent/certs/TeamViewerAuthority.crt -t /#

6. Generate a Certificate Signing Request and Private Key. In the Terminal 2 type in the following command and press return. Type in your specific information when prompted (e.g. company name).

openssl req -nodes -new -newkey rsa:2048 -sha256 -out csr.pem

Two files are created:

• privkey.pem (your private key file will be used for publishing / subscribing to topics)
• csr.pem (this file will be presented to the TeamViewer IoT Agent to generate a certificate)

7. Publish the Certificate Signing Request (csr.pem) to the API to receive a TeamViewer IoT Agent generated and signed certificate. In the Terminal 2 type in the following command and press return.

mosquitto_pub -h localhost -p 18883 --cafile /var/lib/teamviewer-iot-agent/certs/TeamViewerAuthority.crt -t /v1.0/createClient -m < (echo -n """ && cat csr.pem && echo -n """)

8. Copy the certificate content into a new file called clientCert.crt and save in the same location as your privkey.key. In the Terminal 1 type in the following command and press return. Replace path (PATH) with the path where your file privkey.key is located.

cp csr.pem PATH/clientCert.crt

9. Parse the unique client Id to be used for your secure connection for all subsequent messages. Record the resulting Id for future use. In the Terminal 2 type in the following command and press return.

openssl x509 -noout -subject -in clientCert.crt -nameopt multiline | grep commonName | sed -r 's/commonName/ /g' | sed -r 's/=/ /g' | xargs | tr -d " tnr"

10. Use your private key and certificate, securely subscribe to all Registration and Data topics to receive data and messages from the TeamViewer IoT Agent MQTT API. In the Terminal 3 type in the following command and press return.

mosquitto_sub -h localhost -p 18884 --cert clientCert.crt --key privkey.pem --cafile /var/lib/teamviewer-iot-agent/certs/TeamViewerAuthority.crt -t /#

11. Verify your secure connection to the API is alive, by executing this command and verifying the message is received in Terminal 3. In the Terminal 2 type in the following command and press return.

mosquitto_pub -h localhost -p 18884 --cert clientCert.crt --key privkey.pem --cafile /var/lib/teamviewer-iot-agent/certs/TeamViewerAuthority.crt -t /v1.0/c6c5e217089743da8ec3f1d256fa99c2/ping -m  "{ "request" : "Some Message" }"

12. Display your Inventory, which will be displayed in Terminal 3. The Inventory should be empty ([]) as we haven’t registered any sensors yet. In the Terminal 2 type in the following command and press return.

mosquitto_pub -h localhost -p 18884 --cert clientCert.crt --key privkey.pem --cafile /var/lib/teamviewer-iot-agent/certs/TeamViewerAuthority.crt -t /v1.0/c6c5e217089743da8ec3f1d256fa99c2/sensor/list -m "{}"

13. Register a new sensor called Temperature1. The result will be displayed in Terminal 3. In the Terminal 2 type in the following command and press return. Record the sensordId from the Terminal 3 output as it will be needed later.

mosquitto_pub -h localhost -p 18884 --cert clientCert.crt --key privkey.pem --cafile /var/lib/teamviewer-iot-agent/certs/TeamViewerAuthority.crt -t /v1.0/c6c5e217089743da8ec3f1d256fa99c2/sensor/create -m  "{ "name" : "Temperature1" }" 

14. Register three metrics for your Temperature1 sensor. The result will be displayed in Terminal 3. In the Terminal 2 type in the following command and press return. Record the metricId for each Metric from the Terminal 3 output as it will be needed later.

mosquitto_pub -h localhost -p 18884 --cert clientCert.crt --key privkey.pem --cafile /var/lib/teamviewer-iot-agent/certs/TeamViewerAuthority.crt -t /v1.0/c6c5e217089743da8ec3f1d256fa99c2/sensor/d43862fd65ac4a0f9054cfe1749cad82/metric/create -m "{"metrics" : [{"matchingId" : "1", "valueUnit": "NoSI.Dimensionless.PERCENT", "name" : "CPUUsage" },{"matchingId" : "2","valueUnit": "NoSI.Dimensionless.PERCENT", "name" :"CPUIdle" }, {"matchingId" : "3", "valueType" : "integer" , "valueAnnotation": "goods per minute", "name" : "ShopFloor1"}]}"

15. Display details of one of your metrics, which will be displayed in Terminal 3. In the Terminal 2 type in the following command and press return.

mosquitto_pub -h localhost -p 18884 --cert clientCert.crt --key privkey.pem --cafile /var/lib/teamviewer-iot-agent/certs/TeamViewerAuthority.crt -t /v1.0/c6c5e217089743da8ec3f1d256fa99c2/sensor/d43862fd65ac4a0f9054cfe1749cad82/metric/226ede40e42b458d88d09414fa44e7bf/describe -m "{}"

16. Display your Inventory, which will be displayed in Terminal 3. The Inventory should be consistent with the sensor and metrics you created. In the Terminal 2 type in the following command and press return.

mosquitto_pub -h localhost -p 18884 --cert clientCert.crt --key privkey.pem --cafile /var/lib/teamviewer-iot-agent/certs/TeamViewerAuthority.crt -t /v1.0/c6c5e217089743da8ec3f1d256fa99c2/sensor/list -m "{}"

17. From the IoT Management Console navigate to Metrics and verify the sensor and metric information is consistent with the information you registered with the API.
18. Update the name of your sensor to Temperature2. The result will be displayed in Terminal 3. In the Terminal 2 type in the following command and press return.

mosquitto_pub -h localhost -p 18884 --cert clientCert.crt --key privkey.pem --cafile /var/lib/teamviewer-iot-agent/certs/TeamViewerAuthority.crt -t /v1.0/c6c5e217089743da8ec3f1d256fa99c2/sensor/d43862fd65ac4a0f9054cfe1749cad82/update -m "{ "name" : "Temperature2" }"

19. From the IoT Management Console navigate to Metrics and verify the sensor has been updated.
20. Display your Inventory, which will be displayed in Terminal 3. The Inventory should display the updated the sensor. In the Terminal 2 type in the following command and press return.

mosquitto_pub -h localhost -p 18884 --cert clientCert.crt --key privkey.pem --cafile /var/lib/teamviewer-iot-agent/certs/TeamViewerAuthority.crt -t /v1.0/c6c5e217089743da8ec3f1d256fa99c2/sensor/list -m "{}"

21. Delete a metric from your Sensor. In the Terminal 2 type in the following command and press return. In this example the metric with the metricId 9712270f8fd04c2baab6a2409b3e4b9d will be deleted.

mosquitto_pub -h localhost -p 18884 --cert clientCert.crt --key privkey.pem --cafile /var/lib/teamviewer-iot-agent/certs/TeamViewerAuthority.crt -t /v1.0/c6c5e217089743da8ec3f1d256fa99c2/sensor/d43862fd65ac4a0f9054cfe1749cad82/metric/delete -m "{"metrics": [{"metricId" : "9712270f8fd04c2baab6a2409b3e4b9d" }]}"

22. Send data values for the two remaining metrics. The result will be displayed in Terminal 3. In the Terminal 2 type in the following command and press return.

mosquitto_pub -h localhost -p 18884 --cert clientCert.crt --key privkey.pem --cafile /var/lib/teamviewer-iot-agent/certs/TeamViewerAuthority.crt -t /v1.0/c6c5e217089743da8ec3f1d256fa99c2/sensor/d43862fd65ac4a0f9054cfe1749cad82/metric/pushValues -m "{ "metrics": [ {"value" : 21, "metricId" : "226ede40e42b458d88d09414fa44e7bf" }, {"value" : 215, "metricId" : "520b4d8854454e0ea3a4f9a225afb862" } ] }"

23. From the IoT Management Console navigate to Metrics and pin the two metrics to the dashboard (See Add A Widget).
24. From the IoT Management Console navigate to Dashboard and verify the two new widgets with the created metrics.

It is effortless to monitor your sensor network via TeamViewer IoT. This article describes the integration approach to monitor OPC UA server node values. For more about OPC UA reference the OPC Foundation (see https://opcfoundation.org/).

The setup contains three basic steps. Follow the sections in this article:

1. Install software dependencies
2. Download and extract the OPC UA Connector
3. Integrate the OPC UA Monitoring Script with the TeamViewer IoT Agent

What you will need

Make sure that you have prepared the following points:

• Access the Edge Device via Remote Terminal.
• Your TeamViewer credentials.
• The edge device is set up with a TeamViewer IoT Agent (Version 1.1.12 or newer) and TeamViewer Edge Management is enabled.
• The edge device is connected to the internet.
• Advanced knowledge of Linux systems, command line operations, Python 3 and OPC UA.
• Basic knowledge of the editor nano.

Install software dependencies

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Install Python 2 or Python 3 (see https://www.python.org/downloads/).

3. Update the python libraries pip, setuptools and wheels. In the terminal type in the following command and press return.

python -m pip install --upgrade pip setuptools wheel

4. Install the python library freeopcua. In the terminal type in the following command and press return.

pip install freeopcua

Download and extract the OPC UA Connector

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Download the connector. In the terminal type in the following command and press return.

wget https://download.teamviewer-iot.com/connectors/teamviewer-iot-opcua/1.0.0/teamviewer_iot_opcua-1.0.0.tar.gz

2. Create a new folder and extract the downloaded connector. In the terminal type in the following commands and press return. Record the path (PATH) where you extracted the connector.

sudo mkdir -p /usr/local/teamviewer-iot-agent/monitoring/

tar -xzvf teamviewer_iot_opcua-1.0.0.tar.gz -C /usr/local/teamviewer-iot-agent/monitoring/opc-ua

Integrate the OPC UA Monitoring Script with the TeamViewer IoT Agent

The TeamViewer IoT Agent includes its system Monitoring Configuration File (see JSON Schema for Custom Plugin Connector). Extend the configuration file to include the OPC UA monitoring script.

The Monitoring Configuration File is located at: /var/lib/teamviewer-iot-agent/system_monitors.conf.

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Open the Monitoring Configuration File with the editor nano. In the terminal type in the following command and press return.

sudo nano /var/lib/teamviewer-iot-agent/system_monitors.conf

For each OPC UA sensor you want to integrate, append its registration information to the configuration file. Reference the example file below and replace the placeholders with your OPC UA node details.

Make sure to replace the value of monitoringService with the path (PATH) from the of the extracted connector from step Integrate the OPC UA Monitoring Script with the TeamViewer IoT Agent.

3. Save the file and close the nano editor.
4. Restart the TeamViewer IoT Agent to reload the configuration file. In the terminal type in the following command and press return.

teamviewer-iot-agent restart

5. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
6. From the IoT Management Console navigate to Metrics and verify the newly integrated sensors and metrics are updated.
7. Optional: From the IoT Management Console navigate to Metrics and pin the two metrics to the dashboard (See Add A Widget).

Example Monitoring Configuration File

{
    "sensors": [
        {
            "name": "opcua_node_aa",
            "monitoringService": "python /usr/local/teamviewer-iot-agent/monitoring/opc-ua/opc_ua_connect.py",
            "monitoringParams": "--url opc.tcp://myopcuahost:26543 --nodeId "opcua_node_id" --frequency 2",
            "metrics": [
                {
                    "name": "opcua_node_id",
                    "key": "opcua_node_id",
                    "valueType": "double",
                    "valueAnnotation": ""
                }
            ]
        },
        ...
    ]
}

For more information about the schema of the Monitoring Configuration File see JSON Schema for Custom Plugin Connector.

The TeamViewer IoT Log Parser Connector easily extracts & integrates sensor data from your log files.

The Log Parser Connector is generic, in that, it can be used to parse any log.  For the context of this article, it is assumed your IoT sensor values are written to a log file which you would like to connect to the TeamViewer IoT Agent.

The setup contains two basic steps. Follow the sections in this article:

1. Download and install the Log Parser Connector
2. Integrate the Log Parser Connector with the TeamViewer IoT Agent

For more information about configuration and syntax see Configuration and Syntax of the TeamViewer Log Parser Connector.

What you will need

Make sure that you have prepared the following points:

• Python 3 is installed on the Edge Device (see https://www.python.org/downloads/).
• Access the Edge Device via Remote Terminal.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.
• The edge device is connected to the internet.
• Basic knowledge of the editor nano.

Download and install the Log Parser Connector

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Download the Log Parser Connector. In the terminal type in the following command and press return.

wget  https://download.teamviewer-iot.com/connectors/teamviewer-iot-log-parser/1.0.0/teamviewer_iot_log_parser-1.0.0.tar.gz

3. Upon completion of the download, extract the contents of the connector. In the terminal type in the following commands and press return:

sudo mkdir -p /usr/local/teamviewer-iot-agent/monitoring/

tar -xzvf teamviewer_iot_log_parser-1.0.0.tar.gz -C /usr/local/teamviewer-iot-agent/monitoring/

4. Install the Log Parser Connector. In the terminal type in the following command and press return.

cd teamviewer_iot_log_parser-1.0.0 python3 setup.py install

5. Verify the installation was successful by identifying a log file to parse and using the following command to parse a string. In the terminal type in the following command and press return. Replace logFilePath & justTextorRegex with the path of your log file and a string to search for, respectively.

teamviewer_iot_log_parser -f logFilePath --regex justTextOrRegex

Integrate the Log Parser Connector with the TeamViewer IoT Agent

The TeamViewer IoT Agent includes its own system monitoring configuration file. This configuration file will be extended to include the Log Parser configuration.

For each sensor you want to integrate, append its registration information to the configuration file. Reference the Log Parser Connector Template or the Examples and replace the placeholders with your sensor details.

1. To modify the configuration file open the file with nano:

nano /var/lib/teamviewer-iot-agent/system_monitors.conf

2. Modify the configuration file as needed.
3. Save the file and exit nano.
4. Restart the IoT Agent to reload the configuration file. In the terminal type in the following command and press return.

teamviewer-iot-agent restart

5. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
6. From the left menu select Dashboard.
7. Verify that the Sensors/Metrics added to the configuration file now appear on your Metrics tab.
8. Use a Widget to pin the metrics to your dashboard and ensure the data is being updated per the frequency specified in the config file.

The connector can be configured given the following configuration arguments:

The two modes of operation, (Matches & Metrics), each require additional parameters to be specified.

Matches

Metrics

Use the following template to add your connector configuration for each sensor to the monitoring configuration file.  The template is an example of adding a single sensor with two (2) metrics (Temperature & Humidity).

Ensure to replace the following placeholders with the specifics of your sensor.  Note:  the frequency in the template is set to 10, which will trigger the Log Parser Connector to run every 10 seconds, aggregating the values from each interval.

For more information about the JSON schema see JSON Schema for Custom Plugin Connector.

{
    "sensors": [
        {
            "name": "temperature_humidity_parser",
            "monitoringService": "python3 /usr/local/teamviewer-iot-agent/monitoring/log_parser/teamviewer_iot_log_parser.py",
            "monitoringParams": "--file /tmp/file.log  --parser metrics -–metrics temperature humidity --aggfunctions max avg –-template ':metric=.(.*?).[\s]'",
            "frequency": 10,
            "metrics": [{
                    "name": "Temperature",
                    "key": "temperature",
                    "valueType": "double",
                    "valueAnnotation": "C"
                }, {
                    "name": "Humidity",
                    "key": "humidity",
                    "valueType": "double",
                    "valueAnnotation": ""
                }
            ]
        },
        ...
    ]
}

The following examples describe use cases and their respective configuration of the Log Parser Connector as specified by the monitoringParams parameter.

Example 1

Parse a log file to retrieve the maximum value of a metric called temperature and the average value of a metric called humidity.

>> Log File (log_file.log) Contents:
some text temperature=18 some text humidity=80
some other text temperature=19 some text humidity=82 text

>> monitoringParams:
--file log_file.log --parser metrics --metrics temperature humidity --aggfunctions max avg --template=":metric=(.*?)[\s]"

>> Result:
{"temperature": 19, "humidity":81}

Example 2

Parse a log file to retrieve the number of occurrences of the string findMe.

>> Log File (log_file.log) Contents:
some text findMe some text findMe
some other text temperature=19 some findMe text humidity=82 text

>> monitoringParams: 
--file log_file.log --parser matches --regex someRegex

>> Result:
 {"count": 3}

An example template:

{
    "sensors": [
        {
            "name": "opcua_node_aa",
            "monitoringService": "python /usr/local/teamviewer-iot-agent/monitoring/opc-ua/opc_ua_connect.py",
            "monitoringParams": "--url opc.tcp://myopcuahost:26543 --nodeId "opcua_node_id" --frequency 2",
            "metrics": [
                {
                    "name": "opcua_node_id",
                    "key": "opcua_node_id",
                    "valueType": "double",
                    "valueAnnotation": ""
                }
            ]
        },
        ...
    ]
}

JSON Schema for Sensor Objects

JSON Schema for monitoringParams Objects

JSON Schema for Metric Objects

Monitoring Configuration File

After the sensor/metric is registered by the agent, the agent auto-generates the parameters sensorId and metricId and adds them as properties to the configuration file.

Monitoring Frequency

Monitoring frequency can be controlled either by the agent’s Monitoring Configuration File (parameterfrequency) or by your custom script. In the JSON Sensor (see example below), the frequency is specified by the configuration property, causing the agent to run your script every 10 seconds.

{
   "sensors": [{
		"name": "temperature_humidity_sensor1",
		"monitoringService": "/usr/local/teamvieweriot/sensors/temperature_humidity/monitor.sh",
		"monitoringParams": "sensor1 sdkCredential",
                "frequency": 10,
		   "metrics": [{
		      "name": "Temperature",
		      "key": "temperature",
		      "valueType": "double",
		      "valueAnnotation": "C"
		    }, {
	              "name": "Humidity",
		      "key": "humidity",
	              "valueType": "double",
		      "valueAnnotation": ""
		    }]
		},
		...
	]
}

There may be scenarios where the frequency of the data collection should be set by your script rather than specified in the agent’s Monitoring Configuration File. In these scenarios, the parameter frequency in the configuration file should be left blank.

Use Case: You want to monitor discrete events which don’t have a defined frequency (event-based metrics

• e.g. monitoring when a door is opened or closed
• within your custom script, you subscribe to a message queue to get door movement events and print them to stdout.

Generic example:

var queue = new Queue();
queue.openConnection();
queue.createSubscription(callback);

function callback(value) {
     print {"key":value};
}

Use Case: You want to set up high frequency monitoring (e.g. 1 second)

Although this can be done by configuring the parameter frequency in the agent’s Monitoring Configuration File, an optimal solution may be use a loop in your script to print new metric values every second.

Generic example:

var networkObject = new NetworkObject();
networkObject.openConnection();

try {
    while (true) {
    var value = networkObject.getValue();
    print {"key":value};
    sleep(1000);
    }
}
finally
{
  connection.close()
}

What you will need

Make sure that you have prepared the following points:

• Your TeamViewer credentials.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.
• The edge device is connected to the internet.

This application provides a GUI wizard for you to create secure clients and define sensors and metrics, as defined by the TeamViewer IoT MQTT API. You will need to then push your sensor data as specified in the MQTT API Push Metric Values section to visualize it in real-time.

Using the wizard, you can create new Clients or authorize existing ones.

Create New Clients

You can create new clients either automatically or by using an existing Certificate Signing Request (CSR).  To create clients using a CSR, you must upload the CSR & the associated private key.

Once a secure client has been created, you can download its credentials for use on edge devices (to easily integrate sensors on edge devices to your TeamViewer IoT Agent).

For more Information see Remote Clients.

Once a secure client has been created, you can use the wizard to define the sensors and metrics you want to connect.  The wizard will provide you with the details and a template to push the sensor’s data as described in MQTT API Push Metric Values.

Authorize Existing Clients

Any existing client will automatically appear on your clients page of the IoT Management Console. However, you must upload its Certificate credentials using the clients page, to view it in real-time.

View Data in Real-Time

Using the Metrics page of the IoT Management Console, you can view a list of all your sensor metrics and quickly view each in real-time by clicking on the metric name.

Manage Certificates

All client certificates, created by the application or uploaded by the user, are stored under:

/var/lib/docker/volumes/teamviewer-iot-edge-device-management-cert/_data

Public Key: cert-clientId.pem
Private Key: key-clientId.pem

The certificate file names contain the client Id, in case the certificates are needed on edge devices.

For more Information see Remote Clients.

A key part of managing your IoT network is being able to respond as soon as possible to events or anomalies requiring action. In this section, learn how to set up flexible notifications to easily manage your messages and alerts.

Notification are sent by channels (email or webhook). Those channels are bundled into topics. For example:

• the Topic Staff which comprises channels sending emails only to staff members
• the Topic Service which comprises channels sending emails just to service workers

To get a notification when a defined condition is met you need to create a rule. For example:

• Create a Rule with the Condition Device is offline and associate it with the Topic Staff. Staff members receive an email to turn on the edge device.
• Create a Rule with the Condition Temperature > 100 °C and associate it with the Topic Service. A service worker receives an email to check the health of the edge device.

To use rules and notifications make sure TeamViewer Edge Management is enabled and Real Time Rule Engine is enabled.

Rules

Rules are limited to the following thresholds:

• Metric Threshold type is generated based on the threshold applied on metric(s) when the specified condition is violated.
• Device Offline  type is generated based on the abnormal state of the device(s) or metric(s) (in future), for example when no data is received from a device or metric for a period more than two minutes.

See:

• Add Rule

Alarms

Each time when threshold triggers, a unique Alarm with specified severity is created. 

Alarm severity defines how important the alarm is. We support the following alarm severity levels: Warning, Minor, Major and Critical.

The maximum number of thresholds to be applied per Rule is four, equal to the number of severity levels.

All the open alarms are reflected in the Alarms list (Management Console > Alarms) and can be filtered by severity levels, type, creation time and so on. Thus, users can see metric or device specific alarms correspondingly in Devices and Metrics pages.

Notifications

A Notification topic is a communication bridge that receives notification messages triggered by Rules and sends them to Channels which are subscribed to the Topic.

See:

• Add Topic
• Add Channel

What you will need

Make sure that you have prepared the following points:

• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.
• Access the Edge Device via Remote Terminal.

Enable

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Install the Real Time Rule Engine. In the terminal type in the following command and press return.

sudo teamviewer-iot-agent install rule-engine

3. At the end of the installation, will be asked to start the Rule Engine application. Answer with YES.
4. Ensure the Real Time Rule Engine is running correctly. In the terminal type in the following command and press return.

sudo teamviewer-iot-agent info

The status of the TeamViewer IoT Agent and its extensions is listed.

After enabling the Real Time Rule Engine you can start to create rules and notifications.

Check the Status of the Real Time Rule Engine

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Check the status of the Real Time Rule Engine. In the terminal type in the following command and press return.

sudo teamviewer-iot-agent info

The status of the TeamViewer IoT Agent and its extensions is listed.

Manually enable or disable the Real Time Rule Engine

You can enable or disable the Real Time Rule Engine manually.

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).

• Enable the Real Time Rule Engine. In the terminal type in the following command and press return.

sudo teamviewer-iot-agent start rule-engine

• Disable the Real Time Rule Engine. In the terminal type in the following command and press return.

sudo teamviewer-iot-agent stop rule-engine

What you will need

Make sure that you have prepared the following points:

• Your TeamViewer credentials.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.
• The Real Time Rule Engine is enabled.
• The edge device is connected to the internet.

Adding the Rule

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Rules.
3. On the right side click Create Rule.
4. Follow the steps in the form to set up the rule:
   • Input a rule name
   • Set a rule type
   • Select one or more metrics
   • Set up the condition
   • Select one or more topics for notifications (see Add a Topic)

5. When finished click Create Rule.

Topics can be created without any Channels or being linked to Rules. In this scenario, notifications will not be sent as there are no specified Channels. You can add Channels to your Topics at any time, during or after setting up the Topic.

What you will need

Make sure that you have prepared the following points:

• Your TeamViewer credentials.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.
• The Real Time Rule Engine is enabled.
• The edge device is connected to the internet.

Adding the Topic

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Notifications > Topics.
3. On the left side click Create Topic.
4. Follow the steps in the form to set up the topic:
   • Input a topic name
   • Select one or more channels

5. Click Create.

Channels can be created without any subscribed Topics. You can subscribe to Topics at any time, during or after setting up the Channel.

Webhooks and emails need to be confirmed prior to being activated (ready for use) in order to prevent abuse of non-owned mediums.  Once a Channel is set up, a confirmation message is sent to the endpoint to allow the owner to confirm it within a 24 hour period.

What you will need

Make sure that you have prepared the following points:

• Your TeamViewer credentials.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.
• The Real Time Rule Engine is enabled.
• The edge device is connected to the internet.

Adding the Channel

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Notifications > Channels.
3. On the left side click Create Channel.
4. Follow the steps in the form to set up the topic:
   • Select a channel type
   • Input a channel name
   • Input the endpoint address (email or URL)
   • Select a time zone
   • Select one or more topics

5. Click Create.

A Webhook can be thrown when a Rule was triggered. Webhooks are sent via HTTP POST message to a specified url. The message contains JSON documents.

The examples below show Webhook message examples for your reference.

Webhook Endpoint Confirmation

{ "Type": "ChannelConfirmation", 
  "Message": "You have received this request because your webhook URL has been added to the TeamViewer IoT notification channel list. To confirm this channel visit the ConfirmationURL included in this message" , 
  "ConfirmationURL": "https://mywebhook.com/confirmation/eyJ0aW1lU3RhbXAiOjE1Mjk0NzU1OTQwNzYsImNoYW5uZWxOYW1lIjoidGVzdCIsImNoYW5uZWxUeXBlIjoxLCJ1c2VySWQiOiI1YjI3YjI5ZGY2N2VjM2Y1MTAxMDUxNjkiLCJjaGFubmVsSWQiOiI1YjI5ZjIwYTMzNmJjNzUzZjA5M2Q1YWMiLCJ0YXJnZXQiOiJodHRwczovL3dlYmhvb2suc2l0ZS8zMjBmZTQ1Mi1kNzZmLTQ0YTUtYWFiZC04MDAzYTIyZTRlZWEifQ=="
}
{
    "Type": "ChannelConfirmationResponse",
    "Message": "Webhook channel has been successfully confirmed",
    "Timestamp": 1529475719718
}
{
    "Type": "ChannelConfirmationResponse",
    "Message": "Webhook channel  has already been confimred.",
    "Timestamp": 1529475731790
}

Rule Met

<pre class="wp-block-syntaxhighlighter-code">{
  "StartTime": 1501068864000,
  "ruleName": "Default alarm policy",
  "condition": "raspberrypi.dht22.temperature < 3",
  "consecutiveChecks": 4,
  "values": {
    "raspberrypi.dht22.temperature": 2
  }
}</pre>

Rule Recovered

<pre class="wp-block-syntaxhighlighter-code">{
  "endTime": 1501068864000,
  "duration": "2 hour(s) 45 minute(s)",
  "ruleName": "Default alarm policy",
  "condition": "raspberrypi.dht22.temperature < 2",
  "consecutiveChecks": 4,
  "values": {
    "raspberrypi.dht22.temperature": 5
  }
}</pre>

Learn how to integrate alerts with https://ifttt.com/ using TeamViewer IoT Webhooks.

On the TeamViewer IoT dashboard, you can configure Webhook alerts to integrate your IoT solution with many third parties.

What you will need

Make sure that you have prepared the following points:

• Your TeamViewer credentials.
• Your IFTTT credentials. Create a user account if not already available.
• Your email account was configured with IFTTT.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.
• The Real Time Rule Engine is enabled.
• The edge device is connected to the internet.

Integrate

1. Log in to the IFTTT web page https://ifttt.com/ with your IFTTT credentials.
2. To create a new applet click New Applet.

3. To add a trigger click +this.

4. In the search field enter webhooks, then select Webhooks.

5. Type in an event name (e.g. alert). Then click Create trigger.

6. Select the service EMail and complete the template (action fields).
   The template represents the email subject and body you will receive when the webhook was triggered.

7. Click Create action.
8. Switch to MyApps > Services then click Webhooks.

9. To see your account information click Settings.
   For example:

10. To see all details of the webhook navigate to the URL with your web browser.
    Make note of the webhook URL (e.g. copy to clipboard).
    For example:

11. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
12. Add a Channel use the follwing settings:
    • Select channel type Webhook.
    • Paste into endpoint the webhook URL from above.

Use the capabilities of the TeamViewer IoT Solution to visualize and to export your data.

The easiest way to visualize your data is by using Widgets. This also allows you to export your data for further analysis.

Transfer files quickly and save to and from your edge device by enabling the feature File Transfer.

Make use of the powerful TeamViewer IoT Cloud and its ability to integrate with Amazon Web Services and many other cloud services.

Widgets display your IoT data in a comfortable way. The data can be metrics from the Edge Device (e.g. fan speed) or metrics from connected sensors (e.g. room temperature).

Use widgets to help understand your data and to track changes.

To use widgets make sure TeamViewer Edge Management is enabled.

The following types of widgets are available:

• Chart
• Number
• String
• Gauge
• Thermometer
• Map

To use widgets see:

• Add a Widget
• Configure a Widget
• Export collected Data

Add a widget to display your IoT data.

What you will need

Make sure that you have prepared the following points:

• Your TeamViewer credentials.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.
• The edge device is connected to the internet.

Adding the Widget

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Dashboard.
3. On the right side click Add Widget.

4. Setup the widget:
   • set a unique Label
   • select a widget Type
   • select the metrics
5. Click OK.

What you will need

Make sure that you have prepared the following points:

• Your TeamViewer credentials.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.
• The edge device is connected to the internet.
• A Widget is set up to collect data (see Add a Widget).

Rearrange a Widget on the Dashboard

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Dashboard.
3. On the left side choose the Widget which holds the data you want to rearrange.
4. Click the Widget and drag it to its new position on the Dashboard.

Display Data within a Time Range

Setting a time range gives you the chance to analyze collected data from a specific period.

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Dashboard.
3. On the left side choose the Widget.
4. On the upper right of the Widget click the Time Range Menu.
5. Select a Time Range:
   • Live – displays collected data from the last 3 Minutes
   • other ranges – displays collected data from the selected time range

Deleting a widget is helpful to keep your dashboard clear and uncluttered.

Data will still be collected even after deleting a widget.

What you will need

Make sure that you have prepared the following points:

• Your TeamViewer credentials.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.
• The edge device is connected to the internet.
• A Widget is set up to collect data (see Add a Widget).

Delete a Widget from the Dashboard

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Dashboard.
3. On the left side choose the Widget you want to delete.
4. On the upper right of the Widget click the Widget Menu () > Unpin from Dashboard.

Collected data is saved in the IoT cloud. Download the raw data from the IoT cloud to analyze it with third-party tools.

What you will need

Make sure that you have prepared the following points:

• Your TeamViewer credentials.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.
• The edge device is connected to the internet.
• A Widget is set up to collect data (see Add a Widget).

Export the Data as CSV File

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Dashboard.
3. On the left side choose the Widget which holds the data you want to export.

4. On the upper right of the Widget click the Widget Menu () > Export to CSV.
   The Export CSV data file dialog is displayed.
   • Type in a filename
   • Select the metrics you want to export
   • Select the time range
5. Click Export.
   A download link is generated and is sent to your TeamViewer EMail.
   Use the download link to download the data from the IoT cloud.

Thanks to the File Transfer feature that TeamViewer IoT offers, users can upload and download files from their PCs to the Edge Device and vice versa.

File Transfer is an extension of the TeamViewer IoT Agent.

What you will need

Make sure that you have prepared the following points:

• System Requirements:
  • TeamViewer IoT Agent (Version 2.9 or newer) installed on device edge (see Update the IoT Agent)
  • TeamViewer Client installed on PC (see https://www.teamviewer.com/)
• Access the Edge Device via Remote Terminal.

Enable

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. Type in the following command and press enter:

sudo teamviewer-iot-agent configure set FileTransferAccessControl 0

When enabled, you can start to transfer files (see Transfer Files).

Disable

1. Access the edge device remotely (Access the Edge Device via Remote Terminal).
2. In the terminal type in the following command and press enter:

sudo teamviewer-iot-agent configure set FileTransferAccessControl 2

What you will need

Make sure that you have prepared the following points:

• Your TeamViewer credentials.
• The edge device is set up with a TeamViewer IoT Agent.
• The edge device is connected to the internet.
• File Transfer is enabled (see Enable File Transfer).

Procedure

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Inventory.
3. From the drop-down-menu select Devices.
4. From the list choose the device you want to transfer file. On the upper right of the device click the Device Menu () > File Transfer.
   The File Transfer dialog opens.
5. Use the dialog to transfer files between your PC and the Edge Device.
6. When all transfers are finished click Close.

The TeamViewer IoT Agent comes with a pre-configured monitor for monitoring the operating system of your Edge Device. This is helpful to monitor the status and the health of your devices.

You can use this feature to keep track of the following device operating system metrics:

• 1 min load
• 5 min load
• 15 min load
• Free Memory
• Total Memory
• Free Swap Memory
• Total Swap Memory
• Buffers Memory
• Cached Memory
• Number of CPU cores
• User CPU Usage
• Nice CPU Usage
• System CPU Usage
• Idle CPU Usage
• Io Wait CPU Usage

What you will need

Make sure that you have prepared the following points:

• Your TeamViewer credentials.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.
• The edge device is connected to the internet.

Setup

1. To log in to the IoT Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the left menu select Inventory.
3. On the right side from the dropdown menu Add select Sensor.

4. Depending on which data you want to monitor, activate CPU, Memory or Load.

5. From the dropdown menu Select Device select the Edge Device you want to monitor. The Sensor Name will be generated automatically with the selected option.
6. Select the frequency by which the data will be sent to the TeamViewer IoT Cloud. It can be defined in seconds or minutes.

7. To finish click Add. You will be redirected automatically to the Inventory.
8. From the list choose the Sensor you want to monitor, then from the dropdown menu select Pin to Dashboard.

You can use Rules and Notifications if you want to receive a notification when the health of your Edge Device is in danger. For example: receive a warning if the CPU usage is above 90%.

Publish and subscribe data from the edge device to your AWS IoT Greengrass platform and vice-versa.

To accomplish this task you need to follow the steps in this article:

1. Create AWS IoT Greengrass group
2. Install and Start AWS IoT Greengrass on the Edge Device
3. Start AWS IoT Greengrass on the Edge Device

What you will need

Make sure that you have prepared the following points:

• Your TeamViewer credentials.
• Your AWS Greengrass credentials.
• The edge device is set up with a TeamViewer IoT Agent and TeamViewer Edge Management is enabled.
• The edge device is connected to the internet.
• File Transfer is enabled (see Enable File Transfer).
• Access the Edge Device via Remote Terminal.

Create AWS IoT Greengrass group

An AWS IoT Greengrass group contains settings and other information about its components, such as devices, Lambda functions, and connectors. A group defines how its components can interact with each other.

1. On your PC sign in to AWS Management Console and open the AWS IoT console.
2. From the left menu click Greengrass.

3. On the Welcome to AWS IoT Greengrass page, click Create a Group.
4. To allow the console to create or configure the Greengrass service role for you click Grant permission.

5. On the Set up your Greengrass group page, select Use default creation to create a group.

6. Enter a name for your group (for example, MyFirstGroup), and then click Next.
7. On the Review Group creation page, select Create Group and Core.
8. Download your core’s security resources and configuration file. On the confirmation page, under Download and store your Core’s security resources, choose Download these resources as a tar.gz.

9. After the download click Finish.

Install AWS IoT Greengrass on the Edge Device

You need the security resources which you have downloaded when creating an AWS IoT Greengrass group.

1. Download the AWS IoT Greengrass Core software installation package. select the CPU architecture and distribution (and operating system, if necessary) that best describe your core device.
   • For Raspberry Pi Model B or B+, download the Armv7l for Raspbian package.
   • For an Amazon EC2 instance, download the x86_64 for Linux package.
2. Use Transfer Files to transfer the AWS IoT Greengrass Core software (greengrass-XXXXXX.tar.gz) and the security resources YYYYYY-setup.tar.gzto the user folder on the edge device (default /home/pi/).
3. Access the edge device remotely (Access the Edge Device via Remote Terminal).
4. Navigate to the user folder on the edge device where you transferred the files.
5. To decompress the files type in the following commands and press enter:

sudo tar -xzvf greengrass-OS-architecture-1.10.0.tar.gz -C

sudo tar -xzvf hash-setup.tar.gz -C /greengrass

6. To download the ATS root CA certificate type in the following command and press enter:

cd /greengrass/certs/ sudo wget -O root.ca.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem

7. Start AWS IoT Greengrass on your edge device type in the following commands and press enter:

cd /greengrass/ggc/core/

sudo ./greengrassd start

8. When the message “Greengrass successfully started” is displayed take a note of the PID-number.
9. To check if the AWS IoT Greengrass daemon is functioning type in the following command and press enter. Replace PID with the PID-number from the previous step.

ps aux | grep PID

Publish Data from the MQTT-Broker to the Amazon Cloud

This lambda function subscribes data from MQTT-Broker from Edge Device and publishes is to the Amazon Cloud to the topic tv/greengrass.

#!/usr/bin/python
import paho.mqtt.subscribe as subscribe
import paho.mqtt.publish as publish
import traceback
import json

def function_handler(event, context):
    return

# AWS part
# Change following parameters
aws_host = "a10kx625z9icrs-ats.iot.eu-central-1.amazonaws.com"  # Endpoint
aws_port = 8883
aws_tls = {'certfile': "/home/pi/Downloads/certs/1b9a6e0dcb.cert.pem",
           'keyfile': "/home/pi/Downloads/certs/1b9a6e0dcb.private.key",
           'ca_certs': "/home/pi/Downloads/certs/root.ca.pem"
           }

# TV part
#Change following parameters
tv_iot_api_version = "v1.0"
tv_host = "localhost"
tv_port = 18884

tv_tls = {'certfile': "/home/pi/Downloads/test_client_greengrass/cert-7a2b7efc1ad1473d87e049517a19628b.pem",
          'keyfile': "/home/pi/Downloads/test_client_greengrass/key-7a2b7efc1ad1473d87e049517a19628b.pem",
          'ca_certs': "/home/pi/Downloads/test_client_greengrass/TeamViewerAuthority.crt"}

client_id = "fd9e67783b7441ffb7cd62dda121567a"
sensor_id = "111804"

def subscribe_data():
    try:
        mqtt_topic_subscribe_data = "/" + tv_iot_api_version + "/" + client_id + "/sensor/" + sensor_id + "/livedata"
        print("Suscribing to " + mqtt_topic_subscribe_data)
        subscribe.callback(on_subscribe, mqtt_topic_subscribe_data, hostname=tv_host, port=tv_port, tls=tv_tls)
    except Exception as e:
        traceback.print_exc()
        print(str(e))

def on_subscribe(client, userdata, message):
    json_message = json.loads(message.payload.decode('utf8'))
    msgArr = []
    for metric in json_message["metrics"]:
        messageJ = {}
        messageJ['metricId'] = metric["metricId"]
        messageJ['metricValue'] = metric["value"]
        msgArr.append(messageJ)

    msgs = []
    msgs.append({'topic': "tv/greengrass", 'payload': json.dumps(msgArr)})
    print(msgs)
    publish.multiple(msgs, hostname=aws_host, port=aws_port, tls=aws_tls)
subscribe_data()

Fetch Data from the Amazon Cloud

This lambda function subscribes the data from Amazon Cloud and pushes the data to TeamViewer metrics and real-time data can be visualized with the IoT Management Console and the dashboard.

#!/usr/bin/python
import paho.mqtt.subscribe as subscribe
import paho.mqtt.publish as publish
import traceback
import json
import ssl
def function_handler(event, context):
    return

# AWS part
# Change following parameters
aws_host = "a10kx625z9icrs-ats.iot.eu-central-1.amazonaws.com"  # Endpoint
aws_port = 8883
aws_tls = {'certfile': "/home/pi/Downloads/certs/1b9a6e0dcb.cert.pem",
           'keyfile': "/home/pi/Downloads/certs/1b9a6e0dcb.private.key",
           'ca_certs': "/home/pi/Downloads/certs/root.ca.pem",
           'tls_version': ssl.PROTOCOL_TLSv1_2
          }

# TV part
#Change following parameters
tv_iot_api_version = "v1.0"
tv_host = "localhost"
tv_port = 18884

tv_tls = {'certfile': "/home/pi/Downloads/test_client_greengrass/cert-7a2b7efc1ad1473d87e049517a19628b.pem",
          'keyfile': "/home/pi/Downloads/test_client_greengrass/key-7a2b7efc1ad1473d87e049517a19628b.pem",
          'ca_certs': "/home/pi/Downloads/test_client_greengrass/TeamViewerAuthority.crt"}

client_id = "7a2b7efc1ad1473d87e049517a19628b"
sensor_id = "71b91c40fb2d4f61bec2fa593172085d"

def aws_subscribe():
    print("Suscribing to tv/greengrassSub")
    subscribe.callback(on_subscribe, "tv/greengrassSub", hostname=aws_host, port=aws_port, tls=aws_tls)

def on_subscribe(client, userdata, message):
    try:
        metric_data = json.loads(message.payload.decode('utf8'))
        mqtt_topic_push_data = "/" + tv_iot_api_version + "/" + client_id + "/sensor/" + sensor_id + "/metric/pushValues"
        # metric_data =  {"metrics": [{"value": 1, "metricId": "7ad8ad3e2dbe4cdcba0ee3ec0cbd2717"}]}
        msgs = []
        msgs.append({'topic': mqtt_topic_push_data, 'payload': json.dumps(metric_data)})
        print(msgs)
        publish.multiple(msgs, hostname=tv_host, port=tv_port, tls=tv_tls)

    except Exception as e:
        traceback.print_exc()
        print(str(e))
aws_subscribe()

TeamViewer IoT uses full encryption.

The encryption is based on 2048 Bit RSA private/public key exchange and 256 Bit AES session encoding. This uses the same security level as https/SSL and is considered completely safe by today’s standards.

The key exchange also guarantees that the data transfer is completely encoded from client to client and that any routers or servers in between (including our routers) are unable to read or analyze the data stream.

Protect your TeamViewer account and thus your Computers & Contacts list from unauthorized access with an additional security code.

Activate

The TeamViewer Management Console manages the two-factor authentication. You need your TeamViewer Account credentials to access the Management Console.

1. To log in to the Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the top menu click your user name > Edit profile.
   The dialog Profile Settings opens.
3. Click General > Two-factor authentication, then click Activate.
   Your recovery code is shown.
4. Download, print or copy the recovery code, then click Continue.
5. Click Save to finish the activation.

See also Recovery Code for Two-Factor Authentication.

Video Tutorial: Activate

This video shows you step by step how to activate the two-factor authentication for your TeamViewer Account.

Deactivate

There are two possible ways to deactivate two-factor authentication.

Using your profile settings

The TeamViewer Management Console manages the two-factor authentication. You need your TeamViewer Account credentials to access the Management Console.

1. To log in to the Management Console, open https://teamviewer-iot.com and use your TeamViewer account credentials.
2. From the top menu click your user name > Edit profile.
   The dialog Profile Settings opens.
3. Click General > Two-factor authentication, then click Deactivate.

Using the Recovery Code

You need your TeamViewer Account credentials and your recovery code to deactivate the two-factor authentication.

1. To navigate to the Management Console, open https://teamviewer-iot.com/LogOn#deactivate-tfa.
2. Use your TeamViewer account credentials and your recovery code.

Trusted Devices provides an extra layer of security for your TeamViewer Account. As a preventive measure to ensure your account’s security, you need to authorize new devices on which you sign in to your TeamViewer Account for the first time.

Due to technical reasons there is more than one trust per device. You will need to set separate trusts for the TeamViewer client, the Management Console (per browser), and each TeamViewer application.

What you will need

Make sure that you have prepared the following points:

• Your TeamViewer credentials.
  If you don’t have an account yet, visit https://www.teamviewer.com/ to create a new account.
• TeamViewer Client is installed.

Setup

1. On your PC open the TeamViewer Client and log in for the first time.
2. Confirm the message dialog.
   A device authorization email is sent to the email address of your TeamViewer account.

3. Click the link within the email to authorize the device.
   You will be forwarded to the TeamViewer Management Console.
4. To complete the authorization process, select the kind of trust scope you would like to grant. Then click Trust.
5. From the dropdown menu select whether you would like to trust this specific device or the IP address permanently or whether you would like to trust this device only once:

A message is displayed in the Management Console informing you that the new device is now a trusted device.

Once you complete the authorization process, you are able to sign in on the new device with your TeamViewer account credentials.

When activating two-factor authentication for your TeamViewer Account, you get an individual recovery code.

Store the recovery code in a safe place.

If you lose access to your mobile device or to the authenticator app on your device, the recovery code is your last resort to deactivate two-factor authentication.

Do not send the recovery code unencrypted via email since this could give an unauthorized user access to it. After deactivating two-factor authentication with the recovery code, you can always reactivate two-factor authentication for your user.

View Recovery Code

The TeamViewer Management Console manages the recovery code. You need your TeamViewer Account credentials to access the Management Console.

1. To log in to the Management Console, open https://login.teamviewer.com/ and use your TeamViewer account credentials.
2. From the top menu click your user name > Edit profile.
   The dialog Profile Settings opens.
3. Click General > View Recovery Code.