تحديد

• اسم المنتج: مسجل بيانات OpenLog
• الموديل: DEV-13712
• مدخل الطاقة: 3.3 فولت - 12 فولت (الموصى به 3.3 فولت - 5 فولت)
• حجم إدخال RXItagه: 2.0 فولت -3.8 فولت
• حجم خرج TXOtagه: 3.3 فولت
• استهلاك التيار الخامل: ~2 مللي أمبير - 5 مللي أمبير (بدون بطاقة microSD)، ~5 مللي أمبير - 6 مللي أمبير (مع بطاقة microSD)
• استهلاك التيار للكتابة النشطة: ~20-23 مللي أمبير (مع بطاقة microSD)

تعليمات استخدام المنتج

المواد المطلوبة:

• اردوينو برو ميني 328 – 3.3 فولت/8 ميجا هرتز
• لوحة توزيع FTDI الأساسية من SparkFun – 3.3 فولت
• كابل USB من SparkFun Cerberus – بطول 6 أقدام
• بطاقة microSD مع محول - 16 جيجابايت (الفئة 10)
• قارئ USB microSD
• رؤوس الإناث
• أسلاك توصيل ممتازة، عبوة من 6 قطع، مكونة من 10 قطع
• ضربة رأسية سريعة للرجال - زاوية قائمة

القراءة الموصى بها:

• كيفية اللحام: اللحام عبر الفتحة
• أساسيات الاتصالات التسلسلية
• واجهة الطرفية التسلسلية (SPI)
• أساسيات المحطة التسلسلية

الأجهزة انتهتview:
يتم تشغيل OpenLog بالإعدادات التالية:

مقدمة

تنبيه! هذا البرنامج التعليمي مخصص لسجل الفتح لـ UART التسلسلي [DEV-13712]. إذا كنت تستخدم Qwiic OpenLog لـ IC [DEV-15164]، يُرجى مراجعة دليل توصيل Qwiic OpenLog.

مسجل بيانات OpenLog هو حل سهل الاستخدام ومفتوح المصدر لتسجيل البيانات التسلسلية من مشاريعك. يوفر OpenLog واجهة تسلسلية بسيطة لتسجيل البيانات من مشروع إلى بطاقة microSD.

سبارك فن أوبن لوج
ديف-13712

SparkFun OpenLog مع الرؤوس
ديف-13955

لم يتم العثور على المنتج

المواد المطلوبة
لإكمال هذا البرنامج التعليمي، ستحتاج إلى الأجزاء التالية. قد لا تحتاج إليها كلها، وذلك حسب ما لديك. أضفها إلى سلة التسوق، واقرأ الدليل، وعدّلها حسب الحاجة.

دليل ربط OpenLog

قائمة أمنيات سبارك فن

قراءة موصى بها
إذا لم تكن على دراية بالمفاهيم التالية أو تشعر بالراحة تجاهها، فنوصيك بقراءتها قبل الاستمرار في دليل OpenLog Hookup.

• كيفية اللحام: لحام الثقوب. يغطي هذا البرنامج التعليمي كل ما تحتاج لمعرفته حول لحام الثقوب.
• الاتصالات التسلسلية مفاهيم الاتصالات التسلسلية غير المتزامنة: الحزم، ومستويات الإشارة، ومعدلات الباود، وUART، والمزيد!
• واجهة الطرفية التسلسلية (SPI) يتم استخدام SPI بشكل شائع لتوصيل المتحكمات الدقيقة بالأجهزة الطرفية مثل أجهزة الاستشعار، وسجلات التحويل، وبطاقات SD.
• أساسيات المحطة التسلسلية سيوضح لك هذا البرنامج التعليمي كيفية التواصل مع أجهزتك التسلسلية باستخدام مجموعة متنوعة من تطبيقات محاكي المحطة الطرفية.

الأجهزة انتهتview

قوة
يتم تشغيل OpenLog بالإعدادات التالية:

تصنيفات الطاقة OpenLog

يتراوح استهلاك التيار في OpenLog بين 20 و23 مللي أمبير تقريبًا عند الكتابة على بطاقة microSD. ويختلف استهلاك التيار النشط عند الكتابة على بطاقة الذاكرة، حسب حجمها والشركة المصنعة لها. كما أن زيادة معدل الباود ستؤدي إلى زيادة استهلاك التيار.

متحكم
يعمل OpenLog على وحدة ATmega328 مدمجة، تعمل بتردد 16 ميجاهرتز، بفضل البلورة المدمجة. تحتوي وحدة ATmega328 على مُحمّل الإقلاع Optiboot، مما يسمح لـ OpenLog بالتوافق مع
إعدادات لوحة “Arduino Uno” في Arduino IDE.

الواجهة

UART التسلسلي
الواجهة الرئيسية لـ OpenLog هي موصل FTDI على حافة اللوحة. صُمم هذا الموصل للتوصيل مباشرةً بلوحة Arduino Pro أو Pro Mini، مما يسمح للمتحكم الدقيق بإرسال البيانات عبر اتصال تسلسلي إلى OpenLog.

تحذير! نظرًا لترتيب الدبابيس الذي يجعله متوافقًا مع Arduinos، فإنه لا يمكن توصيله مباشرة بلوحة توصيل FTDI.

لمزيد من المعلومات، تأكد من مراجعة القسم التالي حول توصيل الأجهزة.

إس بي آي

