# Installation guide

## Supported platforms and devices

* i.MX 8
  * CCpilot V510
  * CCpilot V700
  * CCpilot V705
  * CCpilot V710
  * CCpilot V1000
  * CCpilot V1200
  * CCpilot V1090
  * CCpilot V1290
* Core i7
  * CCpilot X1200
* LinX Software Suite DevEnv v5.1

## Prerequisites

* Qt 6.8.3
* CCL 4

## Installing Fieldbus Access

### i.MX 8 & Core i7

Fieldbus Access can be installed on the target in two different ways. For production use it should be installed on the target through a RACU bundle. For development and testing it can be installed on the target manually by manually unlocking `appfs` and unpacking it under `appfs`.

#### RAUC bundle

Please reference the `CC Linux - Using RAUC` documentation on the support web site for more information about how to generate a RAUC bundle.

#### Unlock /appfs for development/testing

1. Open an ssh session to the target:
    <code>ssh ccs\<ip-address></code>
2. Change write permissions of /appfs:
    <code>sudo mount -o remount,rw /appfs</code>
3. Check which version partition /appfs is mounted to:
    <code>rauc status</code>
4. Unmount /appfs:
    <code>sudo umount /appfs</code>
5. Format the partition:
    <code>sudo mkfs.ext4 /dev/\<partition></code>
6. Remount /appfs:
    <code>sudo mount /dev/\<partition> /appfs</code>

#### Unpacking tarball

1. Download the tarball, fieldbusaccess-ccl4_\<version>_\<TARGET>.tar.gz, from the support site.
2. Transfer the tar.gz package to device:
    <code>scp fieldbusaccess-ccl4_\<version>_\<TARGET>.tar.gz ccs@\<ip-address>:/tmp</code>
3. Open an ssh session to the target:
    <code>ssh ccs@\<ip-address></code>
4. Change directory to `/tmp`:
    <code>cd /tmp</code>
5. Run the following code to unpack it:
    <code>sudo tar xzf fieldbusaccess-ccl4_\<version>_\<TARGET>.tar.gz -C /appfs</code>
6. Data Engine will not automatically start at boot. See [Service management](runtime#service-management).

### LinX Software Suite DevEnv v5.1

These steps are intended to be performed in the UX Designer VM.

1. Download `fieldbusaccess_<version>_amd64.deb` from the support site
2. Double-click on the package to open it with GDebi
3. Follow the instructions to install the package

It's also possible to install the package using the terminal:

``` shell
sudo apt install ./fieldbusaccess_<version>_amd64.deb
```

## LinX-Manager Fielbus Access Online Documentation

LinX Manager Fieldbus Access is a plugin written for Qt Creator. The plugin allows the user access data available on CAN buses according to J1939 or CANopen protocols from a QML or Widget based Qt application. With the help of LinX Manager Data Engine updates projects with necessary code and classes to communicate with Fieldbus Access runtime via Data Engine.

Signals can then be visualized directly in a QML or Widget application thanks to generated code or processed further in the backend.

Aside from auto generating the communication layers it also generates the configuration file for the Fieldbus Access runtime, which takes care of the communication with the CAN-buses.

For full details and guides on how to proceed with creating different CAN bus signals and run the Qt applications on the various CCpilot displays head to the online documentation here [LinX Manager Fieldbus Access](https://crosscontrol.com/manual/LinX%20Manager%20Fieldbus%20Access%20Config%20tool/Sphinx/content/overview.html)

## Troubleshooting

Please refer to our [Knowledge
Base](https://crosscontrol.com/support/knowledge-base/) for further information
and troubleshooting guides head to our LinX-Manager Fieldbus Access Online Documentation [Troubleshooting](https://crosscontrol.com/manual/LinX%20Manager%20Fieldbus%20Access%20Config%20tool/Sphinx/content/troubleshooting.html) .
