# Linux OS



# Booting

## {{@273#bkmrk-tiger-city-imx-embed}}

- [{{@143#bkmrk-emmc}}](https://doc.redisage.com/link/143#bkmrk-emmc)
- [{{@143#bkmrk-sd-card}}](https://doc.redisage.com/link/143#bkmrk-sd-card)
- [{{@143#bkmrk-booting-after-the-po}}](https://doc.redisage.com/link/143#bkmrk-booting-after-the-po)

### eMMC

#### DIP switches positions  


To boot from the eMMC the DIP switch No. 1 needs to be in the position shown in the picture below.

<div drawio-diagram="1306"><img src="https://doc.redisage.com/uploads/images/drawio/2025-03/drawing-29-1743079695.png" alt=""/></div>

#### Power supply

Connect a power supply to the pins shown in the picture below. The suggested power supply is a DC voltage in the range of 12-24 V.

{{@274#bkmrk--2}}

#### First boot

The connected power supply should initiate the first boot.

#### Console

Booting logs are displayed in the console, indicating a proper boot from the eMMC, as shown in the picture below.

[![7e5e81cf-604f-4a14-853d-2bd09f1da13a.png](https://doc.redisage.com/uploads/images/gallery/2024-04/scaled-1680-/7e5e81cf-604f-4a14-853d-2bd09f1da13a.png)](https://doc.redisage.com/uploads/images/gallery/2024-04/7e5e81cf-604f-4a14-853d-2bd09f1da13a.png)

### SD card

#### DIP switches positions

To boot from the SD card the DIP switch No. 1 needs to be in the position shown in the picture below.

<div drawio-diagram="1307"><img src="https://doc.redisage.com/uploads/images/drawio/2025-03/drawing-29-1743079749.png" alt=""/></div>

#### Power supply

Connect a power supply to the pins shown in the picture below. The suggested power supply is a DC voltage in the range of 12-24 V.

{{@274#bkmrk--2}}

#### First boot

The connected power supply should initiate the first boot.

#### Console

Booting logs are displayed in the console.

### Booting after the power-off command

If the device is turned off by inputting the power-off command in the terminal, the previous boot methods have to be initiated via the reset button placed on the front panel. Its placement is shown in the picture below.

[![image.png](https://doc.redisage.com/uploads/images/gallery/2026-03/scaled-1680-/JpQimage.png)](https://doc.redisage.com/uploads/images/gallery/2026-03/JpQimage.png)

# New Page



# New Page



# New Page



# System Console

## {{@273#bkmrk-tiger-city-imx-embed}}

### UART console

#### Connecting the adapter to the device

To display the console via UART an RS232 → USB adapter needs to be connected to the pins of the connector shown on the picture below.

[![image.png](https://doc.redisage.com/uploads/images/gallery/2026-03/scaled-1680-/s3Oimage.png)](https://doc.redisage.com/uploads/images/gallery/2026-03/s3Oimage.png)

#### Configuring COM port

A serial port terminal needs to be configured with following configuration:

<table border="1" id="bkmrk-bits-per-second-1152" style="border-collapse: collapse; width: 49.7531%; height: 127px;"><colgroup><col style="width: 50.1099%;"></col><col style="width: 50.1099%;"></col></colgroup><tbody><tr style="height: 35.3906px;"><td style="height: 35.3906px;">Bits per second

</td><td style="height: 35.3906px;">115200</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Data bits</td><td style="height: 29.7969px;">8</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Parity</td><td style="height: 29.7969px;">None</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Stop bits</td><td style="height: 29.7969px;">1</td></tr></tbody></table>

 Then, booting from the chosen source should be realized according to the [instruction](https://doc.redisage.com/link/143#bkmrk-page-title).

### SSH console

#### Finding an IP of the device  


The device's IP can be obtained via 2 methods:

- connecting to the UART console and inputting the “ip a” command when logged as root or other user
- using the joystick shown in the picture below the IP can be displayed on the front panel display

[![image.png](https://doc.redisage.com/uploads/images/gallery/2026-03/scaled-1680-/2XQimage.png)](https://doc.redisage.com/uploads/images/gallery/2026-03/2XQimage.png)

#### Configuring COM port

The SSH terminal needs to be configured with the IP of the device. Then, booting from the chosen source should be realized according to the [instruction](https://doc.redisage.com/link/143#bkmrk-page-title).

# User Management

## {{@273#bkmrk-tiger-city-imx-embed}}

### Default user

The default user in Tiger is the only one available after the first boot.

- login: **root**
- no password

### Create new users

In order to list all existing users in the system use the following command:

```bash
awk -F':' '{print $1}' /etc/passwd
```

To add a new user and create a home directory for it use the following command:

```bash
sudo useradd -m user_name
```

To verify that the user was created and view the user’s details use:

```bash
sudo id user_name
```

To set a new password for the user use the following command:

```bash
sudo passwd user_name
```

After that, logging in as a new user will be possible. The current user can be checked with the "whoami" command.

### Delete users

A user and its home directory can be deleted with the following command:

```bash
sudo userdel -r user_name
```

# Updating

## {{@273#bkmrk-tiger-city-imx-embed}}


### System Image

<span class="codespan__pre-wrap">A system image (`.swu` file</span>) is required for the update. The image is protected by the image checksum and by the image signature. That means a modified image will not be accepted by the device. Only images from our source allow for updates. It is possible to transition from older images to newer ones and vice-versa.

There are several ways to update Tiger:

- through the Tiger console using a file on internal or external storage (eMMC or USB drive),
- through the Tiger console using a file from an external server (FTP or HTTPS),
- via the built-in update server.

The first two options require access to the console (username and password). The third option does not require a password for the device.

### Storage (eMMC or USB drive)

1. Login to the device console
2. Insert external storage or copy the file to Tiger's storage.
3. In the console, type <span class="codespan__pre-wrap">`swupdate -i <filename.swu> -k /etc/default/rsakey.pub`.</span>
4. <span class="codespan__pre-wrap">The update will proceed automatically.</span>

### External Server (FTP or HTTPS)

1. Login to the device console
2. For an FTP server, type <span class="codespan__pre-wrap">`swupdate -d -u ftp://<target_ip/file.swu> -a <user>:<password>`.</span>
3. <span class="codespan__pre-wrap">For an HTTPS server, type </span><span class="codespan__pre-wrap">`swupdate -d -u https://<target_ip/file.swu> -k /etc/default/rsakey.pub`.</span>
4. <span class="codespan__pre-wrap">The update will proceed automatically.</span>

### Built-in Update Server

1. Connect the device to the network.
2. Launch a browser on a PC.
3. In the browser, enter <span class="codespan__pre-wrap">`http://<target_ip>:8080`.</span>
4. <span class="codespan__pre-wrap">Select the `.swu` file from the PC storage and confirm the selection.</span>
5. <span class="codespan__pre-wrap">The update will proceed automatically.</span>

<p class="callout warning">Warning! Update files are the default version of firmware. All updates factory reset the device. Make sure you backup all of your important files.</p>

# System Overview

## {{@273#bkmrk-tiger-city-imx-embed}}

### Distribution

Custom Linux distribution based on the Yocto Project. Type `uname -a` to check installed version, kernel, etc.

### Supported languages

- English (US)
- English (GB)

### User utilities

#### Text editor

The default available built-in text editor on the device is `vim`.

#### Wi-Fi

The device is equipped with a Wi-Fi module and a NetworkManager library, which allows it to connect to nearby wireless networks.

##### How to enable and connect with WLAN:

1. Check the library status: `systemctl status NetworkManager`
2. If NetworkManager is disabled, type `systemctl start NetworkManager`
3. It is possible to enable it always with autostart: `systemctl enable NetworkManager`
4. Search available networks: `nmcli dev wifi list`
5. Connect with your chosen network: `nmcli dev wifi connect <name> password <password>`
6. Check your connection status with `nmcli connection show --active` or `ifconfig`

### System libraries

List of some commonly used available packages:

- Network Manager
- Modem Manager
- Chromium
- Gawk
- OpenCL
- Bzip2
- C++
- Python 3
- SQLite3
- OpenSSL
- Perl 5
- Curl
- Git
- Debuginfo
- glib
- i2c-tools
- GPIO mockup
- gthread
- iperf
- microhttpd
- rpmbuild
- SSL
- swupdate
- Wayland
- Weston
- XCB
- rpm-plugins
- sudo
- xtables

And much more. All the preinstalled system libraries can be found in `/usr/lib `directory.

User can install any other necessary libraries.

### Drivers  


System drivers can be displayed using `lsmod` command.

# Restoring Factory Settings

## {{@273#bkmrk-tiger-city-imx-embed}}

#####   


##### To factory reset the device, you need to reinstall the current system version or perform an update. The entire process is detailed in the [Updating](https://doc.redisage.com/books/tiger-city-imx/page/updating) section.

# Building Custom System Image

## {{@273#bkmrk-tiger-city-imx-embed}}

#####  

##### If you would like to ask a specific question, please visit our <span style="color: rgb(35, 111, 161);">[Contact Us](https://doc.redisage.com/books/tiger-city-imx/page/contact-us)</span> page for any further information.