Specifications​

Interface Description​

Dimensions​

UNO Q Connection​

1. Place the screen on a support surface that will not press against and damage the panel, exposing the carrier board on the back.

2. Align the JMEDIA and JMISC connectors of the UNO Q and the carrier board, and stack and connect them in the direction shown in the figure.

   
   

   After confirming that the connector positions are correct, press evenly to avoid misalignment or forcing insertion at an angle.

   
   

3. Choose one of the following methods to power the UNO Q. Both the power port and the cable must meet the 5 V / 3 A requirement:

   • Power adapter supply: Connect the power adapter to the UNO Q's USB-C port.

     
     

   • Computer USB port supply: Use a USB-C cable that supports data transfer to connect the UNO Q to a computer, providing both power and data communication.

Camera Connection​

This product is equipped with two 22 PIN CSI camera interfaces, and only supports connecting IMX219 camera modules. If you do not need to use a camera, you can skip this step.

1. Shut down the system, disconnect the power, and remove the UNO Q mainboard.

2. Check the CSI interface pin definitions, and confirm the interface specifications and contact orientation of the camera module and cable.

   
   

3. Correctly insert the cable into the CSI interface and lock the connector. After confirming that the connection is correct, reinstall the UNO Q mainboard and connect the power.

   INFO

   Note: The image is for connection reference only. The specific connection direction of the cable should be based on the interface definition of the camera module, to avoid reverse connection or misalignment.

   
   

System Preparation and Screen Configuration​

Some earlier versions of the Arduino UNO Q system may lack the drivers and device tree files required by the screen, causing the screen to fail to work properly. Please follow the steps below to check the system and complete the screen configuration.

Configure via Arduino App Lab​

1. Open Arduino App Lab on your computer. For detailed operations, please refer to the App Lab Usage. Use a Type-C cable to connect the UNO Q to the computer.

2. After completing the initial setup and account password configuration as prompted, click the Settings (⚙) icon in the lower left corner of Arduino App Lab to enter the Settings page, find the Carriers option, and enable Enable external carriers.

   
   

   The following prompts may appear when enabling:

   • Attach carrier board: Please confirm that the UNO Q has been powered off and the screen expansion board has been correctly installed according to the Hardware Connection and Interface Description. After confirming, click "Ok, Got it" to continue.

     
     

   • Update required: This indicates that the current system version does not support the Media Carrier. Click "Update Board" and follow the on-screen prompts to complete the system update and restart. After updating, return to "Settings" > "Carriers" and enable the expansion board feature.

     
     

   If the system update prompt does not appear, you can continue directly with the subsequent configuration.

3. Confirm that Enable external carriers is enabled, and select 10-dsi-touch-a in the display device options. If no camera is connected, set both CAMERA0 and CAMERA1 to none.

   
   

4. Click Apply and Reboot, and after the UNO Q restarts, check whether the screen display and touch functions work properly.

Configure via Command Line (Optional)​

You can also enter the UNO Q terminal via SSH or ADB and configure the screen using the command line.

1. View supported devices

sudo arduino-linux-config carrier list

Confirm that the device list contains media-carrier, and that the display device options contain 10-dsi-touch-a.

2. Enable the screen

When no camera is connected, run:

sudo arduino-linux-config carrier enable media-carrier camera0=none camera1=none display=10-dsi-touch-a

If a compatible IMX219 camera is connected to the CAMERA0 interface, you can use:

sudo arduino-linux-config carrier enable media-carrier camera0=type1-2lanes camera1=none display=10-dsi-touch-a

3. Check the configuration

sudo arduino-linux-config carrier show media-carrier

Confirm that the display configuration for the next boot is 10-dsi-touch-a.

4. Restart the device

sudo reboot

After the UNO Q restarts, check the screen display and touch functions.

Camera Usage​

Enable the Camera​

1. Turn off the UNO Q and disconnect the power. Connect the camera to CAMERA0 according to the Hardware Connection and Interface Description, and confirm the cable orientation is correct before supplying power.

