Richtlijnen voor interfacegebruik van de reComputer RK3576 Module Dev Kit

Laatst bijgewerkt:

Systeemconfiguratie

Wi-Fi

De Wi-Fi- en Bluetooth-antennes zijn standaard niet gemonteerd. Installeer de antennes vóór gebruik om de signaalsterkte te verbeteren, en zorg dat ze op de juiste antennaansluitingen zijn aangesloten.

Wi-Fi-test

Shell
nmcli device wifi list
sudo nmcli device wifi connect STU-TE password seeedkey968
sudo nmcli device wifi connect test-ap password 88888888
sudo nmcli device wifi connect SEEED-OFFICE password edgemaker2025
# 1-hour ping packet loss test
ping -w 3600 192.168.254.100

Bluetooth

Bluetooth-test

Shell
bluetoothctl
scan on
scan off

Handleiding voor inloggen op afstand (SSH)

Hardware: reComputer RK3576 Module

Besturingssysteem: Debian 12

Deze handleiding beschrijft hoe je via het Secure Shell-protocol (SSH) verbinding maakt met je reComputer op afstand.

SSH inschakelen na de eerste flash

Na de eerste systeemflash draait de SSH-service mogelijk niet automatisch. Schakel deze lokaal op het apparaat in volgens de volgende stappen:

Start de SSH-service:

bash
sudo systemctl start ssh

Schakel in dat SSH automatisch start bij het opstarten:

bash
sudo systemctl enable ssh

Controleer de status van de SSH-service:

bash
systemctl status ssh

Vereisten

  • De reComputer moet ingeschakeld zijn en verbonden met hetzelfde lokale netwerk (LAN) als je hoofdcomputer.
  • Voor de initiële installatie wordt een Ethernet-verbinding aanbevolen voor maximale stabiliteit.

Het IP-adres van het apparaat bepalen

Je hebt het IP-adres van de reComputer nodig om verbinding te maken.

  • Via een lokale terminal: Als er een monitor en toetsenbord op de reComputer zijn aangesloten, voer dan het volgende commando uit:
bash
hostname -I
  • Via het routerdashboard: Ga naar de webinterface van je router en zoek in de DHCP-clientlijst naar een apparaat met de naam recomputer of vergelijkbaar.

Verbindingsmethoden

Optie A: Windows (PowerShell of Opdrachtprompt) Moderne versies van Windows bevatten een ingebouwde SSH-client.

  1. Druk op Win + R, typ cmd en druk op Enter.
  2. Voer het volgende commando in (vervang 10.0.x.x door je daadwerkelijke IP-adres):
bash
ssh seeed@10.1.x.x
  1. Typ yes wanneer je gevraagd wordt de vingerafdruk van de host te bevestigen.
  2. Voer het wachtwoord seeed in (tekens worden niet weergegeven tijdens het typen).

Optie B: Linux / macOS Terminal Open je native terminal en voer uit:

bash
ssh seeed@<Your_Device_IP>

Optie C: Professionele tools (aanbevolen) Voor een robuustere ontwikkelomgeving kun je overwegen:

  • MobaXterm: Beschikt over een ingebouwde SFTP-zijbalk voor eenvoudig slepen van bestanden.

Probleemoplossing

  • Verbinding geweigerd: Zorg dat de SSH-service actief is op de reComputer. Je kunt dit lokaal controleren door het volgende uit te voeren:
bash
sudo systemctl status ssh
  • Firewallproblemen: Als de service draait maar geblokkeerd wordt, sta dan poort 22 toe via de firewall:
bash
sudo ufw allow 22
  • Host Key Verification Failed: Als je onlangs het OS opnieuw hebt geïnstalleerd op hetzelfde IP-adres, wis dan de oude sleutel op je pc met:
bash
ssh-keygen -R <Your_Device_IP>

Foutopsporing

UART0 seriële debugging

Debuggen via UART0

Voor seriële debugging heb je een USB-naar-seriële kabel nodig om de UART0-interface op het bord aan te sluiten op de USB-poort van de pc.

9.png

Seriële login

Seriële parameters

Baudrate: 1500000

Databits: 8

Stopbits: 1

Pariteit: Geen

USB-C OTG login

Inloggen met MobaXterm

Als je bij de eerste login verbinding maakt via USB-C, moet je de gebruikersinitialisatieconfiguratie voltooien:

10.png

Plain
root
1234

Na voltooiing van de configuratie kun je het bureaublad openen

11.png

Interfacegebruik

SD-kaartsleuf

De microSD-kaart kan worden gebruikt als systeemopstartmedium of als uitgebreide opslagruimte. Het is compatibel met microSD-, microSDHC- en microSDXC-kaarten.

17.png

Wanneer deze wordt gebruikt als systeemopstartmedium, start de reComputer RK3576 Module standaard op vanaf de microSD-kaart. Zie de handleiding voor systeeminstallatie voor de procedure om het image te schrijven.

Wanneer de kaart als extra opslagruimte wordt gebruikt, hoeft u deze alleen in te steken; ze wordt automatisch herkend zonder dat er een image moet worden geflashed.

Herkennen bij hot-plug en test lees-/schrijfsnelheid:

Shell
lsblk

18.png

Shell
# read
dd if=/dev/mmcblk1p1 of=/dev/null bs=512M count=1 iflag=direct
#clear cache
echo 3 > /proc/sys/vm/drop_caches
# write
dd if=/dev/zero of=/dev/mmcblk1p1 bs=512M count=1 oflag=direct conv=fdatasync

19.png

Gebruik van de M.2 Key M-interface

Het bord beschikt over één M.2 Key M-interface, geschikt voor geheugenuitbreiding of uitbreiding van rekenkracht.

20.png

De M.2 Key M-interface ondersteunt SSD's en diverse AI-accelerators. De geteste modellen zijn:

  • SSD

    • Seeed NVMe (128GB/256GB/512GB/1TB/2TB)

    • SAMSUNG 980

    • KIOXIA-EXCERIA G2 SSD

    • NXM-128

    • TWSC TSC3AN128-F2T70S

  • AI-accelerator

    • RK1820/RK1828

    • Hailo-8/8L/10H

Opmerking

De bovenstaande modellen geven aan dat compatibiliteit is geverifieerd onder de huidige hardware- en softwareversies. Dit biedt geen garantie voor andere modellen van hetzelfde merk of andere batches. Het gedrag kan afwijken door verschillen in controller, firmware, stroomverbruik en hardwareversie. Verifieer dit zelf voordat u grote hoeveelheden inkoopt of implementeert. Deze interface ondersteunt alleen PCIe NVMe SSD's, geen M.2 SATA SSD's.

Handleiding voor SSD-gebruik

Gebruik het volgende commando om het SSD-apparaat te identificeren:

Plain
lsblk

21.png

Test de lees-/schrijfsnelheid van de SSD:

Shell
# Read
dd if=/dev/nvme0n1 of=/dev/null bs=1024M count=4 iflag=direct
#Clear Cache
echo 3 > /proc/sys/vm/drop_caches
# Write
dd if=/dev/zero of=/dev/nvme0n1 bs=1024M count=4 oflag=direct conv=fdatasync

Vervang /mnt/nvme door de daadwerkelijke mountdirectory van de SSD.

22.png

Handleiding voor Hailo-gebruik

Volg de installatievideo voor Hailo en installeer vervolgens de benodigde pakketten hieronder.

23.png

Installeer de softwarepakketten. Na het installeren van de basis PCIe-driver moet je het systeem opnieuw opstarten om de wijzigingen door te voeren.

24.png

Plain
# Install the PCIe driver
sudo dpkg -i hailort-pcie-driver_4.24.0_all.deb

# Reboot the system
sudo reboot

# After reboot, verify that the driver has been loaded
lsmod | grep hailo

# Install HailoRT
sudo dpkg -i hailort_4.24.0_arm64.deb

