EdgeTX Lua Scripts سے Betaflight پر پے لوڈ بھیجنے کے لیے ELRS ٹیلی میٹری کا استعمال کیسے کریں

EdgeTX اور Betaflight کے درمیان پے لوڈ کمیونیکیشن میں مہارت حاصل کرنا

کیا آپ نے کبھی پرواز میں FPV ڈرون کو گھور کر سوچا ہے کہ ڈیٹا آپ کے ٹرانسمیٹر اور فلائٹ کنٹرولر کے درمیان بغیر کسی رکاوٹ کے کیسے بہتا ہے؟ EdgeTX Lua اسکرپٹنگ کو دریافت کرنے والوں کے لیے، Betaflight سے چلنے والے فلائٹ کنٹرولر کو ExpressLRS (ELRS) ٹیلی میٹری کے ذریعے پے لوڈ بھیجنا شروع میں بہت زیادہ محسوس کر سکتا ہے۔ 📡

جب میں نے پہلی بار شروع کیا تو crossfireTelemetryPush فنکشن ایک معمہ کی طرح لگتا تھا۔ یقینی طور پر، ارد گرد تیرتی ہوئی مثالیں تھیں، لیکن بائٹ لیول کمیونیکیشن کو سمجھنا ہی اصل چیلنج تھا۔ ایک سادہ اسکرپٹ آپ کے ڈرون کے دماغ کو کمانڈ کیسے بھیج سکتا ہے؟ میں اسی کشتی میں تھا، وضاحت کی تلاش میں۔

اس کا تصور کریں: آپ اپنا ریڈیو پکڑے ہوئے ہیں، بٹن دبا رہے ہیں، اور فلائٹ کنٹرولر کو تقریباً فوری طور پر جواب دیتے ہوئے دیکھ رہے ہیں۔ چاہے آپ LEDs کو کنٹرول کر رہے ہوں، ٹیلی میٹری ڈیٹا کی درخواست کر رہے ہوں، یا MSP پیرامیٹرز کو ایڈجسٹ کر رہے ہوں، EdgeTX اسکرپٹنگ کی طاقت اس وقت زندہ ہو جاتی ہے جب آپ پے لوڈ بنانے میں مہارت حاصل کر لیتے ہیں۔ 🚀

اس مضمون میں، ہم FPV ٹیلی میٹری کے لیے Lua اسکرپٹنگ کو مرحلہ وار توڑیں گے، ELRS ٹیلی میٹری کا استعمال کرتے ہوئے پے لوڈ بنانے اور بھیجنے پر توجہ مرکوز کریں گے۔ کوئی پیچیدہ لفظ نہیں — آپ کو شروع کرنے کے لیے صرف پیروی کرنے میں آسان مثالیں۔ آخر تک، آپ اعتماد کے ساتھ اسکرپٹ لکھیں گے جو Betaflight سے بات کرتے ہیں، آپ کے ڈرون پر کنٹرول کی ایک نئی پرت کو کھولتے ہیں۔ آئیے اندر غوطہ لگائیں!

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

EdgeTX Lua کے ساتھ ELRS کمیونیکیشن کے لیے پے لوڈز بنانا

ان مثالوں میں، اسکرپٹس پے لوڈ بنانے اور بیٹا فلائٹ فلائٹ کنٹرولر کے ساتھ بات چیت کرنے کے لیے اسے ELRS ٹیلی میٹری کے ذریعے بھیجنے پر توجہ مرکوز کرتی ہیں۔ یہ مخصوص Lua افعال کا استعمال کرتے ہوئے کیا جاتا ہے جیسے کراس فائر ٹیلی میٹری پش، جو ریڈیو ٹرانسمیٹر کو منظم ٹیلی میٹری فریم بھیجنے کی اجازت دیتا ہے۔ پے لوڈ، اپنی آسان ترین شکل میں، مخصوص پتوں اور کمانڈز پر مشتمل ہوتا ہے جو ایک صف میں فارمیٹ کیا جاتا ہے۔ اسکرپٹ کے ہر حصے کو EdgeTX ریڈیو اور Betaflight کے درمیان رابطے کے طریقے کو بہتر بنانے کے لیے ڈیزائن کیا گیا ہے۔ 🛠️