توجد أيضًا أربع نقاط اختبار SPI مُفصلة على الطرف الآخر من اللوحة. يمكنك استخدامها لإعادة برمجة مُحمّل الإقلاع على ATmega328.

• أحدث إصدار من OpenLog (DEV-13712) يُثبّت هذه الدبابيس على فتحات صفائحية أصغر. إذا كنت بحاجة إلى استخدام مزود خدمة إنترنت لإعادة برمجة أو تحميل مُحمّل إقلاع جديد إلى OpenLog، يمكنك استخدام دبابيس Pogo للاتصال بنقاط الاختبار هذه.
• الواجهة النهائية للتواصل مع OpenLog هي بطاقة microSD نفسها. للتواصل، تحتاج بطاقة microSD إلى دبابيس SPI. لا يقتصر الأمر على تخزين البيانات في OpenLog، بل يمكنك أيضًا تحديث إعدادات OpenLog عبر ملف config.txt. file على بطاقة microSD.
  بطاقة مايكرو التنمية المستدامة

تُخزَّن جميع البيانات المُسجَّلة بواسطة OpenLog على بطاقة microSD. يعمل OpenLog مع بطاقات microSD التي تحتوي على الميزات التالية:

• 64 ميجابايت إلى 32 جيجابايت
• FAT16 أو FAT32

يوجد مصباحان LED للحالة على OpenLog لمساعدتك في استكشاف الأخطاء وإصلاحها.

• STAT1 - هذا المؤشر LED الأزرق مُثبَّت على لوحة Arduino D5 (ATmega328 PD5)، ويُشغَّل ويُطفأ عند استقبال حرف جديد. يومض هذا المؤشر عند عمل الاتصال التسلسلي.
• STAT2 - هذا الصمام الثنائي الأخضر متصل بلوحة Arduino D13 (خط الساعة التسلسلي SPI/ ATmega328 PB5). يومض هذا الصمام فقط عند تفعيل واجهة SPI. ستلاحظ وميضه عند تسجيل OpenLog 512 بايت على بطاقة microSD.

توصيل الأجهزة

هناك طريقتان رئيسيتان لتوصيل جهاز OpenLog بدائرة كهربائية. ستحتاج إلى بعض الموصلات أو الأسلاك للتوصيل. تأكد من لحامها باللوحة لضمان اتصال آمن.

الاتصال التسلسلي الأساسي

نصيحة:إذا كان لديك موصل أنثى على OpenLog وموصل أنثى على FTDI، فستحتاج إلى أسلاك توصيل M/F للتوصيل.

تم تصميم اتصال الأجهزة هذا للتفاعل مع OpenLog إذا كنت بحاجة إلى إعادة برمجة اللوحة أو تسجيل البيانات عبر اتصال تسلسلي أساسي.

قم بإجراء الاتصالات التالية:
OpenLog → 3.3V FTDI Breakout الأساسي

• أرضي → أرضي
• أرضي → أرضي
• VCC → 3.3 فولت
• TXO → RXI
• RXI → TXO
• DTR → DTR

لاحظ أنه ليس هناك اتصال مباشر بين FTDI وOpenLog - يجب عليك تبديل اتصالات دبوس TXO وRXI.

يجب أن تبدو اتصالاتك كما يلي:

بعد توصيل OpenLog وFTDI Basic، وصّل لوحة FTDI بكابل USB والكمبيوتر. افتح منفذ تسلسلي، وصّل بمنفذ COM في FTDI Basic، وابدأ العمل!

اتصال أجهزة المشروع

نصيحة: إذا كان لديك موصلات أنثى ملحومة على OpenLog، فيمكنك لحام موصلات ذكرية إلى Arduino Pro Mini لتوصيل اللوحات معًا دون الحاجة إلى أسلاك.

مع أن ربط OpenLog عبر اتصال تسلسلي أمرٌ مهم لإعادة البرمجة أو تصحيح الأخطاء، إلا أن ميزة OpenLog تكمن في المشاريع المُدمجة. هذه الدائرة العامة هي الطريقة التي نوصي بها لتوصيل OpenLog بوحدة تحكم دقيقة (في هذه الحالة، Arduino Pro Mini) والتي ستكتب البيانات التسلسلية إلى OpenLog.

أولاً، ستحتاج إلى تحميل الكود إلى جهاز Pro Mini الذي تنوي تشغيله. يُرجى الاطلاع على رسومات Arduino لبعض الأمثلة.ampالكود الذي يمكنك استخدامه.

ملحوظة: إذا لم تكن متأكدًا من كيفية برمجة جهاز Pro Mini، فيرجى مراجعة البرنامج التعليمي الخاص بنا هنا.

استخدام Arduino Pro Mini 3.3V

• هذا البرنامج التعليمي هو دليلك لكل ما يتعلق بـ Arduino Pro Mini. يشرح ما هو Arduino Pro Mini، وما لا هو، وكيفية البدء في استخدامه.
• بعد برمجة جهاز Pro Mini، يمكنك إزالة لوحة FTDI واستبدالها بلوحة OpenLog. تأكد من توصيل الدبابيس الموسومة بـ BLK في كلٍّ من Pro Mini وOpenLog (ستتطابق الدبابيس الموسومة بـ GRN في كليهما إذا تم ذلك بشكل صحيح).
• إذا لم تتمكن من توصيل OpenLog مباشرة بجهاز Pro Mini (بسبب عدم تطابق الرؤوس أو اللوحات الأخرى في الطريق)، فيمكنك استخدام أسلاك التوصيل وإجراء التوصيلات التالية.