# Scan and verify the device status
hailortcli scan

# Create and activate the virtual environment
python3 -m venv hailo_env
source hailo_env/bin/activate

# Install the HailoRT Python library
pip install hailort-4.24.0-cp312-cp312-linux_aarch64.whl

# Verify the installation and device connection
python3 -c "from hailo_platform import VDevice; vdev = VDevice(); print('Successfully connected via VDevice! Device info:', vdev)"

25.png

26.png

27.png

Installeer Hailo Model Zoo. Om de officiële vooraf getrainde modellen uit te voeren, moet je Hailo Model Zoo en de bijbehorende systeembibliotheken installeren.

Plain
# 1. Install the required system libraries
sudo apt update
sudo apt install -y git libglib2.0-0t64 libgl1 libglx-mesa0

# 2. Clone the official repository (the latest branch is recommended)
git clone https://github.com/hailo-ai/hailo_model_zoo.git
cd hailo_model_zoo
mkdir -p ~/hailo_models
cd ~/hailo_models

wget \
https://hailo-model-zoo.s3.eu-west-2.amazonaws.com/ModelZoo/Compiled/v2.19.0/hailo8/yolov8n.hef

Controleer het bestand:

Plain
ls -lh yolov8n.hef

Parse vervolgens eerst het HEF-bestand:

Plain
hailortcli parse-hef yolov8n.hef

Zorg ervoor dat dit gericht is op:

Plain
HAILO8

in plaats van:

Plain
HAILO8L
HAILO10H

Voer het daarna direct uit:

Plain
hailortcli run yolov8n.hef

28.png

Gebruikershandleiding RK182x

De Seeed reComputer RK3576 Module ondersteunt de accelerator-sticks uit de RK182x-serie native. Er zijn geen complexe driver-installatiestappen nodig; ze werken direct out-of-the-box.

Installatie RK1820

Schakel de stroomtoevoer van de reComputer RK3576 uit.

Plaats de RK1820 AI Accelerator in de bijbehorende M.2-slot en bevestig deze met een schroef.

Na de installatie schakelt u het apparaat in en start u het systeem. De onderstaande afbeelding toont de installatiepositie.

Opmerking:

Plaats of verwijder de RK1820 niet terwijl het apparaat is ingeschakeld.

29.png

Controleer de PCIe-verbinding van de RK1820

Voer na het starten van het systeem het volgende commando uit:

Plain
lspci

Onder normale omstandigheden wordt de RK1820 herkend als een PCIe-verwerkingsversneller.

Voorbeeld:

30.png

Controleer vervolgens de PCI Vendor ID en Device ID:

Plain
lspci -nn

Voorbeeld:

31.png

Plain
1d87:182a

Dit geeft aan dat de RK1820 correct door het systeem is geïnventariseerd.

Controleer de PCIe-linkstatus

Voer het volgende commando uit:

Plain
sudo dmesg | grep -Ei "pcie|rkep|182a"

Onder normale omstandigheden ziet u iets als:

Plain
PCIe Link up
PCIe Gen.2 x1 link up
pcie-rkep 0000:01:00.0

32.png

Dit geeft aan dat de PCIe-link tussen de RK3576 en de RK1820 normaal tot stand is gekomen.

Controleer vervolgens het apparaatknooppunt (device node) van de RK1820:

Plain
ls -l /dev/pcie-rkep-*

Voorbeeld:

33.png

Plain
/dev/pcie-rkep-0000:01:00.0

Als dit apparaatknooppunt zichtbaar is, werkt de PCIe-driver van de RK1820 naar behoren.

Installeer de RKNN3-runtime

Dit artikel gebruikt RKNN3 V1.1.0. Het installatiepakket is beschikbaar via deze downloadlink.

Naam van het installatiepakket:

Plain
rknn3_rk182x_m2_v1.1.0_installer_arm64.tgz

34.png

Download het pakket naar uw pc en upload het vervolgens naar de reComputer RK3576 Dev Kit. In dit voorbeeld gebruiken we de map Downloads als opslaglocatie.

Ga naar de downloadmap:

Plain
cd ~/Downloads

Maak een map voor het uitpakken:

Plain
mkdir -p rk182x_m2_installer

Pak het installatiepakket uit:

Plain
tar -xzf rknn3_rk182x_m2_v1.1.0_installer_arm64.tgz \
-C rk182x_m2_installer

Ga naar de installatiemap:

Plain
cd rk182x_m2_installer

Voer de installatie uit:

Plain
sudo ./install.sh

Herstart het systeem na de installatie:

Plain
sudo reboot

Opmerking:

De versie van RKNN3 Runtime moet compatibel zijn met de RKNN3 Toolkit die tijdens de modelconversie is gebruikt.

Als de versies van het model en de Runtime niet overeenkomen, kunnen er tijdens het initialiseren van het model fouten optreden zoals:

Plain
MODEL_SETUP fail
rknn3_model_init fail

Verifieer de RKNN3 Runtime-omgeving

Controleer na het herstarten van het systeem de RKNN3-service:

Plain
systemctl status rknn3.service --no-pager

Onder normale omstandigheden zou dit het volgende moeten tonen:

Plain
Active: active (running)

35.png

Controleer de RKNN3-versie

Plain
sudo rknn-smi -v

Je kunt controleren:

Plain
rknn-smi version
PCIe driver version
RC chips connect version
EP chips connect version
PCIe Device firmware version
rknn3 API version

36.png

Controleer de apparaatinformatie van de RK1820

Plain
sudo rknn-smi info -l

Onder normale omstandigheden zou je iets als het volgende moeten zien:

Plain
Device Count: 1

Device ID: 0
Communication mode: PCIe
Product Name: RM1820MC0-F
Chip Count: 1
Chip ID: 0
Chip Name: RK1820

37.png

Dit geeft aan dat de RKNN3 Runtime de RK1820 succesvol heeft gedetecteerd.

Controleer de status van de RK1820 Runtime

Plain
sudo rknn-smi info

Je kunt het volgende controleren:

  • Apparaatstatus

  • Gezondheidstoestand

  • NPU-belasting

  • Temperatuur

  • Geheugengebruik

Onder normale omstandigheden zou dit het volgende moeten tonen:

Plain
Status: Online
Health: OK

38.png

Als je de status van de RK1820 in realtime wilt bekijken, voer dan het volgende commando uit:

Plain
sudo rknn-smi info -w

Dit commando is geschikt voor het observeren van veranderingen in NPU-belasting, geheugen en temperatuur tijdens modelinference.

39.png

Test de RK1820 met Qwen3.5-0.8B

Gebruik vervolgens Qwen3.5-0.8B om de LLM-inferentiemogelijkheden van de RK1820 te verifiëren. De downloadlink voor het model is:

Modelpakket (rknn3_models/v1.1.0):

Download het Qwen3.5-0.8B-model (uitpakcode: rknn)

De map van het model Qwen3.5-0.8B bevat de volgende bestanden:

Plain
Qwen3.5-0.8B/
鈹溾攢鈹€ Qwen3.5-0.8B.rknn
鈹溾攢鈹€ Qwen3.5-0.8B.weight
鈹溾攢鈹€ Qwen3.5-0.8B.tokenizer.gguf
鈹斺攢鈹€ Qwen3.5-0.8B.embed.bin

Ga naar de modelmap:

Plain
cd ~/Downloads/Qwen3.5-0.8B

Bekijk de bestanden:

Plain
ls -lh

Voorbeeld:

Plain
Qwen3.5-0.8B.embed.bin        485M
Qwen3.5-0.8B.rknn              21M
Qwen3.5-0.8B.tokenizer.gguf     11M
Qwen3.5-0.8B.weight            499M

40.png

Voordat je het model uitvoert, is het aan te raden om de versie van de RKNN3 Toolkit te controleren die door het model wordt gebruikt.

