Engineering System Setup Guide¶
⚠️ Disclaimer: Why is Windows required? Because TIA Portal supports only Windows!
Please note that this guide is meant as an example for the complete setup process of the engineering system. Different step combinations or the use of other similar tools may also be suitable.
Take into account that the steps shown in this guide may be outdated, for an up-to-date installation process, please visit each of the tools websites.
Official Documentation Links¶
- Windows Subsystem for Linux Documentation
- Visual Studio Code Documentation
- ROS 2 Humble Documentation
- Docker Documentation
- TIA Portal Documentation
1. Install Windows Subsystem for Linux (WSL)¶
1. Open PowerShell as Administrator¶
wsl --install
2. Verify Installation and Update¶
wsl --list --online
wsl --install -d Ubuntu
3. Restart your computer¶
4. Complete Ubuntu Setup¶
- Create a username when prompted
- Create a password
- Confirm password
Reference: WSL Installation Guide
2. Install Visual Studio Code¶
1. Download VS Code¶
- Go to VS Code Download Page
- Click "Download for Windows"
2. Install VS Code¶
- Run the downloaded installer
- Accept the agreement
- Select destination location
- Click "Next" and "Install"
3. Install Remote Development Extension¶
- Open VS Code
- Press
Ctrl+Shift+X
- Search for "Remote Development"
- Click "Install" on "Remote Development Extension Pack"
4. Connect to WSL from VS Code¶
- Click on the blue button in the lower-left corner of VS Code
- From the command palette that opens at the top, select "Connect to WSL"
- Alternative: Use keyboard shortcut:
Ctrl+Shift+P
and type "Connect to WSL"
5. Open Terminal in WSL¶
- Go to Terminal → New Terminal in the top menu
Reference: VS Code Setup Guide
3. Install ROS 2 in WSL¶
Write the following commands into the terminal window opened in VS Code:
1. Set up sources¶
sudo apt update && sudo apt install -y software-properties-common
sudo add-apt-repository universe
2. Add ROS 2 GPG key¶
sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg
3. Add repository to sources list¶
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(. /etc/os-release && echo $UBUNTU_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null
4. Install ROS 2¶
sudo apt update
sudo apt install -y ros-humble-desktop
5. Source ROS 2 environment¶
echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc
source ~/.bashrc
Reference: ROS 2 Installation Guide
4. Install Docker in WSL¶
Write the following commands into the open terminal window in VS Code:
1. Remove old versions¶
sudo apt-get remove docker docker-engine docker.io containerd runc docker-compose docker-compose-v2
2. Set up Docker repository¶
sudo apt-get update
sudo apt-get install -y \
ca-certificates \
curl \
gnupg \
lsb-release
3. Add Docker's official GPG key¶
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
4. Install Docker Engine¶
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
5. Configure Docker permissions¶
sudo usermod -aG docker $USER
newgrp docker
6. Test Docker installation¶
docker run hello-world
Reference: Docker Installation Guide
5. Install TIA Portal V20¶
1. Download TIA Portal V20¶
- Visit Siemens Industry Online Support TIA V20 page
- Download TIA Portal V20 installation files
2. Prepare for Installation¶
- Close all running applications
- Disable antivirus temporarily
- Run as Administrator
3. Installation Steps¶
- Double-click the installation file
- Select language
- Accept license agreement
- Choose installation path
- Select components
- Click "Install"
4. Post-Installation¶
- Activate your license
- Install any available updates
- Restart computer
5. Download and Install Update 1¶
- Visit Siemens Industry Online Support TIA V20 update page
- Download the update package for STEP 7 / WinCC V20 Update 1
- Close TIA Portal if it's running
- Run the update installer as Administrator
- Follow the installation wizard
- Wait for the installation to complete
- Restart computer after installation
Reference: TIA Portal Installation Guide