OpenLog → اردوينو برو/اردوينو برو ميني

• أرضي → أرضي
• أرضي → أرضي
• VCC → VCC
• TXO → RXI
• RXI → TXO
• DTR → DTR

بعد الانتهاء، يجب أن تبدو توصيلاتك كما يلي مع Arduino Pro Mini وArduino Pro. يُظهر مخطط Fritzing سجلات OpenLogs مع انعكاس الرؤوس. إذا قلبت مقبس microSD بالنسبة إلى الجزء العلوي من Arduino، view، يجب أن تتطابق مع رأس البرمجة مثل FTDI.

لاحظ أن الاتصال عبارة عن لقطة مباشرة مع OpenLog "رأسًا على عقب" (مع توجيه بطاقة microSD لأعلى).

ملحوظة: بما أن موصلات Vcc وGND بين OpenLog وArduino مشغولة بالرؤوس، ستحتاج إلى توصيل الطاقة بباقي دبابيس Arduino. وإلا، يمكنك لحام الأسلاك بدبابيس الطاقة المكشوفة على أيٍّ من اللوحتين.

قم بتشغيل نظامك، وستكون جاهزًا لبدء التسجيل!

رسومات أردوينو

هناك ستة أنواع مختلفة منampتتضمن الرسومات المضمنة التي يمكنك استخدامها على Arduino عند الاتصال بـ OpenLog.

• OpenLog_Benchmarking — هذا المثالampيُستخدم le لاختبار OpenLog. يُرسل هذا كميات هائلة من البيانات بسرعة 115200 بت في الثانية عبر عدة files.
• OpenLog_CommandTest — هذا المثالampيوضح هذا كيفية إنشاء ملف وإضافته file من خلال التحكم عبر سطر الأوامر من خلال Arduino.
• OpenLog_ReadExampلي - هذا السابقampيوضح هذا المقال كيفية التحكم في OpenLog عبر سطر الأوامر.
• OpenLog_ReadExample_LargeFile - السابقampكيفية فتح مخزن كبير file على OpenLog والإبلاغ عنه عبر اتصال Bluetooth محلي.
• OpenLog_Test_Sketch — يستخدم لاختبار OpenLog باستخدام قدر كبير من البيانات التسلسلية.
• OpenLog_Test_Sketch_Binary — يستخدم لاختبار OpenLog باستخدام البيانات الثنائية وأحرف الإفلات.

البرامج الثابتة

يحتوي OpenLog على قطعتين رئيسيتين من البرامج على متن الطائرة: أداة تحميل التشغيل والبرامج الثابتة.

أداة تحميل التشغيل Arduino

ملحوظة: إذا كنت تستخدم OpenLog الذي تم شراؤه قبل مارس 2012، فإن أداة تحميل التشغيل المدمجة متوافقة مع الإعداد "Arduino Pro أو Pro Mini 5V/16MHz w/ ATmega328" في Arduino IDE.

• كما ذُكر سابقًا، يحتوي OpenLog على مُحمِّل إقلاع تسلسلي Optiboot. يمكنك التعامل مع OpenLog تمامًا مثل Arduino Uno عند تحميل البيانات.ampقم بتنزيل الكود أو البرامج الثابتة الجديدة على اللوحة.
• إذا تعطل OpenLog لديك واحتجت إلى إعادة تثبيت مُحمِّل الإقلاع، فستحتاج أيضًا إلى تحميل Optiboot على اللوحة. لمزيد من المعلومات، يُرجى الاطلاع على برنامجنا التعليمي حول تثبيت مُحمِّل إقلاع Arduino.

تجميع البرامج الثابتة وتحميلها على OpenLog

ملحوظة: إذا كانت هذه هي المرة الأولى التي تستخدم فيها Arduino، فيرجى إعادةview دليلنا التعليمي لتثبيت بيئة التطوير المتكاملة لـ Arduino. إذا لم تقم بتثبيت مكتبة Arduino مسبقًا، يُرجى مراجعة دليل التثبيت لتثبيت المكتبات يدويًا.

• إذا كنت بحاجة، لأي سبب من الأسباب، إلى تحديث أو إعادة تثبيت البرامج الثابتة على OpenLog، فإن العملية التالية ستساعدك على تشغيل اللوحة الخاصة بك.
• أولاً، يُرجى تنزيل برنامج Arduino IDE الإصدار 1.6.5. قد تعمل إصدارات أخرى من البرنامج على تجميع برنامج OpenLog الثابت، ولكننا تأكدنا من أن هذا الإصدار يعمل بكفاءة.
• بعد ذلك، قم بتنزيل البرنامج الثابت OpenLog وحزمة المكتبات المطلوبة.

تنزيل حزمة برامج OPENLOG الثابتة (ملف مضغوط)

• بعد تنزيل المكتبات والبرامج الثابتة، ثبّتها في أردوينو. إذا لم تكن متأكدًا من كيفية تثبيت المكتبات يدويًا في بيئة التطوير المتكاملة، يُرجى الاطلاع على درسنا التعليمي: تثبيت مكتبة أردوينو: تثبيت مكتبة يدويًا.

ملحوظة:

