Manual
Módulo ESP32 Express Dongle e Logger
Parabéns pela aquisição do dongle VESC Express e do módulo logger. Este dispositivo possui um módulo ESP32 com conectividade de velocidade Wi-Fi®, USB-C e um slot para cartão micro SD para permitir registro constante enquanto o controlador de velocidade VESC está ligado (é necessário cartão Micro SD). Um módulo GPS pode ser adicionado para registro de posição e hora/data. Este será um guia rápido sobre como instalar o VESC-Express, configurá-lo e view seu registro files.
Se você estiver familiarizado com o firmware beta, certifique-se de estar na versão mais recente e comece em 4. Se você tiver algum problema com seu dongle expresso VESC, entre em contato com Trampum suporte suporte@trampaboards.com
Diagrama de fiação
instalação do cartão SD
Download de firmware
O VESC Express é muito novo e precisa usar FIRMWARE BETA até o lançamento do VESC-Tool 6.
O lançamento do VESC-Tool 6 não está muito longe. Esperamos que isso aconteça em dezembro de 2022.
O VESC Express já terá o firmware correto instalado, mas só funcionará em conjunto com dispositivos VESC atualizados com firmware. Dispositivos com firmware mais antigo NÃO suportam VESC-Express!
Este é um rápido passo a passo de como baixar a versão beta do VESC-Tool.
Primeiramente você precisará ir até https://vesc-project.com/ e certifique-se de fazer login em sua conta. Se você não possui uma conta, registre-se e adquira qualquer versão do VESC-Tool.
Uma vez logado, as opções do menu aparecerão no canto superior direito. Clique em COMPRADO FILES para acessar o link de download do beta. NOTA se você não baixou a ferramenta VESC, o link beta não será mostrado. Baixe a versão lançada e verifique novamente em COMPRADO FILES.
O link Beta terá todas as versões do dispositivo em um .rar file. Certifique-se de ter o software instalado para ler e descompactar o fileS. Por exemplo, Winrar, Winzip, etc.
Escolha a versão desejada, clique em extrair e escolha uma pasta. Há sempre um file com a data de construção, use-a como referência, pois o beta geralmente é atualizado uma vez por semana. Certifique-se de manter-se atualizado até que haja uma atualização para a ferramenta VESC lançada para a versão 6.
Instalação de firmware
Agora vá para a ferramenta beta VESC e abra-a. Você receberá um pop-up ao abri-lo avisando que esta é uma versão de teste da ferramenta VESC. Clique em OK para continuar. Em seguida, clique em AUTO CONNECT, não se preocupe se o dispositivo VESC demorar para se conectar. Isso ocorre porque está em firmware antigo. Assim que a conexão for estabelecida, você verá um pop-up informando que o dispositivo está com firmware antigo.
Clique em OK para continuar. Agora navegue até a guia firmware à esquerda.
Clique na seta de upload para começar a piscar. Isso levará cerca de 30 segundos e o controlador VESC será reiniciado sozinho. NÃO DESLIGUE!
Quando o controlador VESC for reinicializado, você deverá receber a mensagem de aviso acima. Clique em OK, navegue até WLECOME AND WIZARDS e conecte-se automaticamente. NOTA Se você receber o mesmo pop-up de 'firmware antigo', o firmware não foi carregado corretamente. Nesse caso, volte para a guia firmware e clique na guia BOOTLOADER na parte superior. Clique na seta de upload para atualizar o bootloader, depois volte para a guia de firmware na parte superior e tente fazer o upload do firmware novamente. suporte@trampaboards.com
Configuração de registro
O VESC Express tem a capacidade de registrar continuamente enquanto o controlador VESC está ligado. Este é um grande passo para o registro, pois antes você só podia registrar dados do dispositivo VESC ao qual estava conectado. Agora, o VESC-Express poderá registrar todos os dispositivos VESC e BMS conectados ao CAN.
Comece instalando um cartão SD (guia de instalação na página 1). O tamanho do cartão SD dependerá do seu projeto e de quanto tempo você está registrando. Mais dispositivos CAN e registros mais longos resultarão em grandes fileS. Agora que a placa está instalada, ligue o controlador de velocidade VESC e conecte-o à ferramenta VESC. Se você conectou ao dongle VESC-Express, certifique-se de conectar ao controlador de velocidade VESC em dispositivos CAN (1). Assim que o controlador de velocidade VESC for selecionado, clique na guia Pacotes VESC (2).
Clique em LogUI (3) e as informações aparecerão no lado direito. Leia isto com atenção, pois explica o que o logUI faz e como usar sua UI. Por fim, clique em instalar para gravar o pacote logUI em seu controlador de velocidade VESC. Depois de instalado, você deverá ver um pop-up como abaixo. Clique em OK, desligue o controlador de velocidade VESC e ligue-o novamente.
Clique em LogUI (3) e as informações aparecerão no lado direito. Leia isto com atenção, pois explica o que o logUI faz e como usar sua UI. Por fim, clique em instalar para gravar o pacote logUI em seu controlador de velocidade VESC. Depois de instalado, você deverá ver um pop-up como abaixo. Clique em OK, desligue o controlador de velocidade VESC e ligue-o novamente.
Quando reconectado e o controlador de velocidade VESC estiver selecionado no CAN (1), você verá um pop-up solicitando que você carregue o logUI. Se você não vir um pop, a instalação falhou, certifique-se de que o controlador de velocidade VESC esteja selecionado no CAN e tente novamente a instalação.
Agora clique em sim e você verá a interface do usuário de log. A UI é fácil de usar, basta marcar a caixa dos valores que deseja registrar e clicar em INICIAR. Informações mais detalhadas podem ser encontradas em Pacote VESC > LogUI. Observe que o registro permanente na inicialização do sistema, incorporando dados de posição GNSS, começará assim que um número suficiente de satélites for encontrado.
Como encontrar seus registros
Quando você quer view um registo file você precisará conectar seu dispositivo VESC à versão desktop do VESC-Tool (Windows/Linux/macOS). Uma vez conectado, certifique-se de selecionar o dongle VESC Express nos dispositivos CAN (1), selecione Análise de log (2), certifique-se de que BROWSE e CONNECTED DEVICE estejam selecionados (3), agora pressione atualizar (4).
Agora você deve ver uma pasta chamada “log_can”. Aqui haverá uma pasta chamada “data” ou “no_date”.
Se você registrar dados de posição GNSS, ele coletará a hora e a data e os salvará na pasta “data”. No_date são dados sem informações GNSS (registro de dados GNSS desativado ou nenhum módulo GPS instalado)
Selecione um file e clique em abrir. Se você gravou dados GNSS, os pontos de plotagem serão exibidos no mapa onde os dados foram registrados. Quando o files foram carregados, clique na guia Dados para view.
Na aba de dados você precisará clicar em um valor para que ele seja exibido (1). Você pode selecionar vários valores. Clique no gráfico para mover um controle deslizante (2) e ler com precisão os dados em cada ponto do gráfico. Se o GNSS foi gravado, os pontos do gráfico se moverão com este controle deslizante para mostrar exatamente onde está o dado que você está viewocorreu (3).
Configuração Wi-Fi®
Para configurar o Wi-Fi®, primeiro conecte seu VESC-Express ao controlador de velocidade VESC e ligue-o. Em seguida, conecte-se à ferramenta VESC e clique em SCAN CAN (1). Quando o VESC-Express aparecer, clique nele para conectar (2). Uma vez conectado você deverá ver a aba VESC EXPRESS à esquerda (3), clique aqui para acessar as configurações do dispositivo. Clique na guia Wi-Fi® na parte superior para configurações de Wi-Fi® (4).
O Wi-Fi® no VESC-Express possui 2 modos, modo Estação e ponto de acesso. O modo estação se conectará ao seu roteador em casa (acesso através de qualquer dispositivo com a ferramenta VESC conectada a WLAN/LAN) e o ponto de acesso gerará um ponto de acesso Wi-Fi® ao qual você pode se conectar.
O modo estação exige que você insira o SSID do roteador e a senha do Wi-Fi®, geralmente encontrados em um adesivo no roteador. Depois de inserir isso nas configurações do VESC-Express, certifique-se de que o modo Wi-Fi® esteja definido como 'Modo estação' e clique em escrever para salvar (5).
O ponto de acesso requer apenas que você selecione o modo Wi-Fi® 'Ponto de acesso' e clique em escrever para salvar (5)
Você pode alterar o SSID e a senha para o que quiser, mas lembre-se de escrever para salvar a configuração.
Assim que o ponto de acesso estiver ativo, vá para as configurações de Wi-Fi® no seu dispositivo e procure o SSID do ponto de acesso. Uma vez encontrado, clique em conectar e digite a senha escolhida. Uma vez conectado, abra a ferramenta VESC.
Quer você tenha se conectado por meio de seu roteador (modo de estação) ou por meio de wifi expresso (ponto de acesso), você deverá ver o dongle expresso aparecer ao abrir a ferramenta vesc.
Certo é um example de como seria.
Informações úteis
Taxa de log
A taxa de registro é limitada pelo CAN-Speed. Para exampOu seja, a 500k baud você pode enviar cerca de 1000 quadros por segundo. Se você tiver um dispositivo VESC extra que envia status 1-5 a 50 Hz, você terá 1000 – 50*5 = 750 quadros/segundo restantes. Dois campos no log requerem um can-frame; se você quiser registrar 20 valores, obterá uma taxa máxima de (1000 – 50 * 5) / (20/2) = 75 Hz.
É aconselhável usar uma taxa mais baixa, sem maximizar a largura de banda CAN. Uma taxa de log mais baixa também reduz bastante fileé o tamanho! O valor padrão é de 5 a 10 Hz.
Ajustar campos de registro
Os campos de log podem ser ajustados facilmente na ferramenta VESC. Com o dispositivo conectado, acesse VESC Dev Tools, selecione a aba Lisp e clique em “ler existente”. Isto exibirá todos os campos registrados no dispositivo VESC local, dispositivos no CAN e BMS. Depois de editar o código nos campos necessários, clique em upload para carregar seu código de registro personalizado no controlador de velocidade VESC.
Vídeos
Benjamin Vedder fez alguns vídeos de demonstração/explicação do dongle VESC Express. Veja abaixo o link do canal e links de vídeos relevantes:
Demonstração expressa VESC
https://www.youtube.com/watch?v=wPzdzcfRJ38&ab_channel=BenjaminVedder
Introdução aos pacotes VESC
https://www.youtube.com/watch?v=R5OrEKK5T5Q&ab_channel=BenjaminVedder
Canal de Benjamin Vedder
https://www.youtube.com/@BenjaminsRobotics
Se você tiver algum problema com seu dongle expresso VESC, entre em contato com Trampum suporte
suporte@trampaboards.com
Documentos / Recursos
 |
Dongle Expresso VESC ESP32 e Módulo Logger [pdf] Manual do Usuário ESP32, ESP32 Express Dongle e Módulo Logger, Express Dongle e Módulo Logger, Dongle e Módulo Logger, Módulo Logger |
