SIMATIC IOT2050 IndustrialOS Getting Started V3.2.2
SIMATIC IOT2050 IndustrialOS Getting Started V3.2.2
SIMATIC IOT2050 IndustrialOS Getting Started V3.2.2
2
on SIMATIC IOT2050 -
Getting Started
Legal information
Use of application examples
Application examples illustrate the solution of automation tasks through an interaction of several
components in the form of text, graphics and/or software modules. The application examples are
a free service by Siemens AG and/or a subsidiary of Siemens AG (“Siemens”). They are non-
binding and make no claim to completeness or functionality regarding configuration and
equipment. The application examples merely offer help with typical tasks; they do not constitute
customer-specific solutions. You yourself are responsible for the proper and safe operation of the
products in accordance with applicable regulations and must also check the function of the
respective application example and customize it for your system.
Siemens grants you the non-exclusive, non-sublicensable and non-transferable right to have the
application examples used by technically trained personnel. Any change to the application
examples is your responsibility. Sharing the application examples with third parties or copying the
application examples or excerpts thereof is permitted only in combination with your own products.
The application examples are not required to undergo the customary tests and quality inspections
of a chargeable product; they may have functional and performance defects as well as errors. It is
your responsibility to use them in such a manner that any malfunctions that may occur do not
result in property damage or injury to persons.
Disclaimer of liability
Siemens shall not assume any liability, for any legal reason whatsoever, including, without
limitation, liability for the usability, availability, completeness and freedom from defects of the
application examples as well as for related information, configuration and performance data and
any damage caused thereby. This shall not apply in cases of mandatory liability, for example
under the German Product Liability Act, or in cases of intent, gross negligence, or culpable loss of
life, bodily injury or damage to health, non-compliance with a guarantee, fraudulent
non-disclosure of a defect, or culpable breach of material contractual obligations. Claims for
damages arising from a breach of material contractual obligations shall however be limited to the
© Siemens AG 2020 All rights reserved
foreseeable damage typical of the type of agreement, unless liability arises from intent or gross
negligence or is based on loss of life, bodily injury or damage to health. The foregoing provisions
do not imply any change in the burden of proof to your detriment. You shall indemnify Siemens
against existing or future claims of third parties in this connection except where Siemens is
mandatorily liable.
By using the application examples you acknowledge that Siemens cannot be held liable for any
damage beyond the liability provisions described.
Other information
Siemens reserves the right to make changes to the application examples at any time without
notice. In case of discrepancies between the suggestions in the application examples and other
Siemens publications such as catalogs, the content of the other documentation shall have
precedence.
The Siemens terms of use (https://support.industry.siemens.com) shall also apply.
Security information
Siemens provides products and solutions with industrial security functions that support the secure
operation of plants, systems, machines and networks.
In order to protect plants, systems, machines and networks against cyber threats, it is necessary
to implement – and continuously maintain – a holistic, state-of-the-art industrial security concept.
Siemens’ products and solutions constitute one element of such a concept.
Customers are responsible for preventing unauthorized access to their plants, systems, machines
and networks. Such systems, machines and components should only be connected to an
enterprise network or the Internet if and to the extent such a connection is necessary and only
when appropriate security measures (e.g. firewalls and/or network segmentation) are in place.
For additional information on industrial security measures that may be implemented, please visit
https://www.siemens.com/industrialsecurity.
Siemens’ products and solutions undergo continuous development to make them more secure.
Siemens strongly recommends that product updates are applied as soon as they are available
and that the latest product versions are used. Use of product versions that are no longer
supported, and failure to apply the latest updates may increase customer’s exposure to cyber
threats.
To stay informed about product updates, subscribe to the Siemens Industrial Security RSS Feed
at: https://www.siemens.com/industrialsecurity.
Table of contents
Legal information ......................................................................................................... 2
1 Task ..................................................................................................................... 4
1.1 Overview............................................................................................... 4
2 Requirements ..................................................................................................... 5
2.1 Required Hardware .............................................................................. 5
2.2 Required Software ................................................................................ 6
3 Operating ............................................................................................................ 7
3.1 Create Industrial OS Service Stick ....................................................... 7
3.2 (Re-)install Industrial OS ...................................................................... 8
3.2.1 With empty eMMc ................................................................................. 8
3.2.2 With image on eMMC ......................................................................... 11
3.3 First Setup of the Industrial OS .......................................................... 14
3.3.1 Language ........................................................................................... 15
3.3.2 Keyboard settings ............................................................................... 15
3.3.3 Network settings ................................................................................. 17
3.3.4 Firewall ............................................................................................... 20
3.3.5 Timezone ............................................................................................ 23
3.3.6 Hostname ........................................................................................... 24
3.3.7 Date / Time ......................................................................................... 25
3.3.8 Apt mirror ............................................................................................ 27
© Siemens AG 2020 All rights reserved
1 Task
1.1 Overview
Introduction
Currently the IOT2050 Advanced (6ES7647-0BA00-1YA2) comes with an empty
internal eMMc at the moment (latest FS:05). In order to use the Industrial OS V3.2.2,
it needs to be written to the eMMc with the help of the Industrial OS Service Stick.
Goals
After working through this document, you should know how to
• Create Service Stick
• Install the Industrial OS to the eMMC
• Complete the first set up of the Industrial OS
© Siemens AG 2020 All rights reserved
2 Requirements
2.1 Required Hardware
This chapter contains the hardware required for this Getting Started.
Keyboard
For operating the IOT2050 with a monitor, a USB-Keyboard is required.
Power supply
In order to run the SIMATIC IOT2050 a power supply is required.
This power supply has to provide between 12 and 24V DC.
Engineering Station
To write the Service Stick image to a USB flash drive, an Engineering Station is
required. In this example a PC with Windows 10 is used for this
balenaEtcher
To write the Service Stick Image to the USB flash drive, the software balenaEtcher
is used.
balenaEtcher can be downloaded here.
© Siemens AG 2020 All rights reserved
3 Operating
This chapter describes the steps necessary install, configure and start up the
SIMATIC IOT2050 with Industrial OS using the hard- and software listed above.
Precondition
A monitor (DP or with active HDMI-DP adapter) is connected to the IOT2050, and it
is supplied with a suitable power supply.
As an alternative a UART cable can be used (see chapter 3.8.1)
- Write the extracted Service Stick image (.img) to a USB flash drive with the
software balenaEtcher.
After the flashing process balenaEtcher may report that the flash failed.
NOTE
This is not true; the Service Stick is valid!
Details on changing the boot order with Example Image can be found in chapter
3.5
- Plug in the Service Stick to a USB 2.0 interface of the IOT2050 and reboot the
IOT2050
- Due to an empty eMMc the IOT2050 will boot from the Service Stick
- The next boot will happen from eMMc, since the Industrial OS is now installed
The first setup appears. Continue with chapter 3.3
- Either boot Example Image from SD card and change boot-order to set usbx
as first boot device and mmc1 as second
fw_setenv boot_targets “usb0 usb1 usb2 mmc1 mmc0”
or use UART cable (chapter 3.8.2) to change boot order
- Plug in the Service Stick to a USB 2.0 interface of the IOT2050 and reboot the
IOT2050
- Due to the boot order the IOT2050 will boot from the Service Stick
- After triggering the reboot, remove the Service Stick, so that the next
boot will be done from the eMMc and not the USB Stick!
© Siemens AG 2020 All rights reserved
- During the boot process – best case when the STAT LED goes off – plug
the Service Stick in
If you see localhost login for a longer time, try a reboot via the Reset button
The mel-setup will guide through the necessary configuration steps of the
© Siemens AG 2020 All rights reserved
Industrial OS.
NOTE The setup can only be operated with a keyboard, not with a mouse.
Use the arrow keys to navigate
Use TAB to select <OK> or <Cancel>
Use ENTER to activate the selected option
3.3.1 Language
Please use the default pc105, if not sure which one to choose. Otherwise it can
lead to some non-working keys
It is also possible to jump directly to a specific layout instead of using the arrow
keys. For example, just press “d” to jump to the first layout with the letter d (de).
The IOT2050 Advanced has two Ethernet interfaces, which can be configured in
this step:
• eno1= X1P1
• eno2 = X1P2
© Siemens AG 2020 All rights reserved
- Select the interface to configure. There are three different modes available
• dhcp – get IP address automatically from a dhcp server
• static – set IP address manually
• disable – disable the interface
- Set an IP address
© Siemens AG 2020 All rights reserved
- Set the gateway. This can be left blank if there is no gateway needed
- Set DNS server(s). This can be left blank if there is no DNS server needed
- If you require a proxy for internet connection, e.g. within a company network, it
may be needed to set a proxy. This can be done in this step.
If Yes is selected, proxy can be set for:
• http
• https
• ftp
• no-proxy – exceptions where no proxy should be used
3.3.4 Firewall
Application
- You can choose from a list of pre-defined applications. In this example the
software Node-RED is chosen
- After that the direction needs to be configured – for most of the applications it
is in as you want to connect from outside to the application
© Siemens AG 2020 All rights reserved
Port
- Instead of selecting an application you can enter a port number
- After that the direction needs to be configured – for most of the applications it
is in as you want to connect from outside to the application
© Siemens AG 2020 All rights reserved
- Now every chosen application / port is listed in the overview. Select Done to
proceed with the setup
© Siemens AG 2020 All rights reserved
3.3.5 Timezone
3.3.6 Hostname
The date and time can be set manually or being provided by a NTP server. The
following shows the steps of both options, only one of them is required to be done.
NTP
- Enter one or more NTP servers to synchronize the date and time; either
publicly available servers from the internet or local ones (e.g. a router, switch
or any other device providing NTP server functionality)
© Siemens AG 2020 All rights reserved
Manual
In order to install software via the package manager apt it is required to use a so-
called mirror (or repository) as resource for software packages.
- Choose Add Mirror to add a mirror from a pre-defined list
The user root (also known as superuser) is a special account in Linux that is used
for system administration. The root account is the privileged account on a Linux
system that has access to all commands and files.
- The first setting regarding root is to enable or disable the root login.
Select No if root login should be enabled → recommended
Select Yes if root login should be disabled
3.3.10 User
- Select if the user is supplied with superuser privileges. This allows the user to
execute commands with a pre-fixed sudo, which means to perform the
command with root privileges
- Select in which cycle the selected repository from chapter 3.3.8 is updated
automatically.
The update can also be performed manually with the command apt update on
the running system
Of course it is possible to install software via apt install afterwards in the running
system.
The last step of the setup is about the autostart of the Service Stick.
• Enable means that a setup opens automatically by plugging the Service
Stick into the IOT2050 when Industrial OS is running, even when no user
is logged in (This can be helpful in many cases (e.g. forgotten
passwords), but also brings a security disadvantage of possible local
attacks.)
This only works with monitor or UART connection, not with ssh!
• Disable means that the setup does not open automatically. It can still be
called manually with the command mel-setup as root or sudo mel-setup
as user with superuser privileges (precondition for this is having enabled
superuser privileges in chapter 3.3.10).
© Siemens AG 2020 All rights reserved
3.3.14 Result
- After the configuration is complete, the system will perform the installation
steps
- When this is done, the system is ready, and it is possible to login to the
system; either as root or the configured user
© Siemens AG 2020 All rights reserved
- After that you can choose the category, you want to make changes
© Siemens AG 2020 All rights reserved
IP addresses of the interfaces can be changed faster with the command nmtui as
root or sudo nmtui as user.
Remember that a reboot or re-initialization of the interfaces is required after making
changes
Using the mel-setup it is also possible to change the mode of the serial port as well
as the mode of the Arduino pins of the IOT2050.
Default settings
The default setting of the serial port (IOT2050 External Serial) is RS232.
By default all Arduino pins are set to GPIO_Input.
- The current mode of the Arduino pins can be checked under IOT2050 Arduino
IO Info
© Siemens AG 2020 All rights reserved
- The first screen shows the available modes of the several GPIOs
© Siemens AG 2020 All rights reserved
Change settings
As an example it is shown how to activate the UART pins of the Arduino interface
- Select IOT2050 Arduino UART
© Siemens AG 2020 All rights reserved
- Call mel-setup again and check the mode under IOT2050 Arduino IO Info
© Siemens AG 2020 All rights reserved
- To disable UART again, set RX & TX and CTS & RTS to false
This example at first checks the USB slots for bootable devices, then the SD
card and as last option the eMMc.
NOTE Having the eMMc as last boot device always gives the option to boot from SD
card / USB flash drive by simply plugging a device with the Example Image /
Service Stick and restarting the device!
This can be helpful in many cases, but also brings a security disadvantage of
possible local attacks.
© Siemens AG 2020 All rights reserved
- To clear the eMMc, it is needed to boot the Example Image from a SD card or
USB flash drive. One pre-condition for this is having the boot order changed
(see chapter 3.5)
3.7.1 Backup
3.7.2 Restore
NOTE After triggering the reboot, remove the Service Stick, that the next boot will be
done from eMMc!
The next steps show how to use this cable and how to establish a serial
connection.
- Connect the USB part of the cable to your PC. Drivers may need to be
installed, please check the website of the vendor of the used cable.
NOTE If there is no COM port assigned and the device appears as an unknown device,
it is needed to install the drivers for the cable
- Open putty and configure the connection like this (COM port can differ) and
click on Open
© Siemens AG 2020 All rights reserved
- Power on the IOT2050. It is now possible to see the whole boot process
With this procedure it is possible to perform the installation and initial setup of the
Industrial OS (chapter 3.2 / chapter 3.3).
Connect the cable and establish the serial connection prior to the boot of the
Service Stick and the mel-setup will appear in the putty console instead of the
monitor.
This can be done when there is no DP monitor or no active converter available
To change the boot order prior to the boot to eMMc follow this process
- Interrupt the boot process at the point Hit any key to stop autoboot by hitting
any key. This will end up in the u-boot shell (indicated by IOT2050>)
© Siemens AG 2020 All rights reserved
It is possible to select the boot device only for the upcoming boot – independently
from the set boot order.
- This procedure can be used to re-install the Industrial OS, without deleting the
current installation on eMMc beforehand (see chapter 3.2.2).
First boot from USB drive, second boot after automatic reboot from mmc1
It is also possible to operate the IOT2050 with a serial connection instead of using
a ssh connection or a monitor.
After having booted from a device with an operating system the login prompt of
© Siemens AG 2020 All rights reserved
Industrial OS or the Example Image will appear, and the terminal can be used for
any kind of terminal operations
4 Related links
Table 4-1
Topic
\1\ SIMATIC IOT2050 forum
https://support.industry.siemens.com/tf/ww/en/threads/309w
\2\ Download SD-Card Example Image
https://support.industry.siemens.com/cs/ww/en/view/109741799
\3\ Operating Instructions
https://support.industry.siemens.com/cs/ww/en/view/109779016
5 History
Table 5-1
Version Date Modifications
V1.0.0 07/2021 First version
© Siemens AG 2020 All rights reserved