• نستخدم إصدارات مُعدّلة من مكتبتي SdFat وSerialPort لتحديد حجم مخزني الإرسال والاستقبال بشكل عشوائي. يتطلب OpenLog أن يكون مخزن الإرسال صغيرًا جدًا (0)، ويجب أن يكون مخزن الاستقبال كبيرًا قدر الإمكان.
• يسمح استخدام هاتين المكتبتين المعدلتين معًا بتعزيز أداء OpenLog.

هل تبحث عن أحدث الإصدارات؟
إذا كنت تفضل أحدث إصدارات المكتبات والبرامج الثابتة، يمكنك تنزيلها مباشرةً من مستودعات GitHub المرفقة أدناه. مكتبتا SdFatLib وSerial Port غير مرئيتين في مدير لوحة Arduino، لذا ستحتاج إلى تثبيت المكتبة يدويًا.

• جيثب: OpenLog > البرامج الثابتة > OpenLog_Firmware
• مكتبات أردوينو الخاصة ببيل جريمان
  • SdFatLib-beta
  • المنفذ التسلسلي
• بعد ذلك، للاستفادةtagمن المكتبات المعدلة، قم بتعديل SerialPort.hh file موجود في مجلد \Arduino\Libraries\SerialPort. غيّر BUFFERED_TX إلى 0 وENABLE_RX_ERROR_CHECKING إلى 0. احفظ file، وافتح Arduino IDE.
• إذا لم تقم بذلك بعد، فقم بتوصيل OpenLog بالكمبيوتر عبر لوحة FTDI. يُرجى التحقق جيدًا من المنفذ.ampالدائرة إذا لم تكن متأكدًا من كيفية القيام بذلك بشكل صحيح.
• افتح رسم OpenLog الذي ترغب في تحميله ضمن قائمة الأدوات>اللوحة، وحدد "Arduino/Genuino Uno"، وحدد منفذ COM المناسب للوحة FTDI الخاصة بك ضمن الأدوات>المنفذ.
• قم بتحميل الكود.
• هذا كل شيء! تم الآن برمجة OpenLog الخاص بك ببرنامج ثابت جديد. يمكنك الآن فتح شاشة تسلسلية والتفاعل مع OpenLog. عند التشغيل، سترى إما 12> أو 12<. يشير 1 إلى إنشاء الاتصال التسلسلي، ويشير 2 إلى تهيئة بطاقة SD بنجاح، ويشير < إلى أن OpenLog جاهز لتسجيل أي بيانات تسلسلية مستلمة، ويشير > إلى أن OpenLog جاهز لاستقبال الأوامر.

رسومات البرامج الثابتة OpenLog
هناك ثلاثة رسومات مضمنة يمكنك استخدامها في OpenLog، اعتمادًا على تطبيقك المحدد.

• OpenLog - يتم تثبيت هذا البرنامج الثابت افتراضيًا على OpenLog. سيؤدي إرسال الأمر ? إلى عرض إصدار البرنامج الثابت المُحمّل على الجهاز.
• OpenLog_Light - يُلغي هذا الإصدار من المخطط وضع القائمة والأوامر، مما يسمح بزيادة سعة التخزين المؤقت للاستقبال. يُعد هذا خيارًا جيدًا للتسجيل عالي السرعة.
• OpenLog_Minimal - يجب ضبط معدل الباود في الكود وتحميله. يُنصح بهذا المخطط للمستخدمين ذوي الخبرة، وهو أيضًا الخيار الأمثل لتسجيل البيانات بأعلى سرعة.

مجموعة الأوامر

يمكنك التواصل مع OpenLog عبر محطة طرفية تسلسلية. ستساعدك الأوامر التالية على القراءة والكتابة والحذف. files، بالإضافة إلى تغيير إعدادات OpenLog. ستحتاج إلى استخدام وضع الأوامر لاستخدام الإعدادات التالية.

أثناء وجود OpenLog في وضع الأوامر، سيتم تشغيل/إيقاف STAT1 لكل حرف مُستقبَل. سيبقى مؤشر LED مضاءً حتى يتم استقبال الحرف التالي.

• جديد File - إنشاء جديد file اسمه File في الدليل الحالي. المعيار 8.3 fileالأسماء مدعومة. على سبيل المثالampعلى سبيل المثال، "87654321.123" مقبول، في حين أن "987654321.123" غير مقبول.
  • Example: جديد file1.txt
• إضافة File - إضافة نص إلى نهاية File. ثم تتم قراءة البيانات التسلسلية من UART في مجرى وإضافتها إلى fileلا يتم صداها عبر الطرفية التسلسلية. إذا File لا يوجد عند استدعاء هذه الوظيفة، file سيتم إنشاء.
  • Example: إضافة جديدfile.csv
• يكتب File الإزاحة - كتابة النص إلى File من موقع OFFSET داخل fileيُقرأ النص من وحدة UART سطرًا بسطر، ثم يُعاد صداه. للخروج من هذه الحالة، أرسل سطرًا فارغًا.
  • Example: كتابة logs.txt 516
• rm File - يحذف File من الدليل الحالي. يتم دعم الأحرف البدل.
  • Example: rm README.txt
• مقاس File - حجم الإخراج File بالبايتات.
  • Example: حجم Log112.csv
  • الناتج: 11
• يقرأ File + START+ LENGTH TYPE – إخراج محتوى File بدءًا من البداية والمضي قدمًا نحو الطول. إذا تم حذف البداية، فسيتم حذف الطول بالكامل file يتم الإبلاغ. إذا تم حذف LENGTH، فسيتم الإبلاغ عن كامل المحتوى من نقطة البداية. إذا تم حذف TYPE، فسيتم إعداد OpenLog افتراضيًا للإبلاغ بتنسيق ASCII. هناك ثلاثة أنواع إخراج:
  • ASCII = 1
  • سداسي عشري = 2
  • خام = 3
