SK-TDA4VM Setup Guide
- A Texas Instruments TDA4VM single-board computer
- A USB-C power cable to power the TDA4VM board
- A microSD card
- A desktop or laptop computer for flashing the microSD card
- A way to connect the microSD card to the computer (a microSD slot or microSD reader)
- An Ethernet cable
- An HDMI cable
Download the following files to your computer:
Next, download and install the Balena Etcher for your desktop/laptop OS. You will use the Balena Etcher to flash the microSD card.
Flash the image
You must extract the image from the zip file before flashing the microSD card.
Insert the microSD card into a reader connected to your computer.
Launch Balena Etcher.
Click Flash from File to open the file selector.
Navigate to and select the image you downloaded.
Click Select Target to choose the storage device corresponding to your microSD card from the selector window.
Click on the desired device, then click Select to continue.
Click Flash!. If you receive a warning concerning the size of the microSD card, ensure that you have inserted the proper microSD and also selected the proper device, then click, Yes, I’m sure to flash the board. The flashing and verification process may take 10-20 minutes, depending on your system.
On completion of the flashing and validation process, remove the microSD card from your computer and insert it into the TDA4VM.
Install Viam dependencies on the TDA4VM
Connect the board to Ethernet.
Connect the board to a monitor with the HDMI cable.
Connect the board to power using the USB-C power cable.
Use the credentials and IP address displayed in the upper right-hand corner of the monitor to SSH into the board.
From the SSH session on the TDA4VM board:
Clone the TDA4VM repo:
git clone https://github.com/viam-labs/tda4vm-setup.git
Navigate to the setup directory:
Make the server setup script executable:
chmod +x tda4vm-viam-setup.sh
Launch the setup script to install
Once this process completes, the board will reboot.
viam-server is distributed for Linux as an AppImage.
The AppImage is a single, self-contained binary that runs on 64-bit Linux systems running the
x86_64 architectures, with no need to install any dependencies (except for FUSE, which is required by the AppImage format).
viam-server on a Linux computer:
Determine if FUSE version 2 is installed on your Linux system:
find /usr -name libfuse.so.2
If the above command does not return a path to the
libfuse.so.2file, install FUSE version 2 according to your Linux platform:
viam-serveron a Raspberry Pi running Raspberry Pi OS (Debian GNU/Linux 12 bookworm or later), install FUSE version 2 with the following command:
sudo apt install libfuse2
viam-serveron Ubuntu, install FUSE version 2 with the following commands:
sudo add-apt-repository universe sudo apt install libfuse2
viam-serveron other Linux distributions, or for more information, see FUSE troubleshooting.
Do not install the
fusepackage (that is, without a version number).
viam-serverrequires FUSE version 2 specifically (
Go to the Viam app and add a new machine by providing a name in the New machine field and clicking Add machine. If this is your first time using the Viam app, you must create an account first.
On the Setup tab, select
Linux (x86_64)for the appropriate Architecture for your computer. On most Linux operating systems, you can run
uname -mto confirm your computer’s architecture.
Follow the steps shown on the Setup tab to install
viam-serveron your Linux computer.
Once you have followed the steps on the Setup tab,
viam-serveris installed and running. Return to the Setup page on the Viam app and wait for confirmation that your computer has successfully connected.
viam-server will start automatically when your system boots, but you can change this behavior if desired.
Before you can program a machine, you must configure its components and services as well as any modules, remotes, processes and frames.
You can also ask questions in the Community Discord and we will be happy to help.
Was this page helpful?
Glad to hear it! If you have any other feedback please let us know:
We're sorry about that. To help us improve, please tell us what we can do better: