Skip to content
Escama-CodePublic

About

Lib em português pra controlar o LEGO EV3 via Bluetooth/USB — protocolo Direct Commands do zero, sem dependências

Topics

Resources

Contributing

Security policy

Stars

4 stars

Watchers

2 watching

Forks

Repository files navigation

Logo jacarEV3

jacarEV3 🐊

Biblioteca Python em português para controlar o LEGO EV3 via Bluetooth.
Sem dependências externas — só a biblioteca padrão do Python.

PyPI MIT Python 3.8+ LEGO EV3


Por que jacarEV3?

  • Sintaxe em português — robo.led('VERDE'), robo.mover_continuo('B', 40)
  • Zero dependências — instala e funciona com o Python da escola
  • Pensada para aula — testes de motor/sensor, seguir linha, desvio, teleop
  • Sem robô físico — dá para usar ConexaoFalsa em laboratório
  • Acessibilidade — anúncios e feedback para leitores de tela

Ideal para ensino de programação, robótica e pensamento computacional no ensino fundamental e médio.


Instalação

pip install jacarev3

Uso rápido

from jacarev3 import RoboEV3

with RoboEV3('00:16:53:64:F8:B8') as robo:  # MAC do seu EV3
    robo.apitar()
    robo.led('VERDE')
    robo.testar_tudo()  # motores A–D e sensores 1–4

Troque o endereço pelo MAC Bluetooth do seu brick.


O que a lib oferece

Área Exemplos
Conexão RoboEV3, definir_base, fechar
Motores girar_motor, mover_continuo, parar_motor, graus/voltas, encoder
Base motriz mover_base, mover_base_graus, parar_base
Sensores ler_sensor, modos em jacarev3.protocolo
Som e LED apitar, led
Diagnóstico testar_motor(es), testar_sensores, testar_tudo
Tópicos prontos seguir linha, desviar obstáculo, controle remoto
Sem hardware jacarev3.falso.ConexaoFalsa
Inclusão executar_com_acessibilidade, AcessibilidadeRobo

Documentação e IDE

Recurso Link
Documentação / site i-barbosa.github.io/jacarEV3
IDE no navegador (sandbox, campanha, simulação) escama-code.github.io/jacarEV3-IDE
PyPI pypi.org/project/jacarev3

Estrutura do pacote

jacarev3/           → RoboEV3 (API principal)
jacarev3.topicos/   → seguir linha, desvio, controle remoto
jacarev3.falso/     → ConexaoFalsa (aula sem robô)
jacarev3.fontes/    → teclado, gamepad, UDP
jacarev3.protocolo/ → constantes de baixo nível
jacarev3.erros/     → exceções da biblioteca

Contribuindo

Issues e pull requests são bem-vindos:

github.com/escama-code/jacarEV3

Veja também CONTRIBUTING.md e o CHANGELOG.md.


Colaboradores

Contributors do jacarEV3

Ver commits e contribuições no GitHub · CHANGELOG

Quem fez o quê (resumo)

Pessoa Papel / contribuições principais
Ítalo Vinicius Mantenedor — protocolo, RoboEV3, erros, documentação
Miguel Arcanjo Encoder, motor por graus, base motriz, controle remoto
Adrews Parâmetro portas= (apelidos e filtros em testar_*)

A imagem de avatares acima atualiza sozinha conforme novos contributors entram no repositório. Os papéis da tabela são um resumo editorial (não substituem o histórico do Git).


Organização

Projeto ligado ao ecossistema Escama Code e ao Programa Embarque Digital.


Licença

MIT — uso livre em escolas, projetos e pesquisa.

About

Lib em português pra controlar o LEGO EV3 via Bluetooth/USB — protocolo Direct Commands do zero, sem dependências

Topics

Resources

Contributing

Security policy

Stars

4 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages