Pular para o conteúdo principal

Guia de Depuração Multiplataforma Seeed Jetson

🔧Guia de Depuração Multiplataforma Jetson

Projetado para todas as placas carrier Jetson da Seeed Studio, cobrindo as plataformas Windows / Linux / macOS,
Da depuração serial ao monitoramento do sistema, solução completa para falhas de boot, travamentos de kernel e problemas de gravação.

🎯 Visão Geral do Documento​

Este guia é especificamente projetado para todas as placas carrier Seeed Jetson, integrando as especificações oficiais de depuração da NVIDIA com os recursos de hardware da Seeed para fornecer uma solução unificada de depuração multiplataforma.

Cobertura: Depuração Serial · Análise de Logs de Boot · Monitoramento de Sistema · Rastreamento em Nível de Hardware · Gravação & Recuperação

Hardware Suportado

reComputer Super / Classic / Mini / Robotics · reComputer Industrial · reServer Industrial · Série J501

📚 Recursos Centrais Oficiais de Referência​

NºNome do RecursoLinkValor Central
1Jetson Linux Developer GuideNVIDIA OfficialArquitetura do sistema, processo de boot, configuração de UART
2Especificações de Hardware / Esquemáticos do JetsonNVIDIA Download CenterDefinições de pinos da interface de depuração, padrões de tensão
3Seeed Studio WikiSeeed OfficialLocalização das portas de depuração das placas carrier Seeed, descrições de interfaces
4NVIDIA SDK ManagerNVIDIA OfficialGravação gráfica, implantação de ambiente
5Documentação de Depuração de Hardware CoreSightJetson Linux Debug ChapterRastreamento de hardware Arm, análise de travamentos

🛠️ Pré-requisitos de Depuração​

Preparação de Hardware​

  • Placa de desenvolvimento Seeed Jetson (alimentada normalmente)
  • Cabo de dados USB (escolha USB-C ou Micro-B com base no modelo da placa carrier) / módulo USB para UART 3,3 V
  • Computador host (qualquer um: Windows / Linux / macOS)

Ferramentas de Software (Multiplataforma)​

SistemaFerramentas Recomendadas
WindowsPuTTY / MobaXterm / Device Manager
Linuxscreen / minicom / picocom
macOSscreen / minicom

🔌 Depuração Serial UART (Núcleo)​

A porta serial UART é o ponto de entrada de baixo nível para depuração do Jetson, permitindo visualizar logs completos de boot do Bootloader e do kernel, resolvendo problemas centrais como tela preta, falha ao inicializar e ocupação da porta serial.

Aviso de Tensão

Todas as portas de depuração Seeed Jetson são de nível 3,3 V, é estritamente proibido usar módulos de 5 V, caso contrário o dispositivo será permanentemente danificado!

Métodos de Conexão da Porta de Depuração por Série​

Selecione a sua série de dispositivo para ver a localização correspondente da porta de depuração e o método de conexão:

Modelos Suportados: reComputer Super J4012 / J4011 / J3011 / J3010

Tipo de Porta de Depuração: Porta de Depuração USB-C onboard

Método de Conexão:

  1. Use um cabo de dados USB Type-C para conectar diretamente a porta de depuração da placa carrier à porta USB do host
  2. Não é necessário módulo UART adicional, plug and play
reComputer Super
Localização da Porta de Depuração

A porta de depuração da série Super está localizada na lateral do chassi, no conector USB-C, rotulada como DEBUG ou UART. Após a conexão, o host irá reconhecê-la como um dispositivo serial.

Identificação de Porta Multiplataforma​

Após conectar o cabo de depuração, identifique o dispositivo serial no host:

Abra o Device Manager → Expanda Ports (COM & LPT) → Procure o USB Serial Port com o número de COM correspondente (por exemplo, COM3).

Correção de Ocupação de Porta Serial pelo ModemManager (Linux)​

Problema Específico do Linux

O serviço ModemManager em hosts Linux irá ocupar erroneamente a porta serial de depuração do Jetson, causando falhas de conexão.

# Troubleshoot port occupation
sudo lsof /dev/ttyACM0

# Temporarily stop service (recommended)
sudo systemctl stop ModemManager

# Permanently disable (when 4G/5G module is not needed)
sudo systemctl disable ModemManager

Configurar regras udev (para acesso à porta serial sem sudo):

sudo vim /etc/udev/rules.d/99-tegra-serial.rules

Adicione o seguinte conteúdo:

SUBSYSTEM=="tty", ATTRS{idVendor}=="0955", MODE="0660", GROUP="plugdev", TAG+="uaccess"
sudo udevadm control --reload-rules && sudo udevadm trigger

Conexão serial (Taxa de baud: 115200)​

Usando PuTTY:

  1. Selecione o tipo de conexão Serial
  2. Insira o número da porta COM (por exemplo, COM3)
  3. Defina a taxa de baud para 115200
  4. Clique em Open

Ou usando MobaXterm: New Serial Session → Selecione a porta COM → Taxa de baud 115200

🚀 Inicialização do sistema e depuração do kernel​

Por meio da porta serial UART, você pode capturar completamente os logs de boot do Jetson para localizar travamentos na inicialização, falhas de kernel e outros problemas.

