Como baixar e usar WPILib Shuffleboard para FRC
Se você está procurando um painel moderno e versátil para o seu robô FRC, talvez queira conferir o WPILib Shuffleboard. Neste artigo, explicaremos o que é o WPILib Shuffleboard, como baixá-lo e como usá-lo para a programação e depuração do seu robô.
wpilib shuffleboard download
O que é WPILib Shuffleboard?
WPILib Shuffleboard é um painel para FRC baseado em JavaFX que pode exibir dados de tabelas de rede usando uma variedade de widgets que podem ser posicionados e controlados com código de robô. Ele foi projetado para ser usado na criação de painéis para programas C++ e Java. Se você já usou o SmartDashboard no passado, já está familiarizado com muitos dos recursos do WPILib Shuffleboard, pois eles funcionam fundamentalmente da mesma maneira. Mas WPILib Shuffleboard tem muitos recursos que não estão no SmartDashboard.
Recursos do WPILib Shuffleboard
Aqui estão alguns dos destaques do WPILib Shuffleboard:
Graphics é baseado em JavaFX, o padrão gráfico Java. Cada um dos componentes tem uma folha de estilo associada, tornando possível ter diferentes skins ou temas para o WPILib Shuffleboard. Existem temas claros e escuros padrão disponíveis.
O WPILib Shuffleboard oferece suporte a várias planilhas para a exibição de seus dados. Você pode criar uma nova planilha (mostrada como uma guia na janela WPILib Shuffleboard) e indicar se e quais dados devem ser preenchidos automaticamente nela. Por padrão, há uma guia Teste e uma guia SmartDashboard que são preenchidas automaticamente à medida que os dados chegam. Outras guias podem ser para depuração do robô versus direção.
Elementos de exibição gráfica (widgets) são dispostos em uma grade para manter a interface limpa e fácil de ler. Você pode alterar o tamanho da grade para ter mais ou menos resolução em seus layouts e dicas visuais são fornecidas para ajudá-lo a alterar seu layout usando arrastar e soltar. Ou você pode optar por desativar as linhas de grade, embora o layout da grade seja preservado.
Os layouts são salvos e o layout anterior é instanciado por padrão quando você executa o WPILib Shuffleboard novamente.
Existe um recurso de gravação e reprodução que permite que você revise os dados enviados pelo seu programa de robô depois que ele terminar. Dessa forma, você pode revisar cuidadosamente as ações do robô se algo der errado.
Widgets de gráfico estão disponíveis para dados numéricos e você pode arrastar dados para um gráfico para ver vários pontos ao mesmo tempo e na mesma escala.
Você pode estender o WPILib Shuffleboard escrevendo seus próprios widgets específicos para os requisitos de sua equipe. A documentação sobre a extensão pode ser encontrada em .
Benefícios do WPILib Shuffleboard
Alguns dos benefícios de usar o WPILib Shuffleboard são:
Você pode personalizar seu painel de acordo com suas necessidades e preferências.
Você pode monitorar e controlar facilmente os dados do seu robô usando vários widgets e guias.
Você pode depurar o código do seu robô gravando e reproduzindo seus dados.
Você pode usar recursos avançados como comandos, subsistemas, ajuste de PID, hierarquias, etc.
Como baixar WPILib Shuffleboard
Requisitos para WPILib Shuffleboard
Para baixar e usar o WPILib Shuffleboard, você precisa:
JRE 11. Java 11 é necessário. Nenhuma outra versão do Java é suportada. O Java 11 é instalado pelo Steps to Download WPILib Shuffleboard
To download WPILib Shuffleboard, you need to follow the WPILib installation guide that will guide you through the steps of installing the WPILib suite, which includes WPILib Shuffleboard, VS Code, JDK, and other tools. You can download the latest release of the installer from GitHub. The installer is available for Windows, Linux, and macOS platforms. You will need to extract the installer file and run it on your computer. The installer will detect your existing WPILib installation and update it to the latest version. You can also choose to install only the tools or everything depending on your needs.
After installing WPILib Shuffleboard, you can launch it from the YEAR WPILib tools folder on your desktop or from the command line by typing shuffleboard. You can also start it automatically when the Driver Station starts by setting the Dashboard Type to Shuffleboard in the settings tab of the Driver Station.
How to Use WPILib Shuffleboard
Starting WPILib Shuffleboard
When you start WPILib Shuffleboard, you will see a window like this:
Esta janela é composta por três áreas principais:
Área de fontes: aqui estão as fontes de dados das quais você pode escolher valores de NetworkTables ou outras fontes para exibir arrastando um valor para uma das guias.
Painéis de guias: é aqui que seus dados são exibidos do robô ou de outras fontes. Neste exemplo, são os subsistemas de modo de teste que são mostrados aqui na guia LiveWindow. Essa área pode mostrar qualquer número de janelas com guias e cada janela tem seu próprio conjunto de propriedades, como tamanho da grade e preenchimento automático.
Controles de gravação/reprodução: conjunto de controles semelhantes a mídia onde você pode reproduzir a sessão atual para ver dados históricos.
Tour pela interface WPILib Shuffleboard
A interface WPILib Shuffleboard é baseada em JavaFX, que permite personalização e temas. Você pode alterar a aparência do WPILib Shuffleboard selecionando um tema diferente no menu Temas. Existem dois temas padrão: claro e escuro. Você também pode criar seus próprios temas personalizados usando folhas de estilo.
A interface também oferece suporte a várias planilhas ou guias para exibição de diferentes conjuntos de dados. Você pode criar uma nova guia clicando no botão + ao lado das guias existentes. Você também pode renomear, duplicar ou excluir guias clicando com o botão direito do mouse nelas. Cada guia tem suas próprias propriedades que você pode acessar clicando no ícone de engrenagem ao lado do nome da guia. Aqui você pode alterar o tamanho da grade, o modo de preenchimento automático e o modo de layout da guia.
Os widgets são os elementos gráficos que exibem dados do seu robô ou de outras fontes. Existem muitos tipos de widgets disponíveis, como campos de texto, controles deslizantes, botões, gráficos, câmeras, etc. Você pode adicionar um widget a uma guia arrastando um valor da área de fontes para uma célula vazia na grade. Você também pode alterar o tipo de widget clicando com o botão direito nele e selecionando Alterar tipo de widget. Cada widget tem suas próprias propriedades que você pode acessar clicando no ícone de chave inglesa ao lado do nome do widget. Aqui você pode alterar o título, tamanho, posição, cor, etc. do widget.
Exibindo dados do seu robô
Para exibir os dados do seu robô no WPILib Shuffleboard, você precisa usar NetworkTables no código do seu robô. NetworkTables é um sistema de pares chave-valor que permite enviar dados entre diferentes dispositivos em uma rede. Você pode usar NetworkTables para enviar dados de seu programa de robô para WPILib Shuffleboard e vice-versa.
Em C++, você pode usar o namespace nt para acessar as funções NetworkTables. Por exemplo, para enviar um valor booleano chamado "Example" com valor true, você pode escrever:
nt::SetEntryValue("Exemplo", nt::Value::MakeBoolean(true));
Em Java, você pode usar a classe NetworkTable para acessar as funções NetworkTables.Por exemplo, para enviar um valor booleano chamado "Example" com valor true, você pode escrever:
NetworkTableInstance.getDefault().getEntry("Example").setBoolean(true);
Você também pode usar as classes SmartDashboard ou Shuffleboard em Java ou C++ para enviar dados usando NetworkTables com alguns métodos convenientes. Por exemplo, para enviar um valor booleano chamado "Example" com um valor true usando o SmartDashboard, você pode escrever:
SmartDashboard.putBoolean("Exemplo", verdadeiro);
Para exibir os dados do seu robô no WPILib Shuffleboard, você precisa arrastar um valor da área de fontes para uma célula vazia na grade. Você também pode alterar o tipo de widget clicando com o botão direito nele e selecionando Alterar tipo de widget. Cada widget tem suas próprias propriedades que você pode acessar clicando no ícone de chave inglesa ao lado do nome do widget. Aqui você pode alterar o título, tamanho, posição, cor, etc. do widget. Trabalhando com widgets e guias
O WPILib Shuffleboard permite que você personalize seu painel trabalhando com widgets e guias. Você pode criar guias diferentes para finalidades diferentes, como dirigir, testar, ajustar, etc. Você também pode adicionar, remover, mover, redimensionar e configurar widgets para exibir os dados desejados da maneira que desejar.
Para criar uma nova guia, clique no botão + ao lado das guias existentes e insira um nome para a guia. Você também pode clicar com o botão direito do mouse em uma guia e selecionar Duplicar guia ou Excluir guia para copiar ou remover uma guia. Para alterar as propriedades de uma guia, como tamanho da grade, modo de preenchimento automático e modo de layout, clique no ícone de engrenagem ao lado do nome da guia.
Para adicionar um widget a uma guia, arraste um valor da área de fontes para uma célula vazia na grade. Você também pode clicar com o botão direito do mouse em uma célula vazia e selecionar Adicionar widget para inserir manualmente uma chave e um valor para o widget. Para remover um widget de uma guia, clique com o botão direito nele e selecione Remover Widget.
Para mover um widget para uma posição diferente na grade, arraste-o para a célula desejada. Você também pode usar as teclas de seta para mover um widget uma célula por vez.Para redimensionar um widget, arraste sua borda ou canto até que caiba nas células desejadas. Você também pode usar as teclas + e - para aumentar ou diminuir o tamanho de um widget em uma célula por vez.
Para alterar o tipo de um widget, clique com o botão direito nele e selecione Alterar tipo de widget. Você pode escolher entre diferentes tipos de widgets, dependendo do tipo de dados e de sua preferência. Por exemplo, você pode exibir um valor booleano como uma caixa booleana, campo de texto, botão de alternância ou chave de alternância. Para alterar as propriedades de um widget, como título, cor, intervalo etc., clique no ícone de chave inglesa ao lado do nome do widget.
Gravação e Reprodução
O WPILib Shuffleboard possui um recurso que permite gravar e reproduzir dados do seu robô ou de outras fontes. Isso pode ser útil para depurar o código do robô ou revisar o desempenho do robô.
Para gravar dados de seu robô ou outras fontes, clique no botão de gravação na parte inferior da janela do WPILib Shuffleboard. Isso iniciará a gravação de todos os dados enviados ao WPILib Shuffleboard via NetworkTables ou outras fontes. Você pode ver a duração da gravação em segundos ao lado do botão de gravação. Para parar de gravar dados, clique no botão de gravação novamente.
Para reproduzir os dados gravados, clique no botão play na parte inferior da janela WPILib Shuffleboard. Isso iniciará a reprodução dos dados que foram gravados em ordem cronológica. Você pode ver o tempo atual e o tempo total da reprodução ao lado do botão de reprodução. Você também pode usar o controle deslizante abaixo do botão de reprodução para pular para qualquer ponto no tempo na reprodução. Para pausar ou retomar a reprodução, clique no botão de reprodução novamente.
Você também pode salvar e carregar dados gravados usando arquivos JSON. Para salvar os dados gravados como um arquivo JSON, clique em Arquivo > Salvar gravação como... e escolha um local e um nome para o seu arquivo. Para carregar os dados gravados de um arquivo JSON, clique em Arquivo > Abrir Gravação... e selecione seu arquivo.
Conclusão
O WPILib Shuffleboard é um painel poderoso e versátil para FRC que pode ajudá-lo a monitorar e controlar os dados do seu robô usando vários widgets e guias. Ele também possui recursos como gravação e reprodução que podem ajudá-lo a depurar o código do robô ou revisar o desempenho do robô. Você pode baixar o WPILib Shuffleboard como parte do pacote WPILib do GitHub e seguir o guia de instalação do WPILib para instalá-lo em seu computador. Você também pode estender o WPILib Shuffleboard criando seus próprios widgets personalizados usando JavaFX. Esperamos que este artigo tenha ajudado você a entender como baixar e usar o WPILib Shuffleboard para FRC.
perguntas frequentes
P: O que é WPILib Shuffleboard?
R: WPILib Shuffleboard é um painel para FRC baseado em JavaFX que pode exibir dados de tabelas de rede usando uma variedade de widgets que podem ser posicionados e controlados com código de robô.
P: Como faço para baixar o WPILib Shuffleboard?
R: Você pode baixar o WPILib Shuffleboard como parte do pacote WPILib no GitHub[^ 2^] e seguir o guia de instalação do WPILib para instalá-lo em seu computador.
P: Como eu uso o WPILib Shuffleboard?
R: Você pode usar WPILib Shuffleboard para exibir dados de seu robô ou outras fontes usando vários widgets e guias. Você também pode usar o WPILib Shuffleboard para gravar e reproduzir dados para fins de depuração ou revisão. Você também pode estender o WPILib Shuffleboard criando seus próprios widgets personalizados usando JavaFX.
P: Quais são os benefícios do WPILib Shuffleboard?
R: Alguns dos benefícios de usar o WPILib Shuffleboard são que você pode personalizar seu painel de acordo com suas necessidades e preferências, monitorar e controlar facilmente os dados do robô, depurar o código do robô gravando e reproduzindo seus dados e usar recursos avançados como comandos, subsistemas, ajuste de PID, hierarquias, etc.
P: Quais são os requisitos para WPILib Shuffleboard?
R: Para baixar e usar o WPILib Shuffleboard, você precisa do JRE 11, que é instalado pelo instalador do WPILib.Você também precisa de uma conexão de rede entre seu computador e seu robô ou outras fontes.
0517a86e26
Comments