• يمكنك حذف بعض الحجج اللاحقة. تحقق من المثال التاليampليز.
• القراءة الأساسية + العلامات المحذوفة:
  • Example: قراءة LOG00004.txt
  • الإخراج: مقياس التسارع X=12 Y=215 Z=317
• اقرأ من البداية 0 بطول 5:
  • Example: قراءة LOG00004.txt 0 5
  • الإخراج: التسارع
• اقرأ من الموضع 1 بطول 5 في HEX:
  • Example: قراءة LOG00004.txt 1 5 2
  • الإخراج: 63 63 65 6C
• القراءة من الموضع 0 بطول 50 في RAW:
  • Example: قراءة LOG00137.txt 0 50 3
  • الإخراج: اختبار الشخصية الموسعة André– -þ
• قطة File - اكتب محتوى file في سداسي عشري إلى الشاشة التسلسلية لـ viewمن المفيد أحيانًا أن نرى أن file يتم التسجيل بشكل صحيح دون الحاجة إلى سحب بطاقة SD و view ال file على جهاز كمبيوتر.
  • Exampالملف: cat LOG00004.txt
  • الإخراج: 00000000: 41 63 65 6c 3a 20 31

التلاعب بالدليل

• ls – يعرض جميع محتويات الدليل الحالي. يدعم استخدام الأحرف البدل.
  • Example:ls
  • الإخراج: \src
• الدليل الفرعي md – إنشاء دليل فرعي في الدليل الحالي.
  • Example:md Example_Sketches
• الدليل الفرعي cd – التغيير إلى الدليل الفرعي.
  • Example: cd Hello_World
• cd .. – الانتقال إلى مجلد أدنى في الشجرة. لاحظ وجود مسافة بين 'cd' و'..'. هذا يسمح لمحلل السلسلة برؤية أمر CD.
  • Exampليه: سي دي ..
• مجلد فرعي rm - يحذف المجلد الفرعي. يجب أن يكون المجلد فارغًا ليعمل هذا الأمر.
  • Example: rm temps
• rm -rf Directory – يحذف الدليل وأي fileالموجود بداخله.
  • Example: rm -rf المكتبات

أوامر الوظائف منخفضة المستوى

• ؟ – سيؤدي هذا الأمر إلى إظهار قائمة بالأوامر المتوفرة على OpenLog.
• القرص - عرض رقم مُصنِّع البطاقة، والرقم التسلسلي، وتاريخ التصنيع، وحجم البطاقة. مثال:ampالناتج هو:
  • نوع البطاقة: SD2 معرف الشركة المصنعة: 3
  • معرف الشركة المصنعة للمعدات الأصلية: SD
  • المنتج: SU01G
  • الإصدار: 8.0
  • الرقم التسلسلي: 39723042 تاريخ التصنيع: 1/2010 حجم البطاقة: 965120 كيلوبايت
• init - إعادة تهيئة النظام وإعادة فتح بطاقة SD. هذا مفيد إذا توقفت بطاقة SD عن الاستجابة.
• مزامنة - يُزامن محتوى المخزن المؤقت الحالي مع بطاقة SD. هذا الأمر مفيد إذا كان لديك أقل من 512 حرفًا في المخزن المؤقت وتريد تسجيلها على بطاقة SD.
• إعادة الضبط - ينقل OpenLog إلى الموقع صفر، ويعيد تشغيل أداة تحميل التشغيل، ثم كود التهيئة. هذا الأمر مفيد إذا كنت بحاجة إلى تعديل ملف التكوين. fileأعد ضبط OpenLog، وابدأ باستخدام التكوين الجديد. لا تزال إعادة ضبط الطاقة هي الطريقة المفضلة لإعادة ضبط اللوحة، ولكن هذا الخيار متاح.

إعدادات النظام

يمكن تحديث هذه الإعدادات يدويًا أو تحريرها في ملف config.txt file.

• حالة الصدى - تُغيّر حالة النظام، وتُخزّن في ذاكرة النظام. يمكن تفعيل الحالة أو إيقافها. أثناء تفعيلها، يُرسِل OpenLog صدىً للبيانات التسلسلية المُستلَمة على موجه الأوامر. أثناء إيقافها، لا يُعيد النظام قراءة الأحرف المُستلَمة.

ملحوظة: أثناء التسجيل العادي، سيتم إيقاف الصدى. متطلبات موارد النظام اللازمة لصدى البيانات المستلمة مرتفعة جدًا أثناء التسجيل.

• حالة الإسهاب - تُغيّر حالة الإبلاغ عن الأخطاء الإسهاب. يمكن تفعيل أو إيقاف هذه الحالة. يُخزّن هذا الأمر في الذاكرة. بتعطيل أخطاء الإسهاب، سيستجيب OpenLog بعلامة "!" فقط في حال وجود خطأ، بدلاً من أمر غير معروف: C OMMAND.D..T. يُسهّل تحليل الأحرف على الأنظمة المضمنة تحليل الخطأ الكامل. إذا كنت تستخدم محطة طرفية، فإن تفعيل الإسهاب سيسمح لك برؤية رسائل الخطأ كاملةً.
• معدل البود - يفتح هذا الأمر قائمة نظام تتيح للمستخدم إدخال معدل بود. أي معدل بود مدعوم بين 300 بت في الثانية و1 ميجابت في الثانية. يتم اختيار معدل البود فورًا، ويتطلب OpenLog دورة تشغيل لتفعيل الإعدادات. يُخزَّن معدل البود في ذاكرة EEPROM ويُحمَّل في كل مرة يُشغَّل فيها OpenLog. القيمة الافتراضية هي 9600 8N1.