شروع کرنے کے لئے، CONST ٹیبل فلائٹ کنٹرولر اور ٹرانسمیٹر کے پتوں کے ساتھ ساتھ کمیونیکیشن کے لیے استعمال ہونے والے فریم کی قسم کو محفوظ کرکے ایک اہم کردار ادا کرتا ہے۔ مثال کے طور پر، Betaflight ایڈریس 0xEE پر سیٹ کیا جا سکتا ہے، جو ڈرون کے فلائٹ کنٹرولر کی نمائندگی کرتا ہے۔ مستقل جدول کا استعمال ماڈیولرٹی کو یقینی بناتا ہے، اس لیے ایڈریس کو کوڈ کے بڑے حصوں کو دوبارہ لکھے بغیر آسانی سے اپ ڈیٹ کیا جا سکتا ہے۔ دی بلڈ پے لوڈ فنکشن متحرک طور پر ایڈریس، کمانڈ، اور ڈیٹا فیلڈز کو Lua اری میں شامل کرکے ٹیلی میٹری فریم کی تعمیر کرتا ہے۔ یہ ماڈیولر اپروچ مختلف کمانڈز یا ٹیلی میٹری فنکشنز میں کوڈ کو صاف اور دوبارہ قابل استعمال رکھتا ہے۔

یہاں سب سے اہم اجزاء میں سے ایک ہے کراس فائر ٹیلی میٹری پش فنکشن یہ کمانڈ ریڈیو سے پے لوڈ کو ریسیور تک بھیجنے کے لیے پل کا کام کرتی ہے، جہاں Betaflight فلائٹ کنٹرولر اس پر کارروائی کر سکتا ہے۔ مثال کے طور پر، فنکشن مخصوص کمانڈز جیسے کہ LEDs کو فعال کرنا یا ٹیلی میٹری ڈیٹا کو استفسار کرنے کے ساتھ ایک فریم قسم جیسے `0x2D` کو آگے بڑھا سکتا ہے۔ وشوسنییتا کو یقینی بنانے کے لیے، اس بات کی تصدیق کرنے کے لیے کہ آیا پے لوڈ کامیابی کے ساتھ بھیجا گیا تھا، غلطی سے نمٹنے کا عمل کیا جاتا ہے۔ اگر نہیں، تو اسکرپٹ ڈیبگنگ کے مقاصد کے لیے غلطی کا پیغام دیتا ہے، جو حقیقی پرواز کے منظرناموں میں اسکرپٹ کی جانچ کرتے وقت مددگار ہوتا ہے۔ 🚁

آخر میں، ڈیبگ پے لوڈ فنکشن بھیجے جانے والے ٹیلی میٹری ڈیٹا کو دیکھنے کا ایک طریقہ فراہم کرتا ہے۔ یہ آسانی سے ڈیبگنگ کے لیے پے لوڈ کے ہر بائٹ کو ہیکساڈیسیمل فارمیٹ میں تبدیل کرتا ہے۔ بائٹ لیول کمیونیکیشن سے نمٹنے کے دوران یہ مرحلہ بہت اہم ہے، کیونکہ آپ پے لوڈ کی ساخت کی براہ راست تصدیق کر سکتے ہیں۔ ان اجزاء کو ملا کر — ماڈیولر فنکشنز، ڈیبگنگ یوٹیلیٹیز، اور ڈائنامک پے لوڈ جنریشن — یہ اسکرپٹ جدید ٹیلی میٹری کمیونیکیشن کے لیے ایک مضبوط بنیاد پیش کرتے ہیں۔ تھوڑی سی مشق کے ساتھ، آپ ایل ای ڈی کو کنٹرول کرنے، الارم کو متحرک کرنے، یا اپنے ڈرون کے فلائٹ کنٹرولر کو حسب ضرورت کمانڈ بھیجنے کے لیے اس نقطہ نظر کو بڑھا سکتے ہیں۔

