Instalar as ferramentas

Resultado : A fonte e as dependências são instaladas, a porta é selecionada e os motores esperados respondem. Conclua , as verificações de hardware primeiro.

1. Obtenha a fonte

Abra um terminal no diretório onde deseja manter o projeto:

git clone https://github.com/roboninecom/STS32XX-Firmware.git
cd STS32XX-Firmware
git checkout a995f77cf83175060bfa8fb908347448a5ae45eb

git clone https://github.com/roboninecom/STS32XX-Firmware.git
Set-Location STS32XX-Firmware
git checkout a995f77cf83175060bfa8fb908347448a5ae45eb

A cópia do repositório fica fixada na revisão usada para verificar esta documentação. O estado «detached HEAD» nesse commit é intencional. Se uma cópia existente contiver alterações locais, preserve-a e use uma cópia separada em vez de trocar sua revisão.

2. Instale dependências

Agora você está na raiz STS32XX-Firmware. Verifique as versões do interpretador e instale as ferramentas:

node --version
python3 --version
npm ci
python3 -m venv tools/flash/.venv
tools/flash/.venv/bin/python -m pip install -r tools/flash/requirements.txt

node --version
py -3 --version
npm.cmd ci
py -3 -m venv tools/flash/.venv
.\tools\flash\.venv\Scripts\python.exe -m pip install -r tools/flash/requirements.txt

Use Node.js 20 + e Python 3.10 +. As dependências do Python usam um ambiente separado. A ativação é desnecessária porque comandos posteriores chamam seu interpretador diretamente. As instruções do Windows usam npm.cmd e não exigem alteração da política de execução do PowerShell.

Verificação : A instalação do é concluída sem erros. Se node , python ou py não estiver disponível, instale o interpretador necessário ou corrija o PATH. Não atualize com uma instalação incompleta.

3. Selecione a porta

Conecte o adaptador e identifique sua porta usando seu sistema operacional. Os nomes comuns são /dev/cu.usbmodem… no macOS, /dev/ttyUSB0 no Linux e COM3 no Windows. Substitua o exemplo:

export SERVO_PORT=/dev/ttyUSB0

$env:SERVO_PORT = 'COM3'

A variável pertence a este terminal; configure-o novamente em uma nova janela. No macOS, substitua o exemplo do Linux pelo caminho /dev/cu.… real.

4. Descubra motores

Aplique a potência correta do motor e feche outros programas usando a porta. Este comando lê dispositivos; não permite torque ou inicia movimento:

npm run settings -- discover --port "$SERVO_PORT"

npm.cmd run settings -- discover --port "$env:SERVO_PORT"

A taxa de transmissão padrão é 1,000,000. Para uma taxa diferente, adicione --baud ao valor real e use-o nos comandos subsequentes que aceitam essa opção.

Verificação de : Os IDs descobertos de correspondem aos motores conectados e quaisquer alarmes relatados são compreendidos. Uma lista vazia significa que não há respostas na taxa de transmissão selecionada e não há prova de firmware quebrado. A descoberta não consegue distinguir com segurança IDs duplicados. Consulte diagnóstico de conexão se necessário.

Próximo: faça backup e atualize . Instale o visualizador de telemetria opcional quando precisar dele.

Início da documentação · Revisão de origem: a995f77 . Extension 9.0 .