يتذكر: إذا علقت اللوحة بمعدل بود غير معروف، يمكنك توصيل RX بالأرضي وتشغيل OpenLog. ستومض مصابيح LED ذهابًا وإيابًا لمدة ثانيتين، ثم ستومض بشكل متزامن. أوقف تشغيل OpenLog، ثم أزل وصلة التوصيل. ستتم الآن إعادة ضبط OpenLog إلى 2 بت في الثانية بالضغط على مفتاح الإفلات `CTRL-Z` ثلاث مرات متتالية. يمكن تجاوز هذه الميزة بضبط بت تجاوز الطوارئ على 9600. راجع ملف config.txt لمزيد من المعلومات.

• تعيين - يفتح هذا الأمر قائمة النظام لاختيار وضع الإقلاع. تُطبّق هذه الإعدادات عند التشغيل التالي، وتُخزّن في ذاكرة EEPROM غير المتطايرة.
  • جديد File التسجيل - يقوم هذا الوضع بإنشاء ملف جديد file في كل مرة يتم فيها تشغيل OpenLog، سيرسل OpenLog 1 (UART قيد التشغيل)، 2 (بطاقة SD مُهيأة)، ثم < (OpenLog جاهز لاستقبال البيانات). سيتم تسجيل جميع البيانات في ملف LOG#####.txt. يزداد الرقم ##### في كل مرة يتم فيها تشغيل OpenLog (الحد الأقصى هو 65533 سجلًا). يُخزَّن الرقم في ذاكرة EEPROM ويمكن إعادة ضبطه من قائمة الإعدادات. لا يتم تكرار جميع الأحرف المُستقبَلة. يمكنك الخروج من هذا الوضع والدخول إلى وضع الأوامر بالضغط على CTRL+z (ASCII 26). سيتم تخزين جميع البيانات المخزنة مؤقتًا.