EdgeTX Lua کے ساتھ ایڈوانسڈ ٹیلی میٹری کمیونیکیشن کو غیر مقفل کرنا

EdgeTX میں ELRS ٹیلی میٹری کے ذریعے پے لوڈز بھیجنے کا ایک اکثر نظر انداز لیکن اہم پہلو وہ طریقہ ہے جس سے ڈیٹا فارمیٹنگ مواصلاتی اعتبار کو متاثر کرتی ہے۔ جب آپ پے لوڈ بھیجتے ہیں تو صرف کمانڈ اور ڈیٹا کو پیک کرنا کافی نہیں ہوتا ہے۔ بائٹ ڈھانچہ، فریم ہیڈر، اور غلطی کی جانچ کے طریقہ کار کو سمجھنا ہموار مواصلات کو یقینی بناتا ہے۔ ہر ٹیلی میٹری فریم کا ایک مخصوص ترتیب ہوتا ہے: بھیجنے والے کا پتہ، وصول کنندہ کا پتہ، کمانڈ ID، اور اختیاری ڈیٹا۔ اس کو صحیح طریقے سے ترتیب دینے سے فلائٹ کنٹرولر آپ کی ہدایات پر عمل کرنے کے طریقے کو نمایاں طور پر بہتر بنا سکتا ہے۔ ✈️

ایک اور اہم عنصر سینسر ڈیٹا کو پڑھنے، فلائٹ پیرامیٹرز کو تبدیل کرنے، یا یہاں تک کہ ایل ای ڈی کو متحرک کرنے جیسے کاموں کے لیے صحیح کمانڈ IDs کا انتخاب کرنا ہے۔ مثال کے طور پر، Betaflight کا MSP (MultiWii سیریل پروٹوکول) ان کاموں کے ساتھ ہم آہنگ کچھ کمانڈز کی وضاحت کرتا ہے۔ اسے EdgeTX Lua اسکرپٹس کے ساتھ نافذ کرنے کے لیے، آپ جیسے فنکشنز کو یکجا کر سکتے ہیں۔ کراس فائر ٹیلی میٹری پش اور بائٹس کی صحیح ترتیب بھیجنے کے لیے ٹیبل بلڈنگ منطق۔ Betaflight MSP دستاویزات کا حوالہ دے کر، آپ درست کنٹرول کے لیے اپنے Lua اسکرپٹ میں ہر ٹیلی میٹری کمانڈ کو ایک مخصوص فنکشن میں نقشہ بنا سکتے ہیں۔

مزید برآں، ان اسکرپٹس کو حقیقی دنیا کے ماحول میں جانچنے سے نظریہ اور عمل کے درمیان فرق کو ختم کرنے میں مدد ملتی ہے۔ مثال کے طور پر، ڈیبگ کرتے وقت، آپ کو ڈیٹا کی غلط ترتیب یا ٹرانسمیشن میں تاخیر کا سامنا کرنا پڑ سکتا ہے۔ لاگنگ فنکشنز جیسے `print()` یا یہاں تک کہ ایک سادہ LED رسپانس ٹیسٹ بنانے سے اس بات کی تصدیق ہو سکتی ہے کہ آپ کے پے لوڈز درست طریقے سے فارمیٹ کیے گئے ہیں اور ڈرون کے ذریعے موصول ہوئے ہیں۔ وقت گزرنے کے ساتھ، آپ اسکرپٹ تیار کریں گے جو نہ صرف کمانڈز بھیجتے ہیں بلکہ غلطیوں کو خوش اسلوبی سے ہینڈل بھی کرتے ہیں، اور ایک ہموار پرواز کے تجربے کو یقینی بناتے ہیں۔ 🚀