Uitvoeren:

Plain
strings Qwen3.5-0.8B.rknn | \
grep -Eai "compiler version|rknn3-toolkit|RK1820"

Controleer het model:

  • Het doelplatform is RK1820

  • De versie van de RKNN3 Toolkit is compatibel met de huidige Runtime

Als de modelversie niet overeenkomt met de huidige Runtime, wordt aanbevolen om het model te vervangen of de RKNN3 Runtime te upgraden in plaats van het model verder uit te voeren.

41.png

Voer de prestatietest voor Qwen3.5-0.8B uit. Voer het volgende commando uit:

Plain
sudo rknn3_session_test \
Qwen3.5-0.8B.rknn \
Qwen3.5-0.8B.weight \
Qwen3.5-0.8B.tokenizer.gguf \
Qwen3.5-0.8B.embed.bin \
1024 256 0xff

De belangrijkste parameters die bij deze test worden gebruikt, zijn:

Plain
Context Length : 1024
Max Output     : 256 Tokens
NPU Core Mask  : 0xff

De parameters zijn:

Context Length

Plain
1024

Geeft de contextlengte aan die bij deze test wordt gebruikt.

Max Output

Plain
256

Geeft aan dat deze test maximaal 256 Tokens genereert.

NPU Core Mask

Plain
0xff

Geeft aan dat alle beschikbare NPU Cores van de RK1820 worden gebruikt.

De gemeten resultaten voor Qwen3.5-0.8B, getest op de reComputer RK3576 Dev Kit + RK1820 AI Accelerator, zijn als volgt:

Gedetailleerde testgegevens:

42.png

Toelichting bij de testresultaten

Prefill geeft de snelheid aan waarmee het model de invoer Prompt verwerkt.

Gemeten in deze test:

Plain
319.55 tokens/s

Generate geeft de snelheid aan waarmee het model tekst token voor token genereert; dit is een belangrijkere metric voor het beoordelen van de daadwerkelijke interactieve ervaring van een LLM.

Gemeten in deze test:

Plain
95.81 tokens/s

De gemiddelde generatietijd per token is:

Plain
10.44 ms/token

De testresultaten tonen het volgende:

Qwen3.5-0.8B draait normaal op de RK1820. Bij deze testconfiguratie bedraagt de gemeten generatiesnelheid ongeveer 95.81 tokens/s.

Bewaking van de RK1820 tijdens inferentie

Tijdens het uitvoeren van de modeltest kunt u een tweede terminal openen en het volgende commando uitvoeren:

Plain
sudo rknn-smi info -w

Hiermee observeert u in real time:

Plain
NPU Utilization
Memory Usage
Temperature
Health Status

Dit stelt u in staat om de belasting, het geheugengebruik en de temperatuurstatus van de RK1820 te beoordelen terwijl het model actief is.

Veelvoorkomende problemen

MODEL_SETUP mislukt

Als de volgende foutmelding verschijnt bij het uitvoeren van het model:

Plain
MODEL_SETUP fail, ack = ACK_FAIL
rknn3_model_init, recv model setup fail ack

Controleer eerst de versie die gebruikt is voor de modelconversie:

Plain
strings *.rknn | \
grep -Eai "compiler version|rknn3-toolkit|RK1820"

Controleer vervolgens de huidige RKNN3 Runtime:

Plain
rknn-smi version

Zorg dat de Runtime compatibel is met de versie van de RKNN3 Toolkit die tijdens de modelconversie is gebruikt.

RK1820 niet herkend

Voer uit:

Plain
lspci -nn

Controleer of het volgende aanwezig is:

Plain
1d87:182a

Controleer daarna het apparaatknooppunt:

Plain
ls -l /dev/pcie-rkep-*

Controleer tot slot:

Plain
rknn-smi info -l

Als lspci de RK1820 niet herkent, controleer dan eerst de M.2-installatie en de PCIe-verbinding, in plaats van de RKNN3 Runtime.

Abnormale status van de RK1820

Voer uit:

Plain
sudo rknn-smi info

De normale status moet zijn:

Plain
Online
Health: OK

Als het apparaat offline is, kunt u verder controleren:

Plain
sudo dmesg | grep -Ei "pcie|rkep|182a"

Controleer de logbestanden gerelateerd aan PCIe en de RK1820-driver.

Testconclusie

Na het voltooien van bovenstaande configuratie kunt u de RK1820 AI-accelerator via PCIe gebruiken op de reComputer RK3576 Dev Kit.

Deze test maakt gebruik van Qwen3.5-0.8B voor verificatie:

Plain
Model            : Qwen3.5-0.8B
Prefill Speed    : 300.49 tokens/s
Generate Speed   : 92.89 tokens/s
Time per Token   : 10.77 ms
Result           : PASS

Dit toont aan dat de volledige LLM-inferentieketen RK3576 → PCIe → RK1820 → RKNN3 → Qwen3.5-0.8B correct functioneert.

Handleiding HDMI 2.1

Het bord beschikt over een HDMI 2.1-interface voor het aansluiten van schermen en andere videotoestellen, met ondersteuning voor maximaal 4K bij 120 fps.

Opmerking

De daadwerkelijk beschikbare resolutie en vernieuwingsfrequentie zijn afhankelijk van het weergavetoestel, de HDMI-kabel en de systeemdriver. Bij gebruik van 4K@120 Hz wordt een HDMI 2.1-kabel aanbevolen die de bijbehorende bandbreedte ondersteunt.

43.png

In het Armbian Desktop-systeem kun je de HDMI-uitvoerparameters via de grafische interface of de opdrachtregel aanpassen.

Instellen via de grafische interface

  1. Open Instellingen vanaf het Armbian-bureaublad.

  2. Open Schermen.

  3. Selecteer het aangesloten HDMI-schermapparaat.

  4. Stel de resolutie, verversingssnelheid, schermoriëntatie en schaalverhouding in.

  5. Klik op Toepassen, controleer of het beeld correct wordt weergegeven en sla de instellingen op.

44.png

Instellen via de opdrachtregel

Controleer eerst het type van de huidige bureaubladsessie:

Plain
echo "$XDG_SESSION_TYPE"

Als de uitvoer x11 is, kun je xrandr gebruiken om de HDMI-uitvoerparameters in te stellen. Voer de volgende commando's uit in een terminal op het Armbian-bureaublad als de huidige gebruiker; gebruik geen sudo.

Controleer de displayinterfaces en hun ondersteunde resoluties en verversingssnelheden:

Plain
xrandr --query

Als het systeem meldt dat het commando xrandr niet kan worden gevonden, voer dan het volgende uit:

Plain
sudo apt update
sudo apt install x11-xserver-utils

De naam van de HDMI-interface kan variëren, bijvoorbeeld HDMI-1, HDMI-A-1 of een andere aanduiding. Gebruik in de onderstaande commando's de naam die door xrandr --query wordt gerapporteerd.

Stel bijvoorbeeld de HDMI-uitvoer in op 4K bij 60 Hz:

Plain
xrandr --output HDMI-1 --mode 3840x2160 --rate 60

Als de moduslijst van xrandr --query 4K bij 120 Hz bevat, voer dan het volgende uit:

Plain
xrandr --output HDMI-1 --mode 3840x2160 --rate 120

Stel HDMI in als primair monitor:

Plain
xrandr --output HDMI-1 --primary

Schakel de HDMI-uitvoer uit:

Plain
xrandr --output HDMI-1 --off

Opmerking:

  • xrandr-instellingen zijn meestal alleen actief in de huidige grafische sessie en kunnen na een herstart terugvallen op de standaardwaarden. Om ze permanent te maken, stel je ze in via de grafische displayinstellingen.

  • Als $XDG_SESSION_TYPE wayland retourneert, gebruik dan eerst de grafische interface om de displayparameters aan te passen.

  • Als de uitvoer tty is, draait er geen grafisch bureaublad, waardoor noch de grafische instellingen noch xrandr direct kunnen worden gebruikt.

  • Als de gewenste resolutie of verversingssnelheid niet in de lijst met ondersteunde waarden staat, controleer dan de specificaties van het scherm, de HDMI-kabel en de systeemdrivers.