2. In App Lab's "Settings" > "Carriers", set CAMERA0 to type1-2lanes, CAMERA1 to none, keep the display as 10-dsi-touch-a, and click "Apply and Reboot".

   
   

sudo arduino-linux-config carrier enable media-carrier camera0=type1-2lanes camera1=none display=10-dsi-touch-a
sudo reboot

sudo arduino-linux-config carrier enable media-carrier camera0=type1-2lanes camera1=type1-2lanes display=10-dsi-touch-a
sudo reboot

Install and Open Cheese​

When you need to take photos or record videos on the desktop, install Cheese in the UNO Q terminal:

sudo apt update
sudo apt install cheese -y

After the installation is complete, open the application from "Applications" > "Multimedia" > "Cheese" on the device desktop.

You can also run the following command in a terminal that is already logged into the desktop, without sudo:

cheese

Set the Resolution and Take Photos, Record Videos​

Before use, exit other programs that are occupying the camera. When you need to test two cameras, first enable CAMERA0 and CAMERA1 according to the steps above.

1. Open the menu in the upper right corner of Cheese, select "Preferences", and go to the "Webcam" page.

   
   

2. In "Device", select the camera, and set both "Photo resolution" and "Video resolution" to 816 × 616.

   
   

3. Close Preferences and wait a few seconds to observe the image. If capture previously failed, exit and reopen Cheese.

4. In "Photo" mode, click the capture button and confirm that the photo can be opened.

5. Switch to "Video" mode, click record, wait about 4 seconds, then click stop and confirm that the recording can be played.

6. When two cameras are connected and enabled, return to Preferences, select the other camera, check both resolutions again, and repeat the photo and video tests.

Photos are saved by default to ~/Pictures/Webcam/, and recordings are saved by default to ~/Videos/Webcam/. If the system pictures or videos directory has been renamed, or a different save location has been set, the actual local directory shall prevail.

Audio Usage​

Graphical Interface Configuration​

The baseboard provides 2 3.5 mm audio interfaces and has two built-in speakers, which can be used for audio input and output.

1. Open "Volume Control" from "Applications" > "Multimedia" on the device desktop.

   
   

2. Check the "Profile" configuration in "Configuration". After selecting the desired configuration, check the actual output in "Output Devices", unmute, and set a lower volume first.

   
   

3. Play an audio file, confirm in "Playback" that the application uses the desired output, and then check whether the headphones have sound. When you need to use a microphone, select the corresponding input in "Input Devices", unmute, and check whether the level changes with sound.

Switch Audio Output via Command Line​

The following commands only switch the switch at the output end. They are applicable to systems where the basic playback routing has already been configured and the corresponding control items exist on sound card 0. First use aplay -l and amixer -c 0 controls to verify the sound card and control items; if the card number differs, replace 0 in the commands. If the playback routing has not yet been configured, prefer using the graphical interface above. You cannot determine that there is sound based only on a successful switch command.

Switch to Earphones:

amixer -c 0 cset name='LO_RDAC Switch' off
amixer -c 0 cset name='EAR_RDAC Switch' on

Switch to Line Out:

amixer -c 0 cset name='EAR_RDAC Switch' off
amixer -c 0 cset name='LO_RDAC Switch' on

Audio Input​

After the connection is complete and the corresponding input is selected and enabled in "Volume Control", you can test microphone recording. The following steps assume that the recording routing has already been initialized; adjusting only the recording gain cannot enable the ADC and recording channel. If it has not been initialized, first complete the routing according to the audio configuration of the current image.

1. Install audio tools

Open a terminal and run the following commands to install the ALSA tools:

sudo apt update
sudo apt install alsa-utils -y

2. View audio devices

Run the following commands to view the recording and playback devices recognized by the system:

arecord -l
aplay -l

Confirm the sound card number and device number corresponding to the microphone. The following uses sound card 0 and recording device 2 as an example; if the actual numbers differ, modify the subsequent commands accordingly.

