مرجع config.txt
ملف config.txt هو ملف تهيئة نصي عادي مخزَّن على بطاقة SD الخاصة بـFGA Logger. يتيح لك تطبيق معاملات معايرة المستشعر وضبط إعدادات التشغيل دون إعادة تحميل البرنامج الثابت.
يتم تحميل التهيئة مرة واحدة عند الإقلاع عند تشغيل الجهاز مع الضغط على زر متعدد الوظائف.
تهيئة config.txt تتطلب إصدار البرنامج الثابت v1.0.4 أو أحدث. معدل الإخراج القابل للتهيئة يتطلب v1.0.5 أو أحدث.
موقع الملف
ضع config.txt في الدليل الجذر لبطاقة SD المُهيَّأة بصيغة FAT32.
تنسيق الملف
- معامل واحد في كل سطر
- التنسيق:
PARAMETER=value - لا مسافات حول علامة
= - السطور التي تبدأ بـ
#تُعامل كتعليقات ويتم تجاهلها - المعاملات حساسة لحالة الأحرف
مثال:
# FGA Logger configuration
S1_X_OFFSET=128.5
S1_X_GAIN=1.0
S1_Y_OFFSET=-45.0
S1_Y_GAIN=1.0
S1_Z_OFFSET=0
S1_Z_GAIN=1.0
مرجع المعاملات
معايرة المستشعر 1
| المعامل | النوع | الافتراضي | الوصف |
|---|---|---|---|
S1_X_OFFSET | عائم | 0 | تصحيح إزاحة محور X للمستشعر 1 (nT) |
S1_Y_OFFSET | عائم | 0 | تصحيح إزاحة محور Y للمستشعر 1 (nT) |
S1_Z_OFFSET | عائم | 0 | تصحيح إزاحة محور Z للمستشعر 1 (nT) |
S1_X_GAIN | عائم | 1.0 | مضاعف كسب محور X للمستشعر 1 |
S1_Y_GAIN | عائم | 1.0 | مضاعف كسب محور Y للمستشعر 1 |
S1_Z_GAIN | عائم | 1.0 | مضاعف كسب محور Z للمستشعر 1 |
معايرة المستشعر 2
| المعامل | النوع | الافتراضي | الوصف |
|---|---|---|---|
S2_X_OFFSET | عائم | 0 | تصحيح إزاحة محور X للمستشعر 2 (nT) |
S2_Y_OFFSET | عائم | 0 | تصحيح إزاحة محور Y للمستشعر 2 (nT) |
S2_Z_OFFSET | عائم | 0 | تصحيح إزاحة محور Z للمستشعر 2 (nT) |
S2_X_GAIN | عائم | 1.0 | مضاعف كسب محور X للمستشعر 2 |
S2_Y_GAIN | عائم | 1.0 | مضاعف كسب محور Y للمستشعر 2 |
S2_Z_GAIN | عائم | 1.0 | مضاعف كسب محور Z للمستشعر 2 |
تنطبق معاملات المستشعر 2 فقط عند توصيل مستشعر ثانٍ بمدخل B2.
كيفية تطبيق المعايرة
يطبّق البرنامج الثابت المعايرة على قيمة كل محور باستخدام:
corrected = (raw_value - OFFSET) * GAIN
مثلاً، للمحور X للمستشعر 1:
B1x_corrected = (B1x_raw - S1_X_OFFSET) * S1_X_GAIN
يتم تطبيق هذا قبل كتابة القيمة في CSV أو بثّها عبر المنفذ التسلسلي.
تحميل التهيئة
- اكتب
config.txtفي جذر بطاقة SD - أدخل بطاقة SD في FGA Logger
- اضغط باستمرار على زر متعدد الوظائف وشغّل الجهاز
- ستضيء مؤشرات LED وتنطفئ بالتتالي للتأكيد بأن الملف قد قُرئ
- اتصل عبر USB التسلسلي للتحقق — ستُخرج وحدة التحكم قيم المعاملات المحمَّلة:
Config: reading from SD card
config.txt found.
Input 1: Offset(x,y,z): 128.5, -45.0, 0.0
Gain(x,y,z): 1.00000000, 1.00000000, 1.00000000
معاملات المعايرة مخزَّنة بشكل دائم داخل المسجّل. لا تحتاج إلى إبقاء config.txt على بطاقة SD بعد التحميل — تبقى القيم محفوظة عبر دورات الطاقة وتحديثات البرنامج الثابت.
مثال كامل config.txt
# FGA Logger configuration file
# Requires firmware v1.0.4 or later
# --- Sensor 1 calibration ---
S1_X_OFFSET=128.5
S1_X_GAIN=1.0
S1_Y_OFFSET=-45.0
S1_Y_GAIN=1.0
S1_Z_OFFSET=22.0
S1_Z_GAIN=1.0
# --- Sensor 2 calibration (if connected) ---
S2_X_OFFSET=40
S2_X_GAIN=1.0
S2_Y_OFFSET=50
S2_Y_GAIN=1.0
S2_Z_OFFSET=60
S2_Z_GAIN=1.0
استكشاف الأخطاء وإصلاحها
المعاملات لا تُحمَّل
- تحقق من تسمية الملف بالضبط
config.txt(بأحرف صغيرة) في جذر بطاقة SD - تأكد من تهيئة بطاقة SD بصيغة FAT32
- تأكد من الضغط على زر متعدد الوظائف قبل التشغيل — الإفراج عنه مبكراً سيتجاوز تحميل التهيئة
- تحقق من إخراج وحدة التحكم التسلسلية لرؤية القيم المحمَّلة
قيم قياس غير متوقعة بعد التحميل
- أعد ضبط المعايرة بتعيين جميع قيم OFFSET إلى
0وجميع قيم GAIN إلى1.0، وأعد تحميل التهيئة - إذا استمرت المشكلة، أعد تحميل البرنامج الثابت وأعد التحميل
الصفحات ذات الصلة
- إجراء المعايرة — دليل خطوة بخطوة لقياس وحساب قيم الإزاحة
- تحديثات البرنامج الثابت — إصدارات البرنامج الثابت التي قدّمت دعم config.txt