Handleiding voor Ethernet-interface (met PoE-ondersteuning)

Sluit de Ethernet-poort aan om verbinding te maken met een bekabeld netwerk.

45.png

Haal het netwerkadres op:

Plain
ip -br addr
ip route
nmcli device status

Controleer de onderhandelde linksnelheid:

Plain
sudo apt install -y ethtool
sudo ethtool <interface>

Test het netwerk:

Plain
ping -c 4 8.8.8.8
ping -c 4 www.seeedstudio.com

Snelheidstest:

Plain
sudo apt install -y iperf3
iperf3 -c <server_ip>

PoE-gebruik

De reComputer RK3576 IO Board ondersteunt de Raspberry Pi PoE+ HAT, die zowel stroom als netwerkconnectiviteit via één Ethernet-kabel biedt.

De PoE-stroomvoorziening wordt automatisch afgehandeld door de PoE+ HAT. Er is geen driverinstallatie of extra configuratie in Armbian nodig.

Installeer de PoE+ HAT volgens de hardware-installatie-instructies en sluit vervolgens de Ethernet-kabel aan.

Na het opstarten van het systeem kun je met de volgende commando's de netwerkinterfaces en het IP-adres controleren:

Plain
ip -br addr

Als er succesvol een IP-adres is verkregen, is de Ethernetverbinding beschikbaar.

PoE en DC 12V kunnen tegelijkertijd op de reComputer RK3576 IO Board worden aangesloten.

Wanneer beide stroombronnen zijn aangesloten:

  • Als je PoE loskoppelt, blijft het systeem draaien op DC 12V zonder herstart.

  • Als je DC 12V loskoppelt, blijft het systeem draaien op PoE zonder herstart.

Dit betekent dat je tijdens gebruik kunt schakelen tussen PoE en DC 12V zonder de systeemoperatie te onderbreken.

Koppel alle stroombronnen los voordat je de PoE+ HAT installeert of verwijdert. Het wordt aanbevolen om een PoE+ switch of injector te gebruiken die voldoet aan de IEEE 802.3at-standaard.

MIPI CSI-handleiding

De reComputer RK3576 IO Board biedt twee MIPI CSI-interfaces, CSI1 en CSI2, die directe aansluiting van de Raspberry Pi Camera Module 3 ondersteunen.

46.png

In het vooraf geïnstalleerde Armbian-systeem werkt de Camera Module 3 zonder dat extra drivers hoeven te worden geïnstalleerd of de device tree moet worden geconfigureerd; deze is direct gereed voor gebruik na correcte aansluiting.

Hardware-aansluiting

Steek de CSI-camera niet in of trek deze niet uit terwijl het apparaat is ingeschakeld, om schade aan de camera of de IO Board te voorkomen.

Tools installeren

Installeer GStreamer en de cameradetectietools:

Plain
sudo apt update
sudo apt install -y \
    v4l-utils \
    gstreamer1.0-tools \
    gstreamer1.0-plugins-base \
    gstreamer1.0-plugins-good \
    gstreamer1.0-plugins-bad \
    gstreamer1.0-plugins-ugly \
    gstreamer1.0-libav

De cameraknoop vinden

Gebruik het volgende commando om de door het systeem herkende camera-apparaten weer te geven:

Plain
v4l2-ctl --list-devices

U kunt ook de Media Controller-topologie weergeven:

Plain
media-ctl -d /dev/media2 -p

In de huidige systeemimage zijn de standaard videotoestandsknooppunten als volgt:

De videoknooppunten kunnen veranderen afhankelijk van de systeemversie, de aansluitmethode van de camera of de opstartvolgorde van het apparaat. Als de standaardknooppunten niet beschikbaar zijn, controleer dan de daadwerkelijke videoknooppunten via v4l2-ctl --list-devices en media-ctl.

Een foto maken met CSI1

Wanneer de camera is aangesloten op CSI1, voert u uit:

Plain
gst-launch-1.0 \
    v4l2src device=/dev/video22 num-buffers=1 ! \
    videoconvert ! \
    jpegenc ! \
    filesink location=test1.jpg

Nadat de foto is genomen, wordt deze opgeslagen in de huidige map:

Plain
ls -lh test1.jpg

Een foto maken met CSI2

Wanneer de camera is aangesloten op CSI2, voert u uit:

Plain
gst-launch-1.0 \
    v4l2src device=/dev/video31 num-buffers=1 ! \
    videoconvert ! \
    jpegenc ! \
    filesink location=test2.jpg

Bekijk de gegenereerde foto:

Plain
ls -lh test2.jpg

47.png

Probleemoplossing

Als er geen cameraknooppunt wordt gevonden, controleer dan het volgende:

  1. Of de lintkabel van de camera volledig is ingestoken.

  2. Of de oriëntatie van de lintkabel correct is.

  3. Of de vergrendeling van de CSI-interface gesloten is.

  4. Of de camera is aangesloten terwijl het apparaat was uitgeschakeld.

  5. Of het systeem de Camera Module 3 herkent:

Plain
dmesg | grep -Ei "imx708|csi|rkisp"

De Raspberry Pi Camera Module 3 maakt gebruik van de IMX708-sensor. Als het logboek imx708, rkisp of gerelateerde CSI-informatie bevat, is de camera door het systeem herkend.

Handleiding voor MIPI DSI

Het reComputer RK3576 IO Board ondersteunt de aansluiting van de officiële Raspberry Pi 7-inch DSI-touchscreen. Voordat u dit gebruikt, moet u de DSI-lintkabel aansluiten, de I²C-jumper overbruggen en de bijbehorende device tree overlay inschakelen in Armbian.

48.png

Hardware-aansluiting

Volg het hierboven getoonde schema voor de hardwareaansluiting.

De I²C-interface wordt gebruikt voor communicatie met de touchcontroller. Als deze jumper niet is overbrugd, kan het scherm wel beelden weergeven, maar zal de touchfunctie niet naar behoren werken.

Als u de reComputer RK3576 Module Dev Kit-serie heeft gekocht, is de jumpercap al geïnstalleerd, dus hoeft u zich hierover geen zorgen te maken.

49.png

Device Tree Overlay inschakelen

Maak een back-up van het huidige configuratiebestand om de device tree overlay in te schakelen:

Plain
sudo cp /boot/armbianEnv.txt /boot/armbianEnv.txt.bak

Open het configuratiebestand:

Plain
sudo vim /boot/armbianEnv.txt

Stel overlay_prefix in op:

Plain
overlay_prefix=recomputer-rk3576-ioboard

Voeg de volgende overlay toe:

Plain
overlays=raspi-7inch-touchscreen

Na de configuratie moet de relevante inhoud er als volgt uitzien:

Plain
overlay_prefix=recomputer-rk3576-ioboard
overlays=raspi-7inch-touchscreen

Als er al andere overlays zijn ingeschakeld via overlays=, scheid deze dan met spaties en behoud de originele inhoud, bijvoorbeeld:

Plain
overlays=existing-overlay raspi-7inch-touchscreen

Voor systemen zonder andere actieve overlays kun je ook het volgende commando gebruiken om de configuratie snel af te ronden:

Plain
sudo sed -i '/^overlay_prefix=/d; /^overlays=/d' /boot/armbianEnv.txt

printf '%s\n' \
    'overlay_prefix=recomputer-rk3576-ioboard' \
    'overlays=raspi-7inch-touchscreen' \
    | sudo tee -a /boot/armbianEnv.txt

Desktopweergave configureren

Maak de Xorg-configuratiemap aan:

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

