Jak používat telemetrii ELRS k odesílání dat ze skriptů EdgeTX Lua do Betaflight

Zvládnutí komunikace mezi EdgeTX a Betaflight

Už jste někdy zírali na FPV dron za letu a přemýšleli jste, jak plynule proudí data mezi vaším vysílačem a letovým ovladačem? Pro ty, kdo prozkoumávají Skriptování EdgeTX Lua, může být odesílání užitečného zatížení do letového ovladače poháněného Betaflight prostřednictvím telemetrie ExpressLRS (ELRS) zpočátku ohromující. 📡

Když jsem poprvé začal, funkce crossfireTelemetryPush vypadala jako záhada. Jistě, příklady se vznášely, ale pochopení komunikace na úrovni bajtů bylo skutečnou výzvou. Jak by mohl jednoduchý skript posílat příkazy do mozku vašeho dronu? Byl jsem na stejné lodi a hledal jsem jasno.

Představte si toto: držíte rádio, mačkáte tlačítka a sledujete, jak letový ovladač reaguje téměř okamžitě. Ať už ovládáte LED diody, požadujete telemetrická data nebo upravujete parametry MSP, síla skriptování EdgeTX ožije, když zvládnete vytváření užitečného zatížení. 🚀

V tomto článku podrobně rozebereme Skriptování Lua pro telemetrii FPV, přičemž se zaměříme na vytváření a odesílání dat pomocí telemetrie ELRS. Žádný složitý žargon – pouze jednoduché příklady, které vám pomohou začít. Na konci budete s jistotou psát skripty, které budou komunikovat s Betaflight, čímž získáte novou úroveň kontroly nad vaším dronem. Pojďme se ponořit!

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

Vytváření užitečných zatížení pro komunikaci ELRS s EdgeTX Lua

V těchto příkladech se skripty zaměřují na vytvoření užitné zátěže a její odeslání prostřednictvím telemetrie ELRS ke komunikaci s letovým ovladačem Betaflight. To se provádí pomocí specifických funkcí Lua, jako je crossfireTelemetryPush, který umožňuje rádiovému vysílači odesílat strukturované telemetrické rámce. Užitná zátěž se ve své nejjednodušší podobě skládá ze specifických adres a příkazů zformátovaných do pole. Každá část skriptu byla navržena tak, aby optimalizovala způsob navazování komunikace mezi rádiem EdgeTX a Betaflight. 🛠️

Chcete-li začít, KONST Tabulka hraje zásadní roli tím, že ukládá adresy letového ovladače a vysílače a také typ rámce používaného pro komunikaci. Adresa Betaflight může být například nastavena na 0xEE, což představuje letový ovladač dronu. Použití konstantní tabulky zajišťuje modularitu, takže adresy lze snadno aktualizovat bez přepisování velkých částí kódu. The buildPayload Funkce dynamicky konstruuje telemetrický rámec připojením adres, příkazů a datových polí do pole Lua. Tento modulární přístup udržuje kód čistý a opakovaně použitelný pro různé příkazy nebo telemetrické funkce.

Jednou z nejkritičtějších součástí je zde crossfireTelemetryPush funkce. Tento příkaz funguje jako můstek pro odeslání užitečného zatížení z rádia do přijímače, kde jej může letový ovladač Betaflight zpracovat. Funkce může například vložit typ rámce jako `0x2D` se specifickými příkazy, jako je aktivace LED nebo dotazování na telemetrická data. Aby byla zajištěna spolehlivost, je implementováno zpracování chyb, které potvrdí, zda byl náklad odeslán úspěšně. Pokud ne, skript vypíše chybovou zprávu pro účely ladění, což je užitečné při testování skriptů ve skutečných letových scénářích. 🚁

Konečně, debugPayload Funkce poskytuje způsob, jak vizualizovat odesílaná telemetrická data. Převádí každý bajt užitečného zatížení do hexadecimálního formátu pro snadné ladění. Tento krok je zásadní při komunikaci na úrovni bajtů, protože můžete přímo ověřit strukturu užitečného zatížení. Kombinací těchto komponent – ​​modulárních funkcí, ladicích nástrojů a dynamického generování užitečného zatížení – tyto skripty nabízejí pevný základ pro pokročilou telemetrickou komunikaci. S trochou praxe můžete tento přístup rozšířit o ovládání LED diod, spouštění alarmů nebo dokonce posílání vlastních příkazů do letového ovladače vašeho dronu.

Odemknutí pokročilé telemetrické komunikace s EdgeTX Lua

Jedním z často přehlížených, ale kritických aspektů odesílání dat prostřednictvím telemetrie ELRS v EdgeTX je způsob, jakým formátování dat ovlivňuje spolehlivost komunikace. Když posíláte užitečné zatížení, nestačí jednoduše zabalit příkaz a data; pochopení struktury bajtů, záhlaví rámců a mechanismů kontroly chyb zajišťuje hladkou komunikaci. Každý telemetrický rámec má specifické pořadí: adresu odesílatele, adresu příjemce, ID příkazu a volitelná data. Správné strukturování může výrazně zlepšit způsob, jakým letový kontrolor zpracovává vaše pokyny. ✈️

Dalším důležitým prvkem je výběr správných ID příkazů pro úkoly, jako je čtení dat ze senzorů, změna letových parametrů nebo dokonce spouštění LED. Například MSP (MultiWii Serial Protocol) společnosti Betaflight definuje určité příkazy, které jsou v souladu s těmito úkoly. Chcete-li to implementovat pomocí Skriptů EdgeTX Lua, můžete kombinovat funkce jako crossfireTelemetryPush a logiku sestavování tabulek pro odesílání přesné sekvence bajtů. Odkazem na dokumentaci Betaflight MSP můžete mapovat každý telemetrický příkaz na konkrétní funkci ve vašem skriptu Lua pro přesné ovládání.

Navíc testování těchto skriptů v reálných prostředích pomáhá překlenout propast mezi teorií a praxí. Například při ladění můžete narazit na nesouosost dat nebo zpoždění přenosu. Použití funkcí protokolování, jako je `print()` nebo dokonce vytvoření jednoduchého testu odezvy LED, můžete ověřit, že vaše užitečné zatížení je správně naformátováno a přijato dronem. Postupem času budete vyvíjet skripty, které nejen posílají příkazy, ale také elegantně zpracovávají chyby a zajišťují plynulejší letový zážitek. 🚀