Skip to content

Quick Start 02 First Boot Validation

Alex J Lennon edited this page Oct 10, 2025 · 2 revisions

First Boot Validation & Essential Tests

⏱️ Time Required: 10-15 minutes
Prerequisites: Board booted to login prompt from Quick-Start-01-Board-Setup-Checklist

🔐 Initial Login

Default Credentials

# Login via serial console
Username: fio
Password: fio

# OR for development builds
Username: root
Password: (no password - just press Enter)

First Commands

# Check system info
uname -a
cat /etc/os-release

# Expected output includes:
# Linux jaguar-[board] 6.6.x #1 SMP PREEMPT
# ID=lmp (Linux microPlatform)

🔍 Hardware Validation Tests

1. CPU & Memory Check (30 seconds)

# CPU info
nproc                    # Should show 4 cores (i.MX8MM) or 2 cores (i.MX93)
cat /proc/cpuinfo | grep "model name"

# Memory check  
free -h                  # Should show ~1-2GB available
df -h                    # Check storage space

2. Network Interface Check (1 minute)

# List network interfaces
ip link show

# Expected interfaces:
# - eth0 (if Ethernet available)
# - wlan0 (WiFi)
# - lo (loopback)

# Check WiFi capability
iw dev wlan0 scan | head -10    # Should show nearby networks

3. GPIO & Hardware Check (2 minutes)

# Check GPIO exports (board-specific)
ls /sys/class/gpio/

# I2C bus scan (shows connected sensors)
i2cdetect -y 1          # Scan I2C bus 1
i2cdetect -y 2          # Scan I2C bus 2

# Expected devices (board-dependent):
# 0x44 - SHT40 temperature/humidity sensor
# 0x4C - TAS2563 audio codec  
# 0x28 - LP5024 LED driver

4. Storage & Filesystem Check (1 minute)

# Check mounted filesystems
mount | grep -E "(root|boot|data)"

# Verify read/write capability
echo "test" > /tmp/test.txt && cat /tmp/test.txt && rm /tmp/test.txt
# Should echo "test" back

🌐 Network Connectivity Test

WiFi Connection (5 minutes)

# Scan for networks
nmcli dev wifi list

# Connect to WiFi (replace with your network)
nmcli dev wifi connect "YourNetworkName" password "YourPassword"

# Verify connection
ping -c 3 8.8.8.8       # Test internet connectivity
ip addr show wlan0      # Should show assigned IP address

SSH Access Setup (3 minutes)

# Get board IP address
hostname -I

# From your development computer:
ssh fio@[BOARD_IP_ADDRESS]
# Accept fingerprint, use password 'fio'

# Optional: Copy SSH key for passwordless access
ssh-copy-id fio@[BOARD_IP_ADDRESS]

⚡ Performance Baseline

Boot Time Measurement

# Check boot time
systemd-analyze
systemd-analyze blame | head -10

# Target boot times:
# i.MX8MM: < 20 seconds to login
# i.MX93: < 15 seconds to login (optimized)

System Load Check

# Current system status
htop                     # Interactive process monitor (q to quit)
# OR
top -n 1                # One-shot process list

# System should be mostly idle after boot
# Load average should be < 1.0

✅ Validation Checklist

Mark complete when verified:

  • Login successful - Can access system via serial/SSH
  • Hardware detected - I2C devices, GPIO, network interfaces present
  • Network functional - WiFi connects, internet accessible
  • Storage working - Can read/write files
  • Performance acceptable - Boot time < 20s, system responsive
  • SSH access - Can connect remotely for development

🚨 Troubleshooting Quick Fixes

Issue Symptoms Solution
Can't login Wrong password Try root with no password
No WiFi networks nmcli shows empty Check antenna connections
Slow boot >30 second boot Check SD card speed, power supply
I2C devices missing Empty i2cdetect Hardware issue, check connections
No SSH Connection refused Check firewall: systemctl status sshd

🔄 Next Steps

All tests passed? → Continue to Quick-Start-03-Development-Environment-Setup

Need to customize? → See Development-Workflows-Building-and-Flashing

Hardware issues? → Check Hardware-Reference-Edge-EInk-Board for your specific board


💡 Pro Tip: Document your board's IP address and any unique hardware characteristics for future reference!

Clone this wiki locally