Maak de DSI-displayconfiguratie aan:

Plain
sudo tee /etc/X11/xorg.conf.d/99-dsi.conf > /dev/null <<'EOF'
Section "Device"
    Identifier "DSI"
    Driver "modesetting"
    Option "kmsdev" "/dev/dri/card1"
    Option "DRI" "3"
    Option "AccelMethod" "glamor"
EndSection

Section "Screen"
    Identifier "Screen0"
    Device "DSI"
EndSection

Section "ServerLayout"
    Identifier "Layout"
    Screen 0 "Screen0" 0 0
EndSection
EOF

Herstart het systeem om de configuratie actief te maken:

Plain
sudo reboot

Weergave en touch controleren

Na het herstarten van het systeem moet het DSI-scherm de Armbian-desktop weergeven en touchbediening ondersteunen.

Om te bevestigen of het touchapparaat wordt herkend, voer je het volgende uit:

Plain
sudo apt install -y evtest
sudo evtest

Selecteer het bijbehorende touchapparaat in de apparatenlijst, klik of veeg over het scherm. Als de terminal continu touchcoördinaten en toetsgebeurtenissen blijft uitvoeren, werkt de touchfunctie correct.

De huidige configuratie gebruikt /dev/dri/card1 als DSI-displayapparaat. Controleer dit met het volgende commando als het DRM-apparaatnummer verandert na een systeemupgrade:

Plain
ls -l /dev/dri/

Handleiding voor de GPIO-interface

Shell
# Calculation formula: gpionum=(letter_index-1)*8+num
recomputer-rk3576-module:~:# gpioset 0 23=0
recomputer-rk3576-module:~:# gpioset 0 23=1

#Read status
gpioget 0 23
RK3576 gpioHeader NumberHeader NumberRK3576 gpio
VCC3V3_SYS12VCC5V0_SYS
GPIO0_C734VCC5V0_SYS
GPIO0_C656GND
GPIO3_A078UART0_TX_M0_DEBUG
GND910UART0_RX_M0_DEBUG
GPIO4_B4
1112GPIO2_D6
GPIO4_B5
1314
GND
GPIO3_A2
1516
GPIO2_D0
VCC3V3_SYS1718
GPIO2_D1
GPIO2_C21920
GPIO2_C3
2122
GPIO3_A1
GPIO2_C52324GPIO2_C4
2526GPIO2_C1
GPIO4_C7
2728GPIO4_C6
GPIO2_B6
2930GND
GPIO2_B7
3132GPIO2_C0
GPIO0_C4
33
34GND
GPIO2_B5
3536
GPIO3_A3
GPIO2_B4
3738GPIO4_A4
GND
3940GPIO4_A6

Referentie voor GPIO en randapparatuur van de 40-pins header

De reComputer RK3576 Module Dev Kit beschikt over een Raspberry Pi-compatibele 40-pins uitbreidingsheader. Via deze header kunnen externe GPIO-apparaten, UART-modules, I2C-sensoren, SPI-apparaten, PWM-actuatoren en CAN-interfaces worden aangesloten. De pinctrl-multiplexing van de Rockchip RK3576 bepaalt welke functie actief is op elke pin.

Ondersteunde interfaces:

  • GPIO
  • UART
  • I2C
  • SPI
  • PWM
  • CAN

In de onderstaande tabel staan de signaalpins en hun bijbehorende RK GPIO-namen vermeld. Voedings- en ground-pins zijn te vinden in de volledige pinout-tabel hierboven.

PinFunctieRK GPIO
3GPIOGPIO0_23
5GPIOGPIO0_22
7GPIOGPIO3_96
8UART TX/RXGPIO0_28
10UART RX/TXGPIO0_29
11GPIOGPIO4_140
12GPIOGPIO2_94
13GPIOGPIO4_141
15GPIOGPIO3_98
16GPIOGPIO2_88
18GPIOGPIO2_89
19SPI MOSIGPIO2_82
21SPI MISOGPIO2_83
22GPIOGPIO3_97
23SPI CLKGPIO2_85
24SPI CSGPIO2_84
26GPIOGPIO2_81
27GPIOGPIO4_151
28GPIOGPIO4_150
29GPIOGPIO2_78
31GPIOGPIO2_79
32GPIOGPIO2_80
33GPIOGPIO0_20
35GPIOGPIO2_77
36GPIOGPIO3_99
37GPIOGPIO2_76
38GPIOGPIO4_132
40GPIOGPIO4_134

GPIO-besturing

Installeer de Linux GPIO-tools:

bash
sudo apt update
sudo apt install gpiod

Controleer de GPIO-controllers, lijnnamen en het huidige eigendom voordat je een lijn selecteert:

bash
gpioinfo
gpioinfo gpiochip0

De gpiochip en het lijnnummer zijn afhankelijk van de image en de kernel. Gebruik de uitvoer van gpioinfo om deze te controleren, in plaats ervan uit te gaan dat een fysiek pinnummer op de header overeenkomt met een Linux-lijnnummer.

Sluit bijvoorbeeld een LED via een stroombeperkingsweerstand aan op een lijn die als lijn 23 op gpiochip0 is blootgesteld:

text
GPIO ---- resistor ---- LED ---- GND

Stel de uitgang hoog en laag in:

bash
gpioset gpiochip0 23=1
gpioset gpiochip0 23=0

Sluit een knop aan tussen de ingang en 3,3 V (gebruik een geschikte pull-down of de geconfigureerde pull-weerstand van het board) en lees vervolgens de lijn:

text
3.3V
 |
Button
 |
GPIO
bash
gpioget gpiochip0 23

UART Voorbeeld

Om UART3 in te schakelen, voeg je de overlay toe aan /boot/armbianEnv.txt:

bash
sudo nano /boot/armbianEnv.txt
ini
overlays=recomputer-rk3576-devkit-40pin-uart3

Herstart en controleer de beschikbare seriële apparaten:

bash
sudo reboot
ls /dev/tty*

Verstuur een testreeks via het UART-apparaat dat door de geselecteerde overlay wordt blootgesteld (bijvoorbeeld /dev/ttyS3):

bash
echo "Hello RK3576" > /dev/ttyS3

I2C Voorbeeld

Schakel I2C3 in /boot/armbianEnv.txt in:

ini
overlays=recomputer-rk3576-devkit-40pin-i2c3

Installeer de I2C-hulpprogramma's en scan bus 3 na het herstarten:

bash
sudo apt install i2c-tools
sudo i2cdetect -y 3

Een uitvoerrij zoals hieronder geeft aan dat er een apparaat op adres 0x50 aanwezig is:

text
40: -- -- 50 --

SPI Voorbeeld

De standaard RK3576 Module Dev Kit-image kan de 40-pins SPI-bus mogelijk standaard inschakelen. Als SPI niet is ingeschakeld op de geïnstalleerde image, voeg dan de bijbehorende overlay toe en herstart:

ini
overlays=rk3576-spi1-m1-spidev

Controleer de aanwezigheid van de spidev-node en voer een basistest uit:

bash
ls /dev/spidev*
spidev_test -D /dev/spidev1.0

De fysieke SPI-signalen delen hardware met bepaalde onboard uitbreidingsinterfaces. Controleer chip-selectie en bus-eigendom voordat je een ander SPI-apparaat aansluit.

PWM Voorbeeld

PWM-uitgangen kunnen LED-dimmers, ventilatoren of servo's aansturen. Schakel de PWM-overlay in als deze nog niet actief is:

ini
overlays=recomputer-rk3576-devkit-40pin-pwm2-ch6

Na het herstarten identificeer je de PWM-controller en het kanaal onder /sys/class/pwm/, en configureer je vervolgens het kanaal. De volgende waarden vertegenwoordigen een periode van 20 ms en een servopuls van 1,5 ms:

bash
ls /sys/class/pwm/
echo 20000000 > period
echo 1500000 > duty_cycle
echo 1 > enable

