Cómo utilizar la telemetría ELRS para enviar cargas útiles desde scripts EdgeTX Lua a Betaflight

Dominar la comunicación de carga útil entre EdgeTX y Betaflight

¿Alguna vez has mirado un dron FPV en vuelo y te has preguntado cómo fluyen los datos sin problemas entre tu transmisor y el controlador de vuelo? Para aquellos que exploran secuencias de comandos EdgeTX Lua, enviar cargas útiles a un controlador de vuelo con tecnología Betaflight a través de telemetría ExpressLRS (ELRS) puede resultar abrumador al principio. 📡

Cuando comencé, la función crossfireTelemetryPush parecía un misterio. Claro, había ejemplos dando vueltas, pero comprender la comunicación a nivel de bytes fue el verdadero desafío. ¿Cómo podría un simple script enviar comandos al cerebro de tu dron? Yo estaba en el mismo barco, buscando claridad.

Imagínese esto: sostiene la radio, presiona botones y observa cómo el controlador de vuelo responde casi instantáneamente. Ya sea que esté controlando LED, solicitando datos de telemetría o ajustando parámetros de MSP, el poder de las secuencias de comandos EdgeTX cobra vida cuando domina la creación de carga útil. 🚀

En este artículo, analizaremos las secuencias de comandos Lua para telemetría FPV paso a paso, enfocándonos en crear y enviar cargas útiles usando telemetría ELRS. Sin jerga compleja, solo ejemplos fáciles de seguir para comenzar. Al final, escribirás con confianza guiones que se comunicarán con Betaflight, desbloqueando una nueva capa de control sobre tu dron. ¡Vamos a sumergirnos!

--[[    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.]]

Creación de cargas útiles para comunicación ELRS con EdgeTX Lua

En estos ejemplos, los scripts se centran en crear una carga útil y enviarla a través de telemetría ELRS para comunicarse con el controlador de vuelo Betaflight. Esto se hace usando funciones específicas de Lua como fuego cruzadoTelemetríaPush, que permite al transmisor de radio enviar tramas de telemetría estructuradas. La carga útil, en su forma más simple, consta de direcciones y comandos específicos formateados en una matriz. Cada parte del guión ha sido diseñada para optimizar la forma en que se establece la comunicación entre la radio EdgeTX y Betaflight. 🛠️

Para empezar, el CONSTANTE La tabla juega un papel vital al almacenar las direcciones del controlador de vuelo y del transmisor, así como el tipo de trama utilizada para la comunicación. Por ejemplo, la dirección Betaflight podría establecerse en 0xEE, que representa el controlador de vuelo del dron. El uso de una tabla constante garantiza la modularidad, por lo que las direcciones se pueden actualizar fácilmente sin tener que reescribir grandes porciones del código. El construircarga útil La función construye dinámicamente el marco de telemetría agregando los campos de dirección, comando y datos en una matriz Lua. Este enfoque modular mantiene el código limpio y reutilizable en diferentes comandos o funciones de telemetría.

Uno de los componentes más críticos aquí es el fuego cruzadoTelemetríaPush función. Este comando actúa como puente para enviar la carga útil desde la radio al receptor, donde el controlador de vuelo Betaflight puede procesarla. Por ejemplo, la función puede enviar un tipo de fotograma como "0x2D" con comandos específicos, como habilitar LED o consultar datos de telemetría. Para garantizar la confiabilidad, se implementa el manejo de errores para confirmar si la carga útil se envió correctamente. De lo contrario, el script genera un mensaje de error con fines de depuración, lo cual resulta útil al probar scripts en escenarios de vuelo reales. 🚁

Finalmente, el carga útil de depuración La función proporciona una forma de visualizar los datos de telemetría que se envían. Convierte cada byte de la carga útil a un formato hexadecimal para facilitar la depuración. Este paso es crucial cuando se trata de comunicación a nivel de bytes, ya que puede verificar directamente la estructura de la carga útil. Al combinar estos componentes (funciones modulares, utilidades de depuración y generación de carga útil dinámica), estos scripts ofrecen una base sólida para la comunicación de telemetría avanzada. Con un poco de práctica, puedes ampliar este enfoque para controlar los LED, activar alarmas o incluso enviar comandos personalizados al controlador de vuelo de tu dron.

Desbloqueo de la comunicación de telemetría avanzada con EdgeTX Lua

Un aspecto crítico, pero que a menudo se pasa por alto, del envío de cargas útiles a través de telemetría ELRS en EdgeTX es la forma en que el formato de datos afecta la confiabilidad de la comunicación. Cuando envías una carga útil, no basta con empaquetar el comando y los datos; comprender la estructura de bytes, los encabezados de las tramas y los mecanismos de verificación de errores garantiza una comunicación fluida. Cada trama de telemetría tiene un orden específico: dirección del remitente, dirección del receptor, ID de comando y datos opcionales. Estructurar esto adecuadamente puede mejorar significativamente la forma en que el controlador de vuelo procesa sus instrucciones. ✈️

Otro elemento importante es elegir los ID de comando correctos para tareas como leer datos de sensores, cambiar parámetros de vuelo o incluso activar LED. Por ejemplo, el MSP (Protocolo serie MultiWii) de Betaflight define ciertos comandos que se alinean con estas tareas. Para implementar esto con scripts EdgeTX Lua, puede combinar funciones como fuego cruzadoTelemetríaPush y lógica de creación de tablas para enviar la secuencia exacta de bytes. Al hacer referencia a la documentación de Betaflight MSP, puede asignar cada comando de telemetría a una función específica en su script Lua para un control preciso.

Además, probar estos guiones en entornos del mundo real ayuda a cerrar la brecha entre la teoría y la práctica. Por ejemplo, durante la depuración, es posible que encuentre desalineación de datos o retrasos en la transmisión. El uso de funciones de registro como `print()` o incluso la creación de una prueba de respuesta de LED simple puede verificar que sus cargas útiles estén formateadas y recibidas correctamente por el dron. Con el tiempo, desarrollará scripts que no solo envíen comandos sino que también manejen los errores con elegancia, lo que garantizará una experiencia de vuelo más fluida. 🚀