Como usar a telemetria ELRS para enviar cargas úteis de scripts Lua EdgeTX para Betaflight

Dominando a comunicação de carga útil entre EdgeTX e Betaflight

Você já olhou para um drone FPV em vôo e se perguntou como os dados fluem perfeitamente entre o transmissor e o controlador de vôo? Para aqueles que exploram scripts Lua EdgeTX, enviar cargas úteis para um controlador de voo com tecnologia Betaflight por meio de telemetria ExpressLRS (ELRS) pode parecer complicado no início. 📡

Quando comecei, a função crossfireTelemetryPush parecia um mistério. Claro, havia exemplos por aí, mas entender a comunicação em nível de byte era o verdadeiro desafio. Como um script simples poderia enviar comandos ao cérebro do seu drone? Eu estava no mesmo barco, em busca de clareza.

Imagine o seguinte: você está segurando seu rádio, pressionando botões e observando o controlador de vôo responder quase instantaneamente. Esteja você controlando LEDs, solicitando dados de telemetria ou ajustando parâmetros MSP, o poder dos scripts EdgeTX ganha vida quando você domina a criação de carga útil. 🚀

Neste artigo, detalharemos Scripting Lua para telemetria FPV passo a passo, com foco na criação e envio de cargas usando telemetria ELRS. Nenhum jargão complexo – apenas exemplos fáceis de seguir para você começar. No final, você escreverá scripts com confiança que se comunicam com o Betaflight, desbloqueando uma nova camada de controle sobre seu drone. Vamos mergulhar!

--[[    Lua Script for EdgeTX to send payloads via ELRS telemetry to Betaflight    Communication is established using the 'crossfireTelemetryPush' function    Example 1: Basic payload structure with error handling and modular functions ]]
local CONST = {
   address = { betaflight = 0xEE, transmitter = 0xDF },
   frameType = { displayPort = 0x2D }
}

-- Function to prepare and send the payload to Betaflight
local function sendPayloadToBetaflight(cmd, data)
    local payloadOut = { CONST.address.betaflight, CONST.address.transmitter, cmd }
    -- Add additional data to the payload if provided
    if data ~= nil then
        for i = 1, #data do
            payloadOut[3 + i] = data[i]
        end
    end
    -- Send the telemetry frame
    local success = crossfireTelemetryPush(CONST.frameType.displayPort, payloadOut)
    if success then
        print("Payload successfully sent to Betaflight!")
    else
        print("Error: Payload failed to send.")
    end
end

-- Example usage
local command = 0x05 -- Example command
local data = { 0x01, 0x02, 0x03, 0x04 } -- Example payload data
sendPayloadToBetaflight(command, data)
--[[    Notes:   - The CONST table defines addresses and frame types to keep the script modular.   - Error handling ensures feedback on successful or failed transmissions.]]

--[[    Advanced Example: Modular functions, dynamic payload generation, and debugging output    for sending data via ELRS telemetry.]]
local CONST = {
    betaflightAddress = 0xEE,
    txAddress = 0xDF,
    frameType = 0x2D
}

-- Debug function to print payloads in hex format
local function debugPayload(payload)
    local debugString = "Payload: "
    for i = 1, #payload do
        debugString = debugString .. string.format("0x%02X ", payload[i])
    end
    print(debugString)
end

-- Function to dynamically build payloads
local function buildPayload(command, data)
    local payload = { CONST.betaflightAddress, CONST.txAddress, command }
    if data then
        for i, value in ipairs(data) do
            table.insert(payload, value)
        end
    end
    return payload
end

-- Function to send telemetry payload
local function sendTelemetry(command, data)
    local payload = buildPayload(command, data)
    debugPayload(payload) -- Print the payload for debugging
    local success = crossfireTelemetryPush(CONST.frameType, payload)
    if success then
        print("Telemetry sent successfully.")
    else
        print("Telemetry failed to send.")
    end
end

-- Example usage
local testCommand = 0x10 -- Example command ID
local testData = { 0x0A, 0x0B, 0x0C }
sendTelemetry(testCommand, testData)
--[[    Debugging output will print the exact bytes being sent,    making it easier to verify payload structure and troubleshoot issues.]]

Construindo cargas úteis para comunicação ELRS com EdgeTX Lua