Voer de echo-commando's uit vanuit de geselecteerde geëxporteerde pwmchipX/pwmY-directory. De exacte controller en het kanaal kunnen variëren afhankelijk van de device tree van de kernel.

CAN Voorbeeld

Schakel CAN0 in met de 40-pins overlay en start het systeem opnieuw op:

ini
overlays=recomputer-rk3576-devkit-40pin-can0

Configureer de interface op 500 kbit/s, stuur vervolgens een testframe en ontvang deze:

bash
sudo ip link set can0 up type can bitrate 500000
cansend can0 123#11223344
candump can0

Opmerkingen over pinmultiplexing

De RK3576 maakt gebruik van pinmultiplexing. Een fysieke pin kan werken als GPIO of als signaal voor een randapparaat, afhankelijk van de gekozen device-tree overlay. Voordat je een randapparaatfunctie gebruikt:

  1. Schakel de bijbehorende overlay in.
  2. Start het systeem opnieuw op.
  3. Controleer of het verwachte apparaatknooppunt bestaat.
  4. Test het met de bijbehorende Linux-tool.

Als een pin wordt ingenomen door UART, I2C, SPI, PWM of een andere kernel-driver, kan deze niet als normale GPIO worden gebruikt totdat die functie is uitgeschakeld.

Problemen oplossen met GPIO en Pinmux

Controleer het eigendom van de GPIO's:

bash
sudo cat /sys/kernel/debug/gpio

Controleer welke overlays zijn ingeschakeld:

bash
cat /boot/armbianEnv.txt

Controleer de pinmultiplexing in de device-tree:

bash
cat /sys/kernel/debug/pinctrl/*/pinmux-pins

De 40-pins header volgt de indeling van de Raspberry Pi-uitbreidingsheader, waardoor veel Raspberry Pi-accessoires kunnen worden aangesloten. De pinmultiplexing van de RK3576 verschilt echter van die van Raspberry Pi-platforms; controleer altijd de pinfoonietabel en de geselecteerde overlay voordat je een HAT of ander accessoire aansluit.

Handleiding voor de ventilator

Het reComputer RK3576 IO Board ondersteunt PWM-ventilatorbesturing. In Armbian kun je de Linux hwmon-interface gebruiken om de ventilatorsnelheid te controleren en de PWM handmatig aan te passen.

50.png

Het hwmon-nummer kan veranderen na een herstart van het systeem, dus vertrouw niet op een vaste waarde zoals hwmon6. De volgende commando's gebruiken jokertekens om automatisch het juiste ventilatorapparaat te vinden.

Ventilatorsnelheid controleren

Voer het volgende commando uit om de huidige ventilatorsnelheid te controleren:

Plain
cat /sys/devices/platform/pwm-fan/hwmon/hwmon*/fan1_input

De geretourneerde waarde staat in RPM, bijvoorbeeld:

Plain
3200

Om de snelheid continu te monitoren, voer je het volgende uit:

Plain
watch -n 1 'cat /sys/devices/platform/pwm-fan/hwmon/hwmon*/fan1_input'

Druk op Ctrl+C om het monitoren te beëindigen.

Huidige PWM-waarde controleren

Plain
cat /sys/devices/platform/pwm-fan/hwmon/hwmon*/pwm1

Het geldige PWM-bereik is 0鈥?55.

De PWM-verhouding en de werkelijke snelheid zijn niet noodzakelijk lineair. De Linux pwm-fan driver specificeert dat pwm1 varieert van 0–255, waarbij 255 de maximale uitvoer vertegenwoordigt.

Ventilatorsnelheid instellen

Ventilator uitschakelen:

Plain
echo 0 | sudo tee /sys/devices/platform/pwm-fan/hwmon/hwmon*/pwm1

Instellen op ongeveer 50% PWM:

Plain
echo 128 | sudo tee /sys/devices/platform/pwm-fan/hwmon/hwmon*/pwm1

Instellen op maximale PWM:

Plain
echo 255 | sudo tee /sys/devices/platform/pwm-fan/hwmon/hwmon*/pwm1

Na het instellen kun je de ventilatorsnelheid opnieuw controleren:

Plain
cat /sys/devices/platform/pwm-fan/hwmon/hwmon*/fan1_input

Handmatig ingestelde PWM-waarden worden niet permanent behouden na een systeemherstart. Het systeem herstelt na een herstart het standaardbeleid voor ventilatorregeling. Bij hoge belasting wordt het afgeraden om de ventilator langdurig uit te laten, om throttling van de processor door oververhitting te voorkomen.

51.png

Status LED-indicatoren

De reComputer RK3576 IO Board beschikt over LEDs die de voeding en systeemstatus aangeven.

52.png

Knipperen van de systeemstatus-LED geeft aan dat de Linux-kernel is gestart, maar betekent niet dat alle systeemservices of gebruikersapplicaties gereed zijn.

LED-apparaat controleren

De systeemstatus-LED wordt beheerd door het Linux LED-subsysteem. Gebruik het volgende commando om de LEDs in het systeem weer te geven:

Plain
ls /sys/class/leds/

In de huidige Armbian device tree verschijnt de systeemstatus-LED meestal als:

Plain
user-led

Controleer de huidige triggermodus:

Plain
cat /sys/class/leds/user-led/trigger

Het item tussen vierkante haken in de uitvoer geeft de huidige modus aan, bijvoorbeeld:

Plain
none timer default-on [heartbeat]

Systeemstatus-LED handmatig bedienen

Om de systeemstatus-LED te gebruiken voor indicatie van applicatiestatus, kun je eerst de heartbeat-trigger uitschakelen:

Plain
echo none | sudo tee /sys/class/leds/user-led/trigger

LED inschakelen:

Plain
echo 1 | sudo tee /sys/class/leds/user-led/brightness

LED uitschakelen:

Plain
echo 0 | sudo tee /sys/class/leds/user-led/brightness

Systeem-heartbeatmodus herstellen:

Plain
echo heartbeat | sudo tee /sys/class/leds/user-led/trigger

De bovenstaande instellingen zijn alleen effectief tijdens de huidige opstartcyclus. Na een systeemherstart wordt de standaard heartbeatmodus uit de device tree hersteld.

Opmerkingen

  • De rode voedings-LED geeft alleen aan dat het bord met stroom wordt gevoed; deze kan niet worden gebruikt om te bepalen of Linux volledig is opgestart.

  • De status-LED van het systeem kan door applicaties worden aangestuurd, maar zodra deze naar de handmatige modus is geschakeld, geeft hij niet langer de systeemhartslag weer.

  • Het wordt afgeraden om deze indicator via een vast hwmon- of GPIO-nummer aan te sturen; gebruik in plaats daarvan de interface /sys/class/leds/user-led/.

Knopbeschrijving

De reComputer RK3576 IO Board beschikt over drie ingebouwde knoppen: PWR, RESET en MASKROM.

53.png

PWR-knop

De PWR-knop is aangesloten op de power-key-ingang. In Linux wordt deze herkend als rk806 pwrkey en genereert hij KEY_POWER-gebeurtenissen wanneer erop wordt gedrukt.

Afhankelijk van de systeemomgeving kan dit event zijn ingesteld om uit te schakelen, te sluimeren of het uitschakelmenu te openen.

Installeer de knoptesttool:

Plain
sudo apt update
sudo apt install -y evtest

Voer de test uit:

Plain
sudo evtest

Selecteer in de apparaatlijst:

Plain
rk806 pwrkey

Na het indrukken van de PWR-knop ziet u een uitvoering vergelijkbaar met:

Plain
Event: type 1 (EV_KEY), code 116 (KEY_POWER), value 1
Event: type 1 (EV_KEY), code 116 (KEY_POWER), value 0

Om het systeemgedrag na een korte druk op de PWR-knop te wijzigen, kunt u de systemd-logind-configuratie bewerken:

