Quick Start

Quick Start

Prerequisites

1. Flash Raspberry Pi 5 with the official Debian 12 image and complete basic system setup.
2. Install basic tools and enable SSH service:

sudo apt update && sudo apt install net-tools -y
sudo systemctl start ssh
sudo systemctl enable ssh

3. Use SSH from your PC to remotely connect to Raspberry Pi 5 (default username/password: aidlux/aidlux).

System Network Configuration

This solution uses a "Raspberry Pi Wi-Fi Internet + private PCIe communication" architecture. You need to build a closed private network between Raspberry Pi and the compute card and configure Internet sharing. Network configuration is identical for FPC cable and Ethernet cable connections.

Step 1: Configure static IP and closed private network

# Raspberry Pi side (run the following commands as root)
sudo su
ifconfig eth0 192.168.100.1 netmask 255.255.255.0 up
ifconfig eth1 192.168.100.2 netmask 255.255.255.0 up
# Enable IP forwarding
echo 1 > /proc/sys/net/ipv4/ip_forward
# Verify forwarding is enabled (output 1 means success)
cat /proc/sys/net/ipv4/ip_forward

# A8625 compute card side (enter via adb shell)
adb shell
ifconfig eth0 192.168.100.3 netmask 255.255.255.0 up

Step 2: Configure routing and NAT for Internet sharing

# Raspberry Pi side (root privileges)
# Configure NAT rules
iptables -t nat -A POSTROUTING -o wlan0 -j MASQUERADE
iptables -A FORWARD -i eth1 -o wlan0 -j ACCEPT
iptables -A FORWARD -i wlan0 -o eth1 -m state --state ESTABLISHED,RELATED -j ACCEPT
# Permanently enable IP forwarding
sysctl -w net.ipv4.ip_forward=1

# A8625 compute card side (adb shell)
# Add default gateway
ip route add default via 192.168.100.2 dev eth0
# Verify Internet access (successful ping indicates success)
ping baidu.com

Driver Installation

1. Download the A8625 driver package for your OS version from the "Resource Download Center".

# Ubuntu
sudo dpkg -i a8625-driver-ubuntu_*.deb
sudo modprobe a8625_pcie

Note: Enter the directory containing the driver package before running the commands above.

Environment Variable Setup

# Configure A8625 SDK environment variables
echo 'export PATH=$PATH:/opt/aidlux/a8625/bin' >> ~/.bashrc
echo 'export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/opt/aidlux/a8625/lib' >> ~/.bashrc
source ~/.bashrc

Compute Card Recognition Verification

1. PCIe Device Check:

lspci | grep Qualcomm
# Expected output should contain "Qualcomm QCS8625 PCIe Controller"

2. Network Connectivity Check:

ping 192.168.100.3
# Receiving replies indicates normal communication between Raspberry Pi and the compute card

3. ADB Device Check:

adb devices
# Expected output should display the A8625 device serial number