Três estágios de boot​

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│  Bootloader     │ →  │  Kernel Boot     │ →  │  System Init     │
│  CBoot/U-Boot   │    │  Linux Load Drivers│   │  systemd Service│
│  Serial Only    │    │  Core Debug Info  │    │  User Mode      │
└─────────────────┘    └──────────────────┘    └─────────────────┘

Habilitar logs completos de boot​

Por padrão, o parâmetro quiet oculta uma grande quantidade de logs. Você pode habilitá-los por meio dos seguintes passos:

  1. Edite o arquivo de configuração de boot:
sudo vim /boot/extlinux/extlinux.conf
  1. Encontre a linha APPEND, remova quiet, adicione ignore_loglevel
  2. Após reiniciar, você poderá visualizar os logs completos do kernel pela porta serial
Cenário remoto

Se você puder se conectar via SSH, também poderá visualizar os logs do kernel diretamente:

dmesg --follow
journalctl -k -f

📊 Monitoramento do sistema e depuração avançada de hardware​

tegrastats — Monitoramento em tempo real do sistema​

tegrastats é a ferramenta oficial de monitoramento do sistema Jetson fornecida pela NVIDIA, para visualizar uso de CPU/GPU, temperatura, frequência, etc.:

# Real-time monitoring
tegrastats

# Customized output (1 second refresh, total 10 times)
tegrastats --interval 1000 --stop 10

jtop — Monitoramento visual aprimorado​

jtop fornece uma interface TUI interativa. Método de instalação:

sudo pip3 install -U jetson-stats
sudo systemctl restart jtop.service
jtop

Depuração em nível de hardware CoreSight (Avançado)​

Usado para analisar falhas difíceis de reproduzir, gargalos de desempenho, com base em OpenCSD + ferramentas perf:

# Record instruction execution flow
perf record -e cs_etm/@<trace-id>/u ls

# Analyze logs
perf report --stdio --dump
info

CoreSight suporta STM (System Trace Macrocell), que pode substituir de forma eficiente a depuração de software com printk. Para configuração detalhada, consulte a Documentação oficial de depuração da NVIDIA.

🔄 Gravação & Recuperação​

Quando o sistema trava ou não consegue inicializar, você pode regravar usando as ferramentas oficiais.

Guia rápido de gravação

Para etapas detalhadas de gravação, consulte a página Flashing Jetson Linux, que fornece guias completos de gravação específicos para cada dispositivo, incluindo:

  • Download e verificação do BSP
  • Preparação do ambiente
  • Etapas de gravação específicas do dispositivo
  • Solução de problemas comuns

Verificação do modo de recuperação​

Antes de gravar, certifique-se de que o dispositivo entrou no modo de recuperação. Execute no host Ubuntu:

lsusb

Se a saída contiver qualquer um dos seguintes IDs, o dispositivo entrou no modo de recuperação:

MóduloID USB
Orin NX 16GB0955:7323
Orin NX 8GB0955:7423
Orin Nano 8GB0955:7523
Orin Nano 4GB0955:7623
AGX Orin 32GB0955:7223
AGX Orin 64GB0955:7023
Xavier NX0955:7e19
Entrando no modo de recuperação

Dispositivos diferentes têm métodos diferentes para entrar no modo de recuperação. Consulte as etapas detalhadas para o dispositivo correspondente na página Flashing Jetson Linux.

Logs de depuração da gravação​

Quando a gravação falhar, certifique-se de coletar dois tipos de logs para solução de problemas:

  1. Lado do host: Log completo de saída do terminal de gravação
  2. Lado de destino: Log de boot do Jetson capturado pela porta serial UART (base principal para solução de problemas)
Dicas de depuração
  • Quando a gravação falhar, priorize verificar o log da porta serial UART, que geralmente revela a causa raiz
  • Problemas comuns incluem: incompatibilidade de versão do BSP, problemas de conexão USB, configuração do ambiente do host, etc.
  • Se você precisar de ajuda, colete logs completos e entre em contato com o suporte técnico

❓ Solução de problemas comuns​

ProblemaDireção de solução de problemas
Falha na conexão serialVerifique o serviço ModemManager, cabo USB, número da porta, padrão de tensão (3,3V)
Sem logs de bootConfirme se a porta de depuração está conectada corretamente; remova o parâmetro de boot quiet do kernel
Falha na gravaçãoPriorize verificar os logs da porta serial UART; verifique se o modelo da placa carrier corresponde à versão do JetPack
Permissões insuficientes da porta serialConfigure regras udev; sudo usermod -aG plugdev $USER
Dispositivo não consegue entrar no modo de recuperaçãoVerifique se os jumpers/botões estão corretos; tente trocar o cabo ou a porta USB

📎 Apêndice: Recursos oficiais​

📖 Guia do desenvolvedor

Guia oficial de desenvolvedor do NVIDIA Jetson Linux, arquitetura de sistema, processo de boot, configuração de depuração.

Guia Jetson Linux

🌱 Seeed Wiki

Wiki oficial da Seeed Studio, contendo descrições de interfaces de hardware e tutoriais de uso para toda a série de placas carrier.

Seeed Studio Wiki

🔧 SDK Manager

Ferramenta gráfica oficial da NVIDIA para gravação e implantação de ambiente SDK.

NVIDIA SDK Manager

🤝 Suporte técnico e discussão de produtos​

Obrigado por escolher nossos produtos! Forneceremos a você diversos tipos de suporte para garantir uma experiência tranquila durante o uso.

Loading Comments...