Plain
sudo nano /etc/systemd/logind.conf

Stel bijvoorbeeld de actie voor een korte druk in op uitschakelen:

Plain
HandlePowerKey=poweroff

Pas de configuratie toe:

Plain
sudo systemctl restart systemd-logind

Het wordt aanbevolen om sudo poweroff of de uitschakelfunctie van het bureaubladmilieu te gebruiken om het apparaat veilig uit te schakelen, om schade aan het bestandssysteem of gegevens door direct stroomverlies te voorkomen.

RESET-knop

Het indrukken van de RESET-knop activeert een hardwarematige reset en het systeem start onmiddellijk opnieuw op.

RESET voert het normale Linux-uitschakelproces niet uit, waardoor niet-opgeslagen gegevens verloren kunnen gaan. Onder normale omstandigheden wordt aanbevolen om het volgende te gebruiken:

Plain
sudo reboot

Gebruik de RESET-knop alleen wanneer het systeem niet meer reageert en niet normaal kan worden herstart via de terminal of SSH.

MASKROM-knop

De MASKROM-knop dwingt het apparaat af om de Rockchip MaskROM-modus te betreden. Deze modus wordt voornamelijk gebruikt in de volgende situaties:

  • Het systeem kan niet opstarten vanaf eMMC of andere opslagapparaten

  • De bootloader is beschadigd

  • Kan niet normaal de Loader-modus betreden

  • Het systeemimage moet opnieuw worden geflasht

MaskROM-modus betreden

  1. Sluit de IO Board aan op de host met een USB-C-kabel die datatransport ondersteunt.

  2. Schakel de voeding van het apparaat uit.

  3. Houd de knop MASKROM ingedrukt.

  4. Schakel de voeding van het apparaat in.

  5. Laat de knop los zodra de host het Rockchip MaskROM-apparaat detecteert.

Als het apparaat al is ingeschakeld, kun je ook:

  1. De knop MASKROM ingedrukt houden.

  2. Kort op de knop RESET drukken.

  3. Wachten tot de host het apparaat herkent en de MASKROM-knop dan loslaten.

Op Windows kun je de status van het apparaat controleren via RKDevTool of RK Driver Assistant:

Plain
Found One MASKROM Device

Op een Linux-host kun je het volgende commando uitvoeren:

Plain
lsusb

Controleer of er een Rockchip USB-apparaat verschijnt op de host.

MASKROM is een systeemherstelfunctie. Het gebruik van deze knop voor normale applicatie-interactie wordt afgeraden. Na het betreden van de MaskROM-modus start Linux niet normaal; je moet het apparaat opnieuw inschakelen of resetten om de modus te verlaten.

Handleiding voor de USB-interface

Het reComputer RK3576 IO Board biedt de volgende USB-interfaces:

USB-C ondersteunt wisseling tussen Host- en Device-rollen. De daadwerkelijke werkmodus wordt bepaald door de aansluitrichting, de kabel en het aangesloten apparaat.

54.png

USB-apparaten controleren

Voer na het aansluiten van een USB-apparaat het volgende commando uit:

Plain
lsusb

Bekijk de connectietopologie en de onderhandelde snelheid van USB-apparaten:

Plain
lsusb -t

De uitvoering ziet er als volgt uit:

Plain
seeed@recomputer-rk3576-module:~$ lsusb -t
/:  Bus 001.Port 001: Dev 001, Class=root_hub, Driver=xhci-hcd/1p, 480M
    |__ Port 001: Dev 002, If 0, Class=Hub, Driver=hub/4p, 480M
        |__ Port 004: Dev 003, If 0, Class=Human Interface Device, Driver=usbhid, 12M
        |__ Port 004: Dev 003, If 1, Class=Human Interface Device, Driver=usbhid, 12M
/:  Bus 002.Port 001: Dev 001, Class=root_hub, Driver=xhci-hcd/1p, 5000M

Als een USB 3.0-apparaat alleen als 480M wordt weergegeven, controleer dan het volgende:

  • Of het apparaat USB 3.x ondersteunt

  • Of de kabel SuperSpeed ondersteunt

  • Of het apparaat is aangesloten op een USB 3.0 Type-A interface

  • Of de USB-hub of adapter USB 3.x ondersteunt

Verbindingslogboeken van apparaten bekijken

Voer het volgende commando uit voordat je het USB-apparaat insteekt:

Plain
sudo dmesg --follow

Sluit vervolgens het apparaat aan om realtime informatie over apparaatherkenning, driverladen en foutmeldingen te zien. Druk op Ctrl+C om te beëindigen.

Je kunt ook de recente USB-logboeken bekijken:

Plain
dmesg | grep -i usb

USB-opslagapparaten gebruiken

Controleer het apparaatnode nadat je een USB-stick of externe harde schijf hebt aangesloten:

Plain
lsblk

Armbian Desktop koppelt opslagapparaten meestal automatisch. Je kunt ze ook handmatig koppelen:

Plain
sudo mkdir -p /mnt/usb
sudo mount /dev/sda1 /mnt/usb

Koppel het apparaat los voordat je het verwijdert:

Plain
sudo umount /mnt/usb

/dev/sda1 is slechts een voorbeeld. Controleer het daadwerkelijke apparaatnode via lsblk om te voorkomen dat je per ongeluk de verkeerde schijf bewerkt.

USB-C OTG

De USB-C-interface kan in verschillende scenario’s verschillende rollen vervullen:

  • Apparaatmodus: Verbinding maken met een pc voor systeemflashing en communicatie via Rockchip Loader/MaskROM.

  • Hostmodus: Aansluiten van USB-periferie via een geschikte USB-C-adapter.

  • DP Alt Mode: Aansluiten van beeldschermen die DisplayPort Alt Mode ondersteunen.

Gebruik voor systeemflashing een USB-C-kabel die gegevensoverdracht ondersteunt. Kabels die alleen voor opladen zijn bedoeld, worden niet herkend door het apparaat.

Voor stroomintensieve USB-periferie, zoals externe harde schijven en AI-accelerators, wordt aanbevolen een USB-hub met eigen voeding te gebruiken. Dit voorkomt dat apparaten loskoppelen of het systeem instabiel wordt door onvoldoende stroomtoevoer.

De ingebouwde interfaces bestaan uit één USB 3.0 Type-A-poort en twee Type-A-poorten die via een USB 2.0 Hub zijn uitgebreid; de USB-C-poort is in de Armbian device tree geconfigureerd als een OTG-interface met dubbele rol.

Handleiding RTC-interface

Het reComputer RK3576 IO Board heeft een geïntegreerde RTC, die datum en tijd blijft bijhouden nadat het apparaat de netwerkverbinding of stroomvoorziening verliest.

De RTC is verbonden via I²C, met een standaardadres van:

Plain
0x51

Het carrier board biedt een houder voor een CR2032-back-upbatterij. Na installatie van de batterij blijft de RTC doortellen, zelfs als DC-, PoE- en USB-C-voeding zijn onderbroken.

55.png

Gebruik een niet-oplaadbare 3V CR2032 knoopcelbatterij en controleer of de polariteit correct is.

De RTC-apparaat controleren

Voer het volgende commando uit om te bevestigen of de RTC door het systeem is herkend:

Plain
ls /dev/rtc*

Controleer de naam van de RTC-driver:

Plain
for rtc in /sys/class/rtc/rtc*; do
    echo "$rtc: $(cat "$rtc/name")"
done

Onder normale omstandigheden zie je het RTC-apparaat dat correspondeert met de PCF8563.

Controleer het kernelherkenningslogboek:

Plain
dmesg | grep -i rtc

Systeemtijd en RTC-tijd weergeven

Controleer de systeemtijd:

Plain
timedatectl

Controleer de RTC-tijd:

Plain
sudo hwclock --show

