इस प्रोजेक्ट के बारे में

यह रिपॉज़िटरी एक फ्लाइट कंट्रोल फुल-स्टैक मल्टी-रिपॉज़िटरी शेल प्रोजेक्ट (Umbrella) है, जो git submodule के माध्यम से 9 स्वतंत्र सब-रिपॉज़िटरी को शामिल करती है, और समग्र आर्किटेक्चर, इंजीनियरिंग विवरण और इंटीग्रेशन विधियों का केंद्रीकृत प्रबंधन करती है। सब-रिपॉज़िटरी स्वतंत्र रूप से विकसित होती हैं, शेल प्रोजेक्ट केवल वर्शन स्नैपशॉट और दस्तावेज़ रिकॉर्ड करता है। प्रोजेक्ट संरचना में शामिल हैं: - flyctrl/: फ्लाइट कंट्रोल फर्मवेयर (Rust no_std, EKF, PID, फ्लाइट मोड, FDIR, MAVLink अपलिंक सहित) - fly-simulater/: भौतिक सिमुलेशन प्लेटफ़ॉर्म (fly-sim-core, plant, controller, sensor, wind, SIL सहित) - mcu_simulater/: MCU निर्देश-स्तरीय सिमुलेटर (Unicorn STM32F407 + वर्चुअल पेरिफेरल I2C/UART/USB) - joc-base/: RTOS कर्नेल + बोर्ड-स्तर (STM32F407 minimal, फर्मवेयर ELF आधार, dev ब्रांच) - joc-rtos-app-sdk/: एप्लिकेशन SDK (Rust no_std, लॉग/डिवाइस/टास्क, 180B लॉग बफ़र) - mavlink-core/: MAVLink एनकोड/डिकोड (फ़्रेम/एनम/COMMAND_LONG) - physics/: भौतिक इंजन phy-sdk (fly-sim-core वैकल्पिक निर्भरता, SIL वास्तविक भौतिकी) - groundctrl/: ग्राउंड स्टेशन (Rust) - joc-drvtest-app/: ड्राइवर परीक्षण एप्लिकेशन (पेरिफेरल ड्राइवर डिबगिंग) त्वरित शुरुआत: 1. सबमॉड्यूल आरंभ करें: `git submodule update --init --recursive` 2. फर्मवेयर बिल्ड करें: `./scripts/build.sh real-sensors` या `./scripts/build.sh hil`, आउटपुट /tmp में 3. एक-क्लिक रिग्रेशन: `./scripts/verify.sh` 4. एक-क्लिक इंटीग्रेशन: `./scripts/integrate.sh` (सभी) या विशिष्ट चरण जैसे `unlock`, `firmware` आदि सबमॉड्यूल URL सभी SSH रूप में हैं, क्रॉस-मशीन पुल के लिए SSH key अनुमति आवश्यक। यदि file transport त्रुटि हो, तो `git -c protocol.file.allow=always submodule update --init --recursive` का उपयोग करें। इंटीग्रेशन आउटपुट पथ सम्मेलन: पहले पर्यावरण चर (जैसे JOC_BASE_ELF, JOC_APP_FLYCTRL आदि) का उपयोग करें, फिर शेल प्रोजेक्ट मानक लेआउट (जैसे joc-base/build_hil/stm32f407_minimal.elf), अंत में ऐतिहासिक पथ। नई मशीन प्रक्रिया: सबमॉड्यूल आरंभ करें → फर्मवेयर बिल्ड करें → सभी इंटीग्रेशन चलाएं। वर्शन स्नैपशॉट शेल प्रोजेक्ट द्वारा लॉक किए जाते हैं, सबमॉड्यूल commit `git submodule status` से देखें, आगे बढ़ने पर शेल प्रोजेक्ट में नया स्नैपशॉट रिकॉर्ड करें, पुनरुत्पादन सुनिश्चित करें। दस्तावेज़ नेविगेशन: - docs/architecture.md: समग्र आर्किटेक्चर (तीन-स्तरीय सिमुलेशन स्टैक/डेटा फ़्लो/जिम्मेदारियां) - docs/engineering.md: प्रत्येक प्रोजेक्ट की कार्यक्षमता का विस्तृत विवरण - docs/integration.md: इंटीग्रेशन विधियां (वर्चुअल पेरिफेरल/SIL/HIL/फॉल्ट इंजेक्शन/अनलॉक फ्लाइट) - docs/postmortem-rtos-pendsv-fallback.md: PendSV खाली कतार फ़ॉलबैक दोष सुधार पोस्टमॉर्टम - scripts/integrate.sh: एक-क्लिक इंटीग्रेशन स्क्रिप्ट - scripts/verify.sh: एक-क्लिक रिग्रेशन स्क्रिप्ट