Skip to main content

Guia de execução atualizado

Com a recente Migração para WebSockets com ROSBridge, a arquitetura foi modificada, portanto, o guia de execução foi atualizado

Conexão com o robô​

1. Conexão com o Robô via SSH​

Para iniciar a conexão com o robô, é necessário utilizar o protocolo SSH. Há um tutorial de como deve ser feito o setup do robô Execute os seguintes passos no seu terminal:

  1. Inicie o Robô: Certifique-se de que o robô esteja ligado e pronto para conexão.
  2. Conectar via SSH:
    • Abra um terminal no seu computador.
    • Digite o comando SSH para estabelecer uma conexão segura. Confirme o comando exato e o IP na documentação de metodologia. Um exemplo de comando é: 
      ssh rebolins@rebolins.local

2. Clonar o projeto no robô​

git clone https://github.com/Inteli-College/2024-1B-T08-EC06-G03.git

Além disso, é importante ter instalado o ROS2.

3. Inicialização do Robô​

Após estabelecer a conexão SSH, o próximo passo é inicializar os componentes necessários do robô. Execute isso no mesmo terminal do

  1. Entrar na pasta de código:

    • É necessário entrar na pasta que os pacotes estão alocados.
    cd src/bolin

  2. Executar o Build.sh:

    • É necessário rodar o arquivo de build para construir os pacotes ros.
    source build.sh

  3. Executar o Comando de BringUp:

    • No terminal SSH, execute o comando que inicializa os processos necessários no robô. Este comando pode ser encontrado na documentação técnica ou em tutoriais relevantes. Um exemplo comum para robôs baseados em ROS pode ser algo como: 
      ros2 launch bolin_bringup launch.py
    • Este comando inicializa um listener no robô e ativa vários serviços e processos internos.

  4. Iniciar o ROSBridge

    • Execute o comando que inicia o ROSBridge 
      ros2 launch rosbridge_server rosbridge_websocket_launch.xml
    • Este comando inicia o ROSBridge, que é responsável por intermediar a comunicação entre o ROS e a aplicação web.
    • Não precisa necessariamente ser executado no robô, também pode ser executado no computador.

4. Execução do Software de Controle​

Com o robô devidamente inicializado, a próxima etapa é executar o software de controle que interage com o robô.

  1. Clonar o projeto no computador

    • É necessário clonar o projeto no computador que vá rodar a aplicação.
    git clone https://github.com/Inteli-College/2024-1B-T08-EC06-G03.git

  2. Inicialização do Back-End:

    • Instale o Node.js
    • No seu computador (não no terminal SSH), abra um novo terminal.
    • Acesse a pasta do Back-End
    cd src/backend/
    • Instale as dependências
    npm install
    Alerta

    Para continuar, visualize as intruções existentes para a configuração do database, pois é a criação de um banco de dados. Como a solução utiliza Turso, existe um passo a passo para ser seguido sobre a implementação do mesmo. Segue tutorial para mais informações.

    • Execute o Back-End
    npm start

  3. Inicialização do Front-End:

    • Instale o Node.js
    • No seu computador (não no terminal SSH), abra um novo terminal.
    • Acesse a pasta do Front-End
    cd src/frontend/
    • Instale as dependências
    npm install
    • Instalação da biblioteca do shadcn.
    npx shadcn-ui@latest init
    • Execute o Front-End
    npm run dev

5. Controle do Robô​

  • Utilize o joystick para controlar o robô.

Nota: É importante confirmar todos os comandos e caminhos exatos com a documentação técnica disponível para garantir que as instruções estejam corretas e atualizadas.