Nestes exemplos, os scripts se concentram na criação de uma carga útil e no envio dela por meio de telemetria ELRS para se comunicar com o controlador de voo Betaflight. Isso é feito usando funções Lua específicas como crossfireTelemetriaPush, que permite ao transmissor de rádio enviar quadros de telemetria estruturados. A carga útil, em sua forma mais simples, consiste em endereços e comandos específicos formatados em um array. Cada parte do script foi projetada para otimizar a forma como a comunicação é estabelecida entre o rádio EdgeTX e o Betaflight. 🛠️

Para começar, o CONST A tabela desempenha um papel vital ao armazenar os endereços do controlador de vôo e do transmissor, bem como o tipo de quadro usado para comunicação. Por exemplo, o endereço Betaflight pode ser definido como 0xEE, representando o controlador de voo do drone. O uso de uma tabela constante garante modularidade, para que os endereços possam ser atualizados facilmente sem reescrever grandes porções do código. O construirPayload A função constrói dinamicamente o quadro de telemetria anexando os campos de endereço, comando e dados em um array Lua. Essa abordagem modular mantém o código limpo e reutilizável em diferentes comandos ou funções de telemetria.

Um dos componentes mais críticos aqui é o crossfireTelemetriaPush função. Este comando atua como uma ponte para enviar a carga do rádio para o receptor, onde o controlador de vôo Betaflight pode processá-la. Por exemplo, a função pode enviar um tipo de quadro como `0x2D` com comandos específicos, como habilitar LEDs ou consultar dados de telemetria. Para garantir a confiabilidade, o tratamento de erros é implementado para confirmar se a carga foi enviada com sucesso. Caso contrário, o script gerará uma mensagem de erro para fins de depuração, o que é útil ao testar scripts em cenários de voo reais. 🚁

Finalmente, o debugPayload A função fornece uma maneira de visualizar os dados de telemetria que estão sendo enviados. Ele converte cada byte da carga em um formato hexadecimal para facilitar a depuração. Esta etapa é crucial ao lidar com comunicação em nível de byte, pois você pode verificar diretamente a estrutura da carga útil. Ao combinar esses componentes – funções modulares, utilitários de depuração e geração dinâmica de carga útil – esses scripts oferecem uma base sólida para comunicação de telemetria avançada. Com um pouco de prática, você pode estender essa abordagem para controlar LEDs, disparar alarmes ou até mesmo enviar comandos personalizados ao controlador de voo do seu drone.

Desbloqueando comunicação de telemetria avançada com EdgeTX Lua

Um aspecto frequentemente esquecido, mas crítico, do envio de cargas via telemetria ELRS no EdgeTX é a maneira como a formatação de dados afeta a confiabilidade da comunicação. Quando você envia uma carga útil, não basta simplesmente empacotar o comando e os dados; compreender a estrutura de bytes, os cabeçalhos dos quadros e os mecanismos de verificação de erros garante uma comunicação tranquila. Cada quadro de telemetria possui uma ordem específica: endereço do remetente, endereço do receptor, ID do comando e dados opcionais. Estruturar isso adequadamente pode melhorar significativamente a forma como o controlador de vôo processa suas instruções. ✈️

Outro elemento importante é escolher os IDs de comando corretos para tarefas como leitura de dados de sensores, alteração de parâmetros de voo ou até mesmo acionamento de LEDs. Por exemplo, o MSP (MultiWii Serial Protocol) do Betaflight define certos comandos que se alinham com essas tarefas. Para implementar isso com scripts Lua EdgeTX, você pode combinar funções como crossfireTelemetriaPush e lógica de construção de tabela para enviar a sequência exata de bytes. Ao consultar a documentação do Betaflight MSP, você pode mapear cada comando de telemetria para uma função específica em seu script Lua para um controle preciso.

Além disso, testar esses scripts em ambientes do mundo real ajuda a preencher a lacuna entre a teoria e a prática. Por exemplo, durante a depuração, você pode encontrar desalinhamento de dados ou atrasos na transmissão. Usar funções de registro como `print()` ou até mesmo construir um teste simples de resposta de LED pode verificar se suas cargas estão formatadas corretamente e recebidas pelo drone. Com o tempo, você desenvolverá scripts que não apenas enviam comandos, mas também lidam com erros com elegância, garantindo uma experiência de voo mais tranquila. 🚀