3. Set the microphone recording gain

After confirming that this control item exists on sound card 0 and that the allowed value range includes 70, run the following command to set the recording gain:

amixer -c 0 cset name='TX_DEC0 Volume' 70

4. Record audio

If recording.wav already exists in the current account's home directory, use a different file name first. Run the following command to record 5 seconds of audio and save it as a WAV file:

arecord -D plughw:0,2 -f S32_LE -c 1 -r 48000 -d 5 "$HOME/recording.wav"

5. Play the recording

After recording is complete, run the following command to play the recording file:

aplay "$HOME/recording.wav"

RGB Status Light Usage​

This product is equipped with 4 sets of RGB status indicator lights. Each set can independently control the red, green, and blue color channels, and can be used for device status indication and application feedback.

Control the RGB LED​

Run the following commands in the UNO Q terminal, using the first set of RGB LEDs as an example:

Light up the red LED:

echo none | sudo tee /sys/class/leds/media-carrier:red1/trigger
echo 1 | sudo tee /sys/class/leds/media-carrier:red1/brightness

Light up the green LED:

echo none | sudo tee /sys/class/leds/media-carrier:green1/trigger
echo 1 | sudo tee /sys/class/leds/media-carrier:green1/brightness

Light up the blue LED:

echo none | sudo tee /sys/class/leds/media-carrier:blue1/trigger
echo 1 | sudo tee /sys/class/leds/media-carrier:blue1/brightness

Turn off the first set of RGB LEDs:

for color in red green blue; do
    echo 0 | sudo tee /sys/class/leds/media-carrier:${color}1/brightness
done

Turn Off All RGB LEDs​

Run the following command to turn off all color channels of the 4 sets of RGB LEDs:

sudo sh -c '
for n in 1 2 3 4; do
    for color in red green blue; do
        path="/sys/class/leds/media-carrier:${color}${n}"
        echo none > "$path/trigger"
        echo 0 > "$path/brightness"
    done
done
'

Connect a Keyboard and Mouse​

Connect a USB-C Hub​

Connect the keyboard and mouse to a USB-C Hub, connect the power supply to the Hub's PD port, and then connect the Hub to the UNO Q's USB-C port.

Set the USB Mode​

Use Host mode when connecting a keyboard and mouse; use Device mode when connecting to a computer via USB for App Lab.

Run the following commands in the UNO Q desktop terminal or via network SSH. The corresponding role node must exist in the system.

Screen Rotation​

Display Rotation​

The following uses 90° Right (rotate 90° to the right) as an example.

1. On the desktop, open Settings > Display

   
   

   Under Rotation, select Right, click Apply, and save.

   
   

Touch Rotation​

2. Create the configuration directory (this can also be run if it already exists):

   sudo mkdir -p /etc/X11/xorg.conf.d
   

3. Open the touch configuration file:

   sudo nano /etc/X11/xorg.conf.d/99-goodix-dsi-rotation.conf
   

4. If the file is empty, add the following configuration; if a configuration already exists, modify only the TransformationMatrix line.

   Section "InputClass"
       Identifier "Goodix DSI touchscreen rotation"
       MatchProduct "Goodix Capacitive TouchScreen"
       MatchIsTouchscreen "on"
       Driver "libinput"
       Option "CalibrationMatrix" "5.2 0 0 0 3.2 0 0 0 1"
       Option "TransformationMatrix" "0 1 0 -1 0 1 0 0 1"
   EndSection
   

   The example above is for 90° Right. If you need another orientation, replace the TransformationMatrix line with the corresponding content below, keeping only one:

   # Default portrait, 0°:
   Option "TransformationMatrix" "1 0 0 0 1 0 0 0 1"
   
   # 90° Right:
   Option "TransformationMatrix" "0 1 0 -1 0 1 0 0 1"
   
   # 180° Inverted:
   Option "TransformationMatrix" "-1 0 1 0 -1 1 0 0 1"
   
   # 270° Left:
   Option "TransformationMatrix" "0 -1 1 1 0 0 0 0 1"
   

   
   

