Skip to content

Quick Start 01 Board Setup Checklist

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

5-Minute Board Setup Checklist

⏱️ Time Required: 5-10 minutes
Prerequisites: Board, USB-C cable, computer with terminal access

🎯 Quick Validation Steps

1. Physical Inspection (30 seconds)

  • Power LED - Check for damage, bent pins, loose connectors
  • USB-C Port - Ensure clean connection, no debris
  • Antenna Connections - WiFi/BT antennas properly seated (if external)

2. Initial Power-On (2 minutes)

# Connect USB-C cable to board and computer
# Board should auto-power on or press power button if present

# Check for USB device enumeration
lsusb | grep -i "NXP\|Freescale"
# Expected: Bus 001 Device XXX: ID 1fc9:XXXX NXP Semiconductors

3. Serial Console Access (2 minutes)

# Find the serial device (usually ttyUSB0 or ttyUSB1)
ls /dev/ttyUSB*

# Connect to serial console (115200 baud default)
sudo screen /dev/ttyUSB0 115200
# OR
sudo minicom -D /dev/ttyUSB0 -b 115200

# Expected: U-Boot messages followed by Linux boot log

4. Boot Validation (1 minute)

Look for these key boot messages:

U-Boot 2023.04 (Build date)
CPU:   Freescale i.MX8MM/i.MX93 rev1.0
Model: i.MX8MM/i.MX93 Jaguar [board-name]

Linux boot success indicators:

[    X.XXX] systemd[1]: Reached target Multi-User System.
[    X.XXX] systemd[1]: Reached target Graphical Interface.

Welcome to LmP (Linux microPlatform)
jaguar-[board] login:

🚨 Common Issues & Quick Fixes

Issue Symptoms Quick Fix
No USB Device lsusb shows nothing Try different USB cable/port, check power
No Serial Output Blank terminal Check /dev/ttyUSB1 instead of ttyUSB0
Boot Loop Repeating U-Boot messages Board may need reflashing
Kernel Panic Boot stops with error Check power supply (needs 5V 2A minimum)

✅ Success Criteria

Your board is ready when:

  • Serial console shows login prompt
  • Boot time < 30 seconds (typical: 15-20s)
  • No critical error messages in boot log
  • System responds to basic commands

🔄 Next Steps

Board working? → Continue to Quick-Start-02-First-Boot-Validation

Issues? → Check Development-Workflows-Debugging-and-Troubleshooting


💡 Pro Tip: Save your working serial console session - you'll use it frequently during development!

Clone this wiki locally