Skip to main content

Target Setup Guide for RPi5

Before you Begin

Before starting with the setup guide, we recommend the following to get familiar with CGI-Studio:

  • Explore CGI-Studio
    Read the Quick Start Guide.
  • Learn to create SceneComposer Solutions
    The documentation provides instructions on how to create simple SceneComposer solutions. To access SceneComposer navigate to:
    <cgi-studio-installation-path>\bin\SceneComposer\SceneComposer.exe
  • Generate Assets for Simulation and Target Environments
    You can find guidance on generating assets from solutions (binary files containing solution information for the player) for both simulation and target environments in the documentation.

With this knowledge you should be fit to complete this guide.

Software Image Setup

The CGI Studio Community Edition supports both Raspberry Pi 4 and Raspberry Pi 5. The following section describes how you can install the Community Edition on your Raspberry Pi device.

  1. Download and install the Raspberry Pi Imager from this link: Raspberry Pi software – Raspberry Pi.
  2. Insert a compatible SD card into your computer for flashing the image.
  3. Open Raspberry Pi Imager and in the Device section select Raspberry Pi 4 or Raspberry Pi 5 depending on your model. Afterwards click "Next".

    Raspberry Pi 5 selection

  4. In the menu Choose operating system select "Raspberry Pi OS (64-bit)". Then click "Next".

    OS selection

  5. In the storage section, select the inserted SD card, and click "Next".
  6. In the Customization step click "Next" till the "Customisation: SSH authentication" configuration occurs. Make sure that SSH is enabled.

    image.png

  7. Click "Next" and write the image to the SD card. This may take some time.
  8. Finally eject the SD card from your PC.

Raspberry Pi Startup

This section outlines the initial hardware setup, booting, and first-time configuration process for setting up the operating system on a Raspberry Pi 4 or a Raspberry Pi 5.

  1. Insert the SD Card: Insert the flashed microSD card securely into the dedicated card slot on your Raspberry Pi board.

  2. Connect Hardware: Connect your Raspberry Pi to an external display (using a micro-HDMI to HDMI cable), plug in your USB touch interface/peripherals or connect to DSI cable, and connect the official USB-C power supply to power it on.

  3. Initial Boot & Setup: The OS will automatically begin its initial boot diagnostics. Follow the on-screen configuration wizard to set up your region, skip the Wi-Fi and connect LAN, and establish your core username and password.
  4. Boot to Desktop: Once you complete the wizard, the system will finalize its settings and boot directly into the desktop user interface.
  5. Once installed, the OS UI will appear on the display.

Connecting to the Raspberry Pi using SSH (WinSCP)

After booting, connect to the target device via a serial terminal (e.g., Tera Term) or SSH. This is important for transferring additional files to the target and executing commands on the target device.

At Candera we used WinSCP to transfer additional files. Use the IP address of your Raspberry Pi device and your credentials for connecting with WinSCP.

SSH connection example

Install DEB package on the RPi5

Installing this Debian (.deb) package configures the native CGI Studio Player application on your Raspberry Pi. This guidechapter outlines the process of transferring and installing the CGI Studio Community package onto a Raspberry Pi 4 or Raspberry Pi 5 using WinSCP and a terminal connection.

  • Transfer the File: Use WinSCP to transfer the downloaded .deb file to your Raspberry Pi (e.g., /home/username/).
  • Navigate to the Directory: Use cd and verify with ls.
  • Install the Package: 
    sudo apt update
sudo apt install ./cgi-studio-community-rpi5_3.16.0-arm64.deb

Run Blood Pressure Sample with Target Player

The Blood Pressure Device sample is a Scene Composer sample that demonstrates a blood pressure measurement device with exemplary scenes and animations. General information on this sample can be found in the Blood Pressure Solution documentation.

Execute the following command on the Raspberry Pi device to run the sample using our target player.

Player /opt/candera/Samples/BloodPressureDevice/BloodPressureDevice.bin

The asset will be visible on the target device.

Blood pressure example

Run Blood Pressure Sample with Player Connector Library 

The Blood Pressure Sample sample is extended with a data binding sample programmed in Python. The Python part of the sample relies on the Python-Based Player Data Binding Library to interact with the data bindings of the scene. Once the hardware is set up follow these steps to configure the Python environment and execute the sample.
The Python code for the blood pressure device sample can be found under:
<cgi-studio-installation-path>\bin\CommunityEdition\Python\Samples\BloodPressureDevice on the host computer and in /opt/candera/Python/Samples/BloodPressureDevice on the target, after successful installation of the debian package.

Follow the steps below to run the Blood Pressure sampleSample with player connector library.

    • Move to directory: Open the terminal on your Raspberry Pi and move to the specific sample directory:directory.
      cd /opt/candera/Python/Samples/BloodPressureDevice
    • Configure and activate the Python Virtual EnvironmentEnvironment:
      Creating a virtual environment ensures that the dependencies for the Candera sample do not conflict with other system libraries.  
      python -m venv .
source bin/activate
    • Install DependenciesDependencies:
      Install the required Python packages defined in the project's requirements file:file.
      pip install -r ./requirementsWithoutSoundhound.txt

    • Run the Sample:

      Execute the mainBlood Pressure Device python script withusing thesethe flags:following flags.

      • -wsh : Disable SoundHound integration

    -lbp : Library binary path

    -abp : Asset binary path 
    python BloodPressureDevice.py -wsh -lbp /opt/candera/lib/libPlayerConnectorLibrary.so \
-abp /opt/candera/Python/Samples/BloodPressureDevice/BloodPressureDevice.bin -wsh
    Verification: Upon execution, the Blood Pressure Device UI should initialize and appear on your connected Raspberry Pi display.
    NOTE: If the display is portrait mode but ifit needs to be rotated to landscape mode.
    Command -  wlr-randr --output DSI-2 --transform 90

     

    Back to top