5. Press Ctrl+O → Enter to save, and press Ctrl+X to exit. After saving other work, reboot the UNO Q:

   sudo reboot
   

   After rebooting, tap the center and four corners of the screen to confirm that the touch positions are correct.

Auto-Login to the Desktop at Boot​

1. Open the LightDM configuration file on the UNO Q. Keep a backup of the existing configuration before modifying; if the backup file below already exists, use a new name:

   sudo cp -n /etc/lightdm/lightdm.conf /etc/lightdm/lightdm.conf.before-uno-q-desktop
   sudo nano /etc/lightdm/lightdm.conf
   

2. Set the following items in the existing [Seat:*] section; add it only if the file does not have that section. Do not add the section name repeatedly or overwrite other configurations:

   [Seat:*]
   autologin-guest=false
   autologin-user=arduino
   autologin-user-timeout=0
   

   
   

   Replace arduino with the actual desktop account returned by whoami. This only configures Linux desktop login; it will not automatically log in to website accounts, nor will it disable the standby lock screen. Once enabled, anyone with access to the device can use that account directly.

3. Save the file and other work, then reboot:

   sudo reboot
   

   Confirm that you can enter that account without entering the desktop password. If the login screen still appears, check the account name and whether other LightDM configurations override the above settings.

Keep the Screen Always On​

Set X Server Parameters via LightDM​

This method is set when the X server starts, and is applicable to desktops where X11 is started by LightDM. It does not disable the password lock screen; Xfce power management or the screen saver may still reset the timers, so you need to check the display timer in Xfce "Power Manager" and the idle activation settings of the screen saver.

1. Before modifying, keep a configuration backup using the method in Auto-Login to the Desktop at Boot, then open:

   sudo nano /etc/lightdm/lightdm.conf
   

2. In the existing [Seat:*] section, find #xserver-command=X, uncomment it, and change it to:

   xserver-command=X -s 0 -dpms
   

   
   

   • -s 0: Set the X server screen saver timeout to 0, disabling that timer.
   • -dpms: Disable the X server's display power management (DPMS).

   The current screenshot uses [Seat:*], and no longer creates the old-style [SeatDefaults]. If an existing xserver-command contains other parameters, keep the necessary parameters; keep only one effective configuration in the same section.

3. After saving your work, reboot:

   sudo reboot
   

Hide the Mouse Cursor​

1. Open /etc/lightdm/lightdm.conf

   sudo nano /etc/lightdm/lightdm.conf
   

   Add -nocursor to the xserver-command in the existing [Seat:*] section. 

   
   

   To only hide the cursor:

   xserver-command=X -nocursor
   

   When the always-on setting is also needed, combine the parameters on the same line:

   xserver-command=X -s 0 -dpms -nocursor
   

   Do not add a second xserver-command, otherwise it may overwrite the original setting. Keep the three auto-login configuration items; setting only -nocursor will not enable auto-login or fullscreen web pages.

2. Save your work and run sudo reboot.

Disable App Lab Desktop Autostart​

Execute in the desktop terminal of the UNO Q's current account; sudo is not required.

xfce4-session-settings

1. In "Session and Startup", go to "Application Autostart".

2. Find "Arduino App Lab" and uncheck it.

   
   

3. Close the settings and App Lab windows, log out and log back in or reboot, and check whether App Lab no longer opens automatically.

1. Technical Manuals​

• Arduino UNO Q User Manual
• Arduino UNO Q System Image Flashing Guide

2. Software Tools​

• Arduino App Lab Download Page

3. Other Resources​

• Arduino UNO Q Product Description
• Arduino App Lab Update Notes
• Arduino Notes on Handling Outdated UNO Q Software
• Arduino Linux Config Command and Source Code Documentation (GitHub Repository)

Support

Monday-Friday (9:30-6:30) Saturday (9:30-5:30)

Email: services01@spotpear.com