An autonomous navigation program for a micro:Maqueen V5 robot equipped with a BBC micro:bit V2, using a single ultrasonic sensor to detect obstacles and navigate mazes while prioritizing open paths and tracking directions to avoid loops. Winner of the 2025 ICEI RoboChallenge.
  • TypeScript 98.1%
  • Makefile 1.6%
  • Ruby 0.3%
Find a file
2025-10-27 16:44:06 -03:00
.vscode File iniziali per il progetto MakeCode 2023-12-10 18:21:14 +01:00
src chore(main): reorder tasks on pausing/resuming a run to make it more intuitive 2025-10-27 16:35:14 -03:00
.gitignore Add .gitignore 2025-10-25 12:01:14 -03:00
_config.yml File iniziali per il progetto MakeCode 2023-12-10 18:21:14 +01:00
Gemfile File iniziali per il progetto MakeCode 2023-12-10 18:21:14 +01:00
LICENSE chore: add LICENSE and update old README 2025-10-25 12:14:16 -03:00
main.blocks Write comments and format code 2025-10-25 11:52:49 -03:00
Makefile chore(Makefile): use udisks2 to mount micro:bit to get around pxt being 🥴 2025-10-27 16:44:06 -03:00
pxt.json chore: move source files to a new src/ directory 2025-10-25 15:14:26 -03:00
README.md chore: add LICENSE and update old README 2025-10-25 12:14:16 -03:00
test.ts File iniziali per il progetto MakeCode 2023-12-10 18:21:14 +01:00
tsconfig.json chore(main.ts): reposition base case pause() call in main loop 2025-10-25 14:17:51 -03:00

Code2Find — Programa Simples de Navegação de Labirintos

Este projeto implementa um programa de navegação autônoma para um robô micro:Maqueen V5 equipado com um BBC micro:bit V2 (Nordic nRF52). O algoritmo utiliza um único sensor ultrassônico para detectar obstáculos e navegar por labirintos, priorizando caminhos abertos enquanto mantém um registro das direções tomadas para evitar loops.

Instalação

Para trabalhar com este projeto, você precisará do PXT (MakeCode) instalado globalmente. Siga os passos abaixo:

  1. Instale o PXT globalmente usando pnpm:

    pnpm install -g pxt
    
  2. No diretório do projeto, defina o alvo para a BBC micro:bit:

    pxt target microbit
    
  3. Instale as dependências do projeto:

    pxt install
    

Uso

O projeto inclui um Makefile para facilitar as operações comuns de compilação e implantação. Os comandos disponíveis são:

  • make build: Compila o projeto e gera os arquivos necessários.
  • make deploy: Compila o projeto e implanta o código no micro:bit conectado.
  • make test: Executa os testes definidos no projeto.
  • make all ou simplesmente make: Equivalente a make deploy, compilando e implantando o código.

Como usar no MakeCode

Para modificar o projeto no MakeCode:

Licença

Este projeto está licenciado sob a licensa ISC.