Als het systeem meldt dat hwclock niet kan worden gevonden, installeer dan de benodigde tools:

Plain
sudo apt update
sudo apt install -y util-linux-extra

Systeemtijd naar de RTC schrijven

Nadat het apparaat verbinding heeft gemaakt met het netwerk, kun je eerst de netwerktijdsynchronisatie inschakelen:

Plain
sudo timedatectl set-ntp true

Bevestig dat de systeemtijd correct is:

Plain
timedatectl

Schrijf vervolgens de systeemtijd naar de RTC:

Plain
sudo hwclock --systohc --utc

Het wordt aanbevolen om UTC-tijd te gebruiken voor de RTC. Dit voorkomt tijdafwijkingen door tijdzone- of zomertijdswijzigingen:

Plain
sudo timedatectl set-local-rtc 0

Systeemtijd herstellen vanuit de RTC

Wanneer het apparaat geen toegang heeft tot het netwerk, kun je de RTC-tijd synchroniseren met het systeem:

Plain
sudo hwclock --hctosys

Controleer na het synchroniseren:

Plain
date

Tijd handmatig instellen

Als het apparaat tijdelijk geen netwerktoegang heeft, kun je de systeemtijd eerst handmatig instellen:

Plain
sudo timedatectl set-time "2026-09-10 14:00:00"

Schrijf deze vervolgens naar de RTC:

Plain
sudo hwclock --systohc --utc

Controle van de behoudfunctie bij stroomuitval

  1. Controleer of de CR2032-batterij correct is geïnstalleerd.

  2. Schrijf de huidige systeemtijd naar de RTC:

Plain
sudo hwclock --systohc --utc
sudo hwclock --show
  1. Sluit het apparaat normaal af:
Plain
sudo poweroff
  1. Koppel alle externe stroombronnen los, zoals DC, PoE en USB-C.

  2. Wacht even en sluit de stroomtoevoer opnieuw aan.

  3. Controleer de RTC-tijd opnieuw:

Plain
sudo hwclock --show

Als de tijd continu en normaal verloopt, werkt de back-upstroomvoorziening van de RTC correct.

De RTC slaagt alleen tijdinformatie op en kan het systeem niet van stroom voorzien nadat de hoofdvoeding is onderbroken. Als er geen batterij is geïnstalleerd of als de batterij bijna leeg is, kan de RTC-tijd verloren gaan nadat het apparaat volledig is uitgeschakeld.

De PCF8563- en CR2032-batterijinterfaces zijn te vinden in het RK3576 IO Board-schema; de PCF8563 is standaard ingeschakeld in de Armbian device tree, dus meestal is geen extra overlay-configuratie nodig.

Audio

Het reComputer RK3576 IO Board bevat een ES8311 audio codec en biedt een 3.5 mm audio-interface die ondersteuning biedt voor:

  • Stereo-audio-uitvoer

  • Analoge microfooningang

  • Detectie van koptelefoonplug

  • Digitale audio-uitvoer via HDMI en USB-C DisplayPort

Bij gebruik van een standaard 3-segment koptelefoon wordt alleen audio-uitvoer ondersteund; voor opname moet je een 4-segment headset met microfoon gebruiken.

56.png

Audio-apparaten controleren

Installeer de ALSA-audiogereedschappen:

Plain
sudo apt update
sudo apt install -y alsa-utils

Lijst alle geluidskaarten op:

Plain
cat /proc/asound/cards

Controleer de afspeel- en opnameapparaten afzonderlijk:

Plain
aplay -l
arecord -l

Onder normale omstandigheden zie je apparaten zoals:

Plain
rockchip-es8311
rockchip-hdmi0
rockchip-dp0

Opmerking:

Het nummer van de ALSA-geluidskaart kan veranderen afhankelijk van aangesloten USB-, HDMI- of andere audio-apparaten. Controleer het daadwerkelijke nummer via aplay -l en arecord -l.

Audio-afspelen testen

In het volgende voorbeeld wordt aangenomen dat ES8311 zich bevindt op card 0, device 0. Als het apparaatnummer anders is, vervang dan 0,0 door de juiste kaart- en apparaatnummers.

Speel het linkerkanaal en rechterkanaal af met behulp van een testsignaal:

Plain
speaker-test -D plughw:0,0 -c 2 -t wav

Druk op Ctrl+C om de test te stoppen.

Speel een WAV-bestand af:

Plain
aplay -D plughw:0,0 test.wav

Om een MP3-bestand af te spelen:

Plain
sudo apt install -y mpg123
mpg123 -a hw:0,0 test.mp3

Microfoonopname testen

Sluit een 3.5 mm headset met microfoon aan en neem vervolgens een audioclip van 5 seconden op:

Plain
arecord -D plughw:0,0 \
    -d 5 \
    -f S16_LE \
    -r 48000 \
    -c 2 \
    recording.wav

Speel de opname af:

Plain
aplay -D plughw:0,0 recording.wav

Je kunt ook een real-time opname- en afspeeltest uitvoeren:

Plain
arecord -D plughw:0,0 -f cd |
    aplay -D plughw:0,0 -f cd

Het wordt aanbevolen tijdens de test koptelefoons te gebruiken om feedback tussen de luidspreker en de microfoon te voorkomen.

Volume aanpassen

Start ALSA Mixer:

Plain
alsamixer

In de interface:

  1. Druk op F6 om rockchip-es8311 te selecteren.

  2. Gebruik de linker- en pijltjestoetsen om het audio-bedieningselement te selecteren.

  3. Gebruik de boven- en onderpijltjestoetsen om het volume aan te passen.

  4. Druk op M om de mute-status in of uit te schakelen.

  5. Druk op Esc om af te sluiten.

Zorg ervoor dat de volgende uitgangskanalen niet zijn gemute:

Plain
Headphone
DAC
ADC
MIC PGA

Sla de huidige instellingen op:

Plain
sudo alsactl store

Herstel de opgeslagen instellingen:

Plain
sudo alsactl restore

Selecteer het standaard audioapparaat van het systeem

In de Armbian-desktopomgeving kun je via het volumepictogram een audioapparaat selecteren, zoals 3.5 mm, HDMI of DisplayPort.

Bekijk de PipeWire/PulseAudio-audioapparaten in de terminal:

Plain
pactl list short sinks
pactl list short sources

Stel het standaarduitvoerapparaat in:

Plain
pactl set-default-sink <sink_name>

Stel het standaardinvoerapparaat in:

Plain
pactl set-default-source <source_name>

Vervang <sink_name> en <source_name> door de daadwerkelijke namen die door het vorige commando zijn weergegeven.

Veelvoorkomende problemen

Geen geluid uit de 3.5 mm-koptelefoonaansluiting

Controleer eerst of het systeem ES8311 heeft geselecteerd, en niet HDMI of DisplayPort:

Plain
aplay -l
pactl list short sinks

Controleer vervolgens de mute-status in de mixer:

Plain
alsamixer

Als er bij het opstarten met een oudere testimage geen geluid is, raadpleeg dan het ES8311-afspeelconfiguratiescript in het project.

Geen invoer van microfoonopname

Controleer of je een 4-segment headset met microfoon gebruikt, en controleer het opnameapparaat:

Plain
arecord -l

Ga naar de mixer en controleer ADC, MIC PGA en de invoerkanalen:

Plain
alsamixer

Als een oudere testimage lege data opneemt, raadpleeg dan het ES8311-opnameconfiguratiescript.

Plopperige geluiden of ruis

  • Controleer of de koptelefoonplug volledig is ingebracht.

  • Vermijd adapterkabels met slecht contact.

  • Verlaag de koptelefoonuitvoer en de microfoongain.

  • Houd tijdens het opnemen de microfoon niet te dicht bij de koptelefoon.

  • Gebruik het plughw-apparaat zodat ALSA automatisch sample rate- en formaatconversie uitvoert.