Cara Menggunakan Telemetri ELRS untuk Mengirim Muatan dari Skrip EdgeTX Lua ke Betaflight

Menguasai Komunikasi Payload Antara EdgeTX dan Betaflight

Pernahkah Anda menatap drone FPV yang sedang terbang dan bertanya-tanya bagaimana data mengalir dengan lancar antara pemancar dan pengontrol penerbangan Anda? Bagi mereka yang menjelajahi skrip EdgeTX Lua, mengirimkan muatan ke pengontrol penerbangan bertenaga Betaflight melalui telemetri ExpressLRS (ELRS) pada awalnya terasa membebani. 📡

Ketika saya pertama kali memulai, fungsi crossfireTelemetryPush tampak seperti sebuah misteri. Tentu saja, ada banyak contoh yang beredar, tetapi memahami komunikasi tingkat byte adalah tantangan sebenarnya. Bagaimana skrip sederhana bisa mengirimkan perintah ke otak drone Anda? Saya berada di perahu yang sama, mencari kejelasan.

Bayangkan ini: Anda memegang radio, menekan tombol, dan melihat pengontrol penerbangan merespons hampir seketika. Baik Anda mengontrol LED, meminta data telemetri, atau menyesuaikan parameter MSP, kekuatan skrip EdgeTX menjadi hidup saat Anda menguasai pembuatan payload. 🚀

Dalam artikel ini, kami akan menguraikan skrip Lua untuk telemetri FPV selangkah demi selangkah, dengan fokus pada pembuatan dan pengiriman muatan menggunakan telemetri ELRS. Tidak ada jargon yang rumit—hanya contoh yang mudah diikuti untuk membantu Anda memulai. Pada akhirnya, Anda akan dengan percaya diri menulis skrip yang berhubungan dengan Betaflight, membuka lapisan kontrol baru atas drone Anda. Mari selami!

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

Membangun Muatan untuk Komunikasi ELRS dengan EdgeTX Lua

Dalam contoh ini, skrip berfokus pada pembuatan payload dan mengirimkannya melalui telemetri ELRS untuk berkomunikasi dengan pengontrol penerbangan Betaflight. Ini dilakukan dengan menggunakan fungsi Lua tertentu seperti baku tembakTelemetriPush, yang memungkinkan pemancar radio mengirim bingkai telemetri terstruktur. Payload, dalam bentuknya yang paling sederhana, terdiri dari alamat dan perintah tertentu yang diformat ke dalam array. Setiap bagian skrip telah dirancang untuk mengoptimalkan cara komunikasi terjalin antara radio EdgeTX dan Betaflight. 🛠️

Untuk memulai, itu KONST tabel memainkan peran penting dengan menyimpan alamat pengontrol penerbangan dan pemancar, serta jenis bingkai yang digunakan untuk komunikasi. Misalnya, alamat Betaflight mungkin disetel ke 0xEE, mewakili pengontrol penerbangan drone. Menggunakan tabel konstan memastikan modularitas, sehingga alamat dapat diperbarui dengan mudah tanpa menulis ulang sebagian besar kode. Itu buildPayload fungsi secara dinamis membangun bingkai telemetri dengan menambahkan alamat, perintah, dan bidang data ke dalam array Lua. Pendekatan modular ini menjaga kode tetap bersih dan dapat digunakan kembali di berbagai perintah atau fungsi telemetri.

Salah satu komponen terpenting di sini adalah baku tembakTelemetriPush fungsi. Perintah ini bertindak sebagai jembatan untuk mengirimkan muatan dari radio ke penerima, di mana pengontrol penerbangan Betaflight dapat memprosesnya. Misalnya, fungsi tersebut dapat mendorong jenis bingkai seperti `0x2D` dengan perintah khusus seperti mengaktifkan LED atau menanyakan data telemetri. Untuk memastikan keandalan, penanganan kesalahan diterapkan untuk mengonfirmasi apakah payload berhasil dikirim. Jika tidak, skrip akan mengeluarkan pesan kesalahan untuk tujuan debugging, yang berguna saat menguji skrip dalam skenario penerbangan nyata. 🚁

Akhirnya, itu debugPayload fungsi menyediakan cara untuk memvisualisasikan data telemetri yang dikirim. Ini mengubah setiap byte payload menjadi format heksadesimal untuk memudahkan debugging. Langkah ini sangat penting ketika menangani komunikasi tingkat byte, karena Anda dapat memverifikasi struktur payload secara langsung. Dengan menggabungkan komponen-komponen ini—fungsi modular, utilitas debugging, dan pembuatan muatan dinamis—skrip ini menawarkan dasar yang kuat untuk komunikasi telemetri tingkat lanjut. Dengan sedikit latihan, Anda dapat memperluas pendekatan ini untuk mengontrol LED, memicu alarm, atau bahkan mengirim perintah khusus ke pengontrol penerbangan drone Anda.

Membuka Komunikasi Telemetri Tingkat Lanjut dengan EdgeTX Lua

Salah satu aspek yang sering diabaikan namun penting dalam pengiriman muatan melalui telemetri ELRS di EdgeTX adalah cara pemformatan data memengaruhi keandalan komunikasi. Saat Anda mengirim payload, tidak cukup hanya mengemas perintah dan data saja; memahami struktur byte, header bingkai, dan mekanisme pemeriksaan kesalahan memastikan komunikasi yang lancar. Setiap bingkai telemetri memiliki urutan tertentu: alamat pengirim, alamat penerima, ID perintah, dan data opsional. Penataan yang tepat dapat meningkatkan cara pengendali penerbangan memproses instruksi Anda secara signifikan. ✈️

Elemen penting lainnya adalah memilih ID perintah yang tepat untuk tugas seperti membaca data sensor, mengubah parameter penerbangan, atau bahkan memicu LED. Misalnya, MSP (MultiWii Serial Protocol) Betaflight mendefinisikan perintah tertentu yang selaras dengan tugas-tugas ini. Untuk mengimplementasikan ini dengan skrip EdgeTX Lua, Anda dapat menggabungkan fungsi seperti baku tembakTelemetriPush dan logika pembuatan tabel untuk mengirim urutan byte yang tepat. Dengan mereferensikan dokumentasi Betaflight MSP, Anda dapat memetakan setiap perintah telemetri ke fungsi tertentu dalam skrip Lua Anda untuk kontrol yang tepat.

Selain itu, menguji skrip ini di lingkungan dunia nyata membantu menjembatani kesenjangan antara teori dan praktik. Misalnya, saat melakukan debug, Anda mungkin mengalami ketidakselarasan data atau penundaan transmisi. Menggunakan fungsi logging seperti `print()` atau bahkan membuat tes respons LED sederhana dapat memverifikasi bahwa payload Anda diformat dan diterima oleh drone dengan benar. Seiring waktu, Anda akan mengembangkan skrip yang tidak hanya mengirimkan perintah tetapi juga menangani kesalahan dengan baik, memastikan pengalaman terbang yang lebih lancar. 🚀