Setup LinX-Base on target¶

The LinX-Base package contains the necessary runtime libraries and dependencies (Qt, DE, FA and SAPcore) required to run applications developed with UX Designer on CrossControl display computers.

Download LinX-Base package¶

The Linx-Base package can be found for a specific target device under its product page on the website. Navigate to: Display & Computers and select the device you want to download LinX-Base for.

On the product page click on “DOWNLOAD AREA” or scroll down till you see “DOWNLOAD AREA” and click on:

Downloads → Device Downloads → LINX-BASE DEVICE RUNTIME

Then click on the corresponding CC Linux OS version installed on your display:

CC LINUX X.X

You will find a file with the following format:

linx-base-qt[version]-ccl[version]_[version]_[target].tar.gz

As an example, this is a linx-base file for a V700 display:

linx-base-qt68-ccl42_5.0.1_v700.tar.gz

Click on the file to download it to your development machine.

Installing the LinX-Base on the target device¶

The LinX-Base package can either be installed on the target through a RACU bundle or manually by copying the files to the target device. For production devices, it is recommended to use RACU for installation but for development and testing, manual installation is sufficient.

Install using RACU¶

For instructions on how to create a RACU bundle and install it on the target device, please refer to the CC Linux 4 - RAUC Guide available on the CrossControl website.

Manual installation¶

To manually install the LinX-Base package on the target device, follow these steps:

Copy the downloaded LinX-Base tar.gz file to the target device using scp or rsync. For example, using scp:
```
 scp linx-base-qt[version]-ccl[version]_[version]_[target].tar.gz ccs@<TARGET_IP>:/tmp
```
Replace <TARGET_IP> with the actual IP address of your target device.
SSH into the target device:
```
 ssh ccs@<TARGET_IP>
```
Get which partition is mounted as /appfs:
```
 rauc status | grep "appfs.*\sactive" | grep -Eo "\/[^,]+"
```
You should see an output similar to:
```
 /dev/mmcblk0p4 
```
In this example, /dev/mmcblk0p4 is the partition mounted as /appfs.

Make a note of the partition name (e.g., /dev/mmcblk0p4) as it will be needed in the next step.
Unlock and expand /appfs:

The following commands will erase all data on the /appfs partition. Ensure that you have backed up any important data before proceeding.
```
 sudo mount -o remount,rw /appfs
 sudo umount /appfs
 sudo mkfs.ext4 PARTITION_NAME
 sudo mount PARTITION_NAME /appfs
```
Replace PARTITION_NAME with the partition name noted in the previous step (e.g., /dev/mmcblk0p4).

Extract the LinX-Base package to the /appfs directory:

 sudo tar -xzvf /tmp/linx-base-qt[version]-ccl[version]_[version]_[target].tar.gz -C /appfs