• ملحوظة: إذا تم إنشاء عدد كبير جدًا من السجلات، فسيُخرج OpenLog الخطأ **عدد كبير جدًا من السجلات**، ويخرج من هذا الوضع، وينتقل إلى موجه الأوامر. سيبدو الناتج التسلسلي كالتالي: `12!عدد كبير جدًا من السجلات!
  • إضافة File التسجيل - يُعرف أيضًا باسم الوضع المتسلسل، حيث ينشئ هذا الوضع file يُطلق عليه اسم SEQLOG.txt إذا لم يكن موجودًا بالفعل، ويضيف أي بيانات مستلمة إلى fileسيرسل OpenLog ١٢<، وعندها يكون جاهزًا لاستقبال البيانات. لا تُصدى الأحرف. يمكنك الخروج من هذا الوضع والدخول إلى وضع الأوامر بالضغط على CTRL+z (ASCII ٢٦). سيتم تخزين جميع البيانات المخزنة مؤقتًا.
  • موجه الأوامر - سيرسل OpenLog 12>، وعندها يكون النظام جاهزًا لاستقبال الأوامر. لاحظ أن علامة > تشير إلى أن OpenLog جاهز لاستقبال الأوامر، وليس البيانات. يمكنك إنشاء files وإضافة البيانات إلى files، ولكن هذا يتطلب بعض التحليل التسلسلي (للتحقق من الأخطاء)، لذلك لا نقوم بتعيين هذا الوضع بشكل افتراضي.
  • إعادة تعيين جديد File الرقم - سيؤدي هذا الوضع إلى إعادة تعيين السجل file الرقم إلى LOG000.txt. هذا مفيد إذا قمت مؤخرًا بمسح بطاقة microSD وتريد السجل file أرقام للبدء من جديد.
  • حرف هروب جديد - يتيح هذا الخيار للمستخدم إدخال حرف، مثل CTRL+z أو $، وتعيينه كحرف هروب جديد. يُعاد ضبط هذا الإعداد إلى CTRL+z أثناء إعادة الضبط الطارئة.
  • عدد أحرف التجاوز - يتيح هذا الخيار للمستخدم إدخال حرف (مثل ١، ٣، أو ١٧)، مما يُحدِّث العدد الجديد لأحرف التجاوز اللازمة للانتقال إلى وضع الأوامر. على سبيل المثالampعند إدخال الرقم 8، سيتطلب من المستخدم الضغط على CTRL+z ثماني مرات للوصول إلى وضع الأوامر. يُعاد ضبط هذا الإعداد إلى 3 أثناء إعادة الضبط الطارئة.
• شرح رموز الهروب: يتطلب OpenLog الضغط على CTRL+z ثلاث مرات للدخول إلى وضع الأوامر، وذلك لمنع إعادة ضبط اللوحة عن طريق الخطأ أثناء تحميل كود جديد من بيئة التطوير المتكاملة Arduino. هناك احتمال أن تظهر هذه الرموز أثناء عملية الإقلاع (وهي مشكلة لاحظناها في الإصدارات الأولى من برنامج OpenLog الثابت)، لذا يهدف هذا إلى منع ذلك. إذا شككت في أن لوحتك قد تعطلت بسبب هذا، يمكنك دائمًا إعادة ضبطها في حالات الطوارئ عن طريق تثبيت دبوس الاستقبال على الأرض أثناء التشغيل.

إعدادات File

إذا كنت تفضل عدم استخدام المحطة التسلسلية لتعديل الإعدادات على OpenLog، فيمكنك أيضًا تحديث الإعدادات عن طريق تعديل CONFIG.TXT file.

ملحوظة: تعمل هذه الميزة فقط على إصدار البرنامج الثابت 1.6 أو أحدث. إذا اشتريتَ جهاز OpenLog بعد عام 2012، فسيعمل إصدار البرنامج الثابت 1.6 أو أحدث.

• للقيام بذلك، ستحتاج إلى قارئ بطاقات microSD ومحرر نصوص. افتح ملف config.txt. file (كتابة الأحرف الكبيرة في file إذا لم تقم بتشغيل OpenLog باستخدام بطاقة SD من قبل، يمكنك أيضًا إنشاء fileإذا قمت بتشغيل OpenLog باستخدام بطاقة microSD المُدخلة مسبقًا، فيجب أن ترى شيئًا مثل التالي عند قراءة بطاقة microSD.يقوم OpenLog بإنشاء ملف config.txt وLOG0000.txt file عند تشغيل الطاقة لأول مرة.
• التكوين الافتراضي file يحتوي على سطر واحد من الإعدادات وسطر واحد من التعريفات.التكوين الافتراضي file تمت كتابته بواسطة OpenLog.
• لاحظ أن هذه هي الأحرف المرئية العادية (لا توجد قيم غير مرئية أو ثنائية)، ويتم فصل كل قيمة بفاصلة.

يتم تعريف الإعدادات على النحو التالي:

• معدل البود: معدل بود الاتصال. 9600 بت في الثانية هو المعدل الافتراضي. القيم المقبولة المتوافقة مع بيئة التطوير المتكاملة Arduino هي 2400، 4800، 9600، 19200، 38400، 57600، و115200. يمكنك استخدام معدلات بود أخرى، ولكنك لن تتمكن من الاتصال بـ OpenLog عبر شاشة Arduino IDE التسلسلية.
• Escap:e القيمة ASCII (بتنسيق عشري) لحرف الإفلات. 26 هو CTRL+z وهو الافتراضي. 36 هو $ وهو حرف إفلات مستخدم بشكل شائع.
• Esc #: عدد أحرف الهروب المطلوبة. افتراضيًا، هو ثلاثة، لذا يجب الضغط على حرف الهروب ثلاث مرات للانتقال إلى وضع الأوامر. القيم المقبولة تتراوح من 0 إلى 254. سيؤدي تعيين هذه القيمة إلى 0 إلى تعطيل التحقق من أحرف الهروب تمامًا.
• الوضع: وضع النظام. يبدأ OpenLog افتراضيًا في وضع السجل الجديد (0). القيم المقبولة هي: 0 = سجل جديد، 1 = سجل متسلسل، 2 = وضع الأوامر.
• الفعل: الوضع المُفصّل. رسائل الخطأ المُفصّلة مُفعّلة افتراضيًا. ضبط هذا الوضع على ١ يُفعّل رسائل الخطأ المُفصّلة (مثل أمر غير معروف: إزالة !). ضبط هذا الوضع على ٠ يُوقف رسائل الخطأ المُفصّلة، ولكنه سيستجيب بعلامة ! في حال وجود خطأ. يُعدّ إيقاف الوضع المُفصّل مفيدًا إذا كنت تُحاول معالجة أخطاء من نظام مُضمّن.
• صدى: وضع الصدى. في وضع الأوامر، تُصدى الأحرف افتراضيًا. ضبط هذا على 0 يُوقف صدى الأحرف. يُعدّ إيقاف هذا الوضع مفيدًا عند التعامل مع الأخطاء، ولا ترغب في أن تُصدى الأوامر المُرسلة إلى OpenLog.II.
• تجاهل تجاوز الطوارئ. عادةً، يُعاد ضبط OpenLog في حالة الطوارئ عند خفض مستوى دبوس الاستقبال أثناء التشغيل. يؤدي ضبط هذا الخيار على 1 إلى تعطيل فحص دبوس الاستقبال أثناء التشغيل. قد يكون هذا مفيدًا للأنظمة التي تُبقي خط الاستقبال منخفضًا لأسباب مختلفة. في حال تعطيل تجاوز الطوارئ، لن تتمكن من إعادة الجهاز إلى 9600 بت في الثانية، وسيُعاد ضبط التكوين. file ستكون الطريقة الوحيدة لتعديل معدل الباود.

كيف يقوم OpenLog بتعديل التكوين File
هناك خمسة مواقف مختلفة لـ OpenLog لتعديل ملف config.txt file.

• تكوين file تم العثور على: أثناء تشغيل الطاقة، سيبحث OpenLog عن ملف config.txt file. إذا كان file إذا تم العثور على OpenLog، فسيستخدم الإعدادات المضمنة ويكتب فوق أي إعدادات نظام مخزنة مسبقًا.
• لا يوجد تكوين file تم العثور على: إذا لم يتمكن OpenLog من العثور على ملف config.txt file سيقوم OpenLog بإنشاء ملف config.txt وتسجيل إعدادات النظام المخزنة فيه. هذا يعني أنه عند إدخال بطاقة microSD مُهيأة حديثًا، سيحافظ نظامك على إعداداته الحالية.
• تكوين تالف file تم العثور على: سيقوم OpenLog بمسح ملف config.txt التالف file، وسوف يعيد كتابة كل من إعدادات EEPROM الداخلية وإعدادات config.txt file إلى الحالة المعروفة الجيدة 9600,26,3,0,1,1,0،XNUMX،XNUMX،XNUMX،XNUMX،XNUMX،XNUMX.
• القيم غير القانونية في التكوين file:إذا اكتشف OpenLog أي إعدادات تحتوي على قيم غير قانونية، فسوف يقوم OpenLog باستبدال القيم الفاسدة في config.txt file مع إعدادات نظام EEPROM المخزنة حاليًا.
• التغييرات من خلال موجه الأوامر: إذا تم تغيير إعدادات النظام من خلال موجه الأوامر (إما عبر اتصال تسلسلي أو عبر أوامر تسلسلية للميكروكنترولر)، فسيتم تسجيل هذه التغييرات في كل من EEPROM للنظام وفي ملف config.txt file.
• إعادة الضبط في حالات الطوارئ: إذا تم إعادة تشغيل OpenLog باستخدام وصلة بين RX وGND، وتم تعيين بت تجاوز الطوارئ على 0 (السماح بإعادة الضبط في حالات الطوارئ)، فسوف يقوم OpenLog بإعادة كتابة كل من إعدادات EEPROM الداخلية وإعدادات config.txt file إلى الحالة المعروفة الجيدة 9600,26,3,0,1,1,0،XNUMX،XNUMX،XNUMX،XNUMX،XNUMX،XNUMX.

استكشاف الأخطاء وإصلاحها

هناك عدة خيارات مختلفة للتحقق مما إذا كنت تواجه مشكلات في الاتصال عبر الشاشة التسلسلية، أو تواجه مشكلات مع الأحرف المتساقطة في السجلات، أو تحارب OpenLog المعطل.

التحقق من سلوك LED STAT1
يُظهر مؤشر LED STAT1 سلوكًا مختلفًا لخطأين شائعين مختلفين.

• ٣ ومضات: تعذّر تهيئة بطاقة microSD. قد تحتاج إلى تهيئة البطاقة بنظام FAT/FAT3 على جهاز الكمبيوتر.
• 5 ومضات: تم تغيير OpenLog إلى معدل بود جديد ويجب إعادة تشغيله.

التحقق المزدوج من بنية الدليل الفرعي

• إذا كنت تستخدم OpenLog.ino الافتراضي exampفي هذه الحالة، سيدعم OpenLog مجلدين فرعيين فقط. ستحتاج إلى تغيير قيمة FOLDER_TRACK_DEPTH من 2 إلى عدد المجلدات الفرعية التي تحتاج إلى دعمها. بعد ذلك، أعد تجميع الكود، ثم حمّل البرنامج الثابت المعدّل.
• التحقق من رقم Files في الدليل الجذر
• سيدعم OpenLog ما يصل إلى 65,534 سجلًا فقط files في المجلد الجذر. نوصي بإعادة تهيئة بطاقة microSD لتحسين سرعة التسجيل.
• التحقق من حجم البرامج الثابتة المعدلة لديك
• إذا كنت تكتب رسمًا تخطيطيًا مخصصًا لـ OpenLog، فتأكد من أن حجم الرسم التخطيطي لا يتجاوز 32,256 بايت. في هذه الحالة، سيتم اقتطاع الجزء العلوي (500 بايت) من ذاكرة الفلاش، والذي يستخدمه مُحمِّل الإقلاع التسلسلي Optiboot.
• التحقق مرة أخرى File الأسماء
• الجميع file يجب أن تكون الأسماء أبجدية رقمية. ملف MyLOG1.txt يعمل بشكل جيد، ولكن قد لا يعمل ملف Hi !e _ .txtt.
• استخدم 9600 بود
• يعمل OpenLog على معالج ATmega328، وله ذاكرة وصول عشوائي (RAM) محدودة (2048 بايت). عند إرسال أحرف تسلسلية إلى OpenLog، تُخزَّن هذه الأحرف مؤقتًا. تسمح مواصفات SD Group Simplified لبطاقة SD بمدة تصل إلى 250 مللي ثانية (القسم 4.6.2.2 كتابة) لتسجيل كتلة بيانات في ذاكرة فلاش.
• بمعدل 9600 بت في الثانية، أي 960 بايت (10 بت لكل بايت) في الثانية، أي 1.04 مللي ثانية لكل بايت. يستخدم OpenLog حاليًا مخزنًا مؤقتًا للاستقبال بسعة 512 بايت، ما يسمح له بتخزين حوالي 50 مللي ثانية من الأحرف. هذا يسمح لـ OpenLog باستقبال جميع الأحرف الواردة بسرعة 9600 بت في الثانية بنجاح. مع زيادة معدل البود، سيقل زمن التخزين المؤقت.

وقت تجاوز مخزن OpenLog

تتميز العديد من بطاقات SD بوقت تسجيل أسرع من 250 مللي ثانية. قد يتأثر هذا بفئة البطاقة وكمية البيانات المخزنة عليها. يكمن الحل في استخدام معدل بود أقل أو زيادة الفترة الزمنية بين إرسال الأحرف بمعدل بود أعلى.

الأسئلة الشائعة