مشخصات

• نام محصول: ثبت‌کننده‌ی داده‌های OpenLog
• مدل: DEV-13712
• ورودی برق: ۳.۳ تا ۱۲ ولت (توصیه شده ۳.۳ تا ۵ ولت)
• ولتاژ ورودی RXItage: 2.0-3.8 ولت
• خروجی TXO ولتtage: 3.3 ولت
• جریان مصرفی در حالت آماده به کار: تقریباً ۲ تا ۵ میلی‌آمپر (بدون کارت حافظه microSD)، تقریباً ۵ تا ۶ میلی‌آمپر (با کارت حافظه microSD)
• جریان مصرفی فعال هنگام نوشتن: حدود ۲۰ تا ۲۳ میلی‌آمپر (با کارت حافظه microSD)

دستورالعمل استفاده از محصول

مواد مورد نیاز:

• Arduino Pro Mini 328 – 3.3V/8MHz
• برک‌اوت پایه SparkFun FTDI – ۳.۳ ولت
• کابل USB SparkFun Cerberus - 6 متری
• کارت حافظه microSD با آداپتور - 16 گیگابایت (کلاس 10)
• کارت خوان میکرو اس دی USB
• هدرهای زن
• سیم جامپر پریمیوم ۶ متری بسته ۱۰ عددی
• هدرهای نری را جدا کنید - زاویه قائمه

مطالعه‌ی پیشنهادی:

• نحوه لحیم کاری: لحیم کاری از طریق سوراخ
• مبانی ارتباط سریال
• رابط جانبی سریال (SPI)
• مبانی ترمینال سریال

سخت افزار تمام شدview:
OpenLog با تنظیمات زیر اجرا می‌شود:

مقدمه

توجه! این آموزش برای Open Log برای سریال UART [DEV-13712] است. اگر از Qwiic OpenLog برای IC [DEV-15164] استفاده می‌کنید، لطفاً به راهنمای اتصال Qwiic OpenLog مراجعه کنید.

OpenLog Data Logger یک راهکار متن‌باز و با کاربری آسان برای ثبت داده‌های سریال از پروژه‌های شماست. OpenLog یک رابط سریال ساده برای ثبت داده‌ها از یک پروژه به کارت microSD فراهم می‌کند.

اسپارک‌فان، اوپن‌لاگ
DEV-13712

SparkFun OpenLog با هدرها
DEV-13955

محصولی یافت نشد

مواد مورد نیاز
برای اینکه بتوانید این آموزش را به طور کامل انجام دهید، به قطعات زیر نیاز خواهید داشت. البته بسته به آنچه دارید، ممکن است به همه آنها نیاز نداشته باشید. آن را به سبد خرید خود اضافه کنید، راهنما را مطالعه کنید و در صورت لزوم سبد خرید را تنظیم کنید.

راهنمای اتصال OpenLog

لیست آرزوهای SparkFun

خواندن توصیه می شود
اگر با مفاهیم زیر آشنا نیستید یا احساس راحتی نمی‌کنید، توصیه می‌کنیم قبل از ادامه‌ی راهنمای اتصال OpenLog، آن‌ها را مطالعه کنید.

• نحوه لحیم کاری: لحیم کاری سوراخکاری. این آموزش هر آنچه را که باید در مورد لحیم کاری سوراخکاری بدانید، پوشش می‌دهد.
• ارتباط سریال مفاهیم ارتباط سریال ناهمزمان: بسته‌ها، سطوح سیگنال، نرخ باود، UARTها و موارد دیگر!
• رابط جانبی سریال (SPI) SPI معمولاً برای اتصال میکروکنترلرها به لوازم جانبی مانند سنسورها، شیفت رجیسترها و کارت‌های SD استفاده می‌شود.
• مبانی ترمینال سریال این آموزش به شما نشان می‌دهد که چگونه با استفاده از انواع برنامه‌های شبیه‌ساز ترمینال، با دستگاه‌های سریال خود ارتباط برقرار کنید.

سخت افزار تمام شدview

قدرت
OpenLog با تنظیمات زیر اجرا می‌شود:

رتبه‌بندی‌های توان OpenLog

جریان مصرفی OpenLog هنگام نوشتن روی microSD حدود 20 تا 23 میلی‌آمپر است. بسته به اندازه کارت microSD و سازنده آن، جریان مصرفی فعال می‌تواند هنگام نوشتن OpenLog روی کارت حافظه متفاوت باشد. افزایش نرخ انتقال داده (baud rate) نیز جریان بیشتری مصرف می‌کند.

میکروکنترلرها
OpenLog به لطف کریستال داخلی، توسط یک ATmega328 داخلی با سرعت 16 مگاهرتز اجرا می‌شود. بوت لودر Optiboot روی ATmega328 بارگذاری شده است که به OpenLog اجازه می‌دهد با ... سازگار باشد.
تنظیمات برد «آردوینو اونو» در محیط توسعه نرم‌افزار آردوینو.

رابط

سریال UART
رابط اصلی با OpenLog، هدر FTDI در لبه برد است. این هدر برای اتصال مستقیم به آردوینو Pro یا Pro Mini طراحی شده است که به میکروکنترلر اجازه می‌دهد داده‌ها را از طریق اتصال سریال به OpenLog ارسال کند.

هشدار! به دلیل ترتیب پین‌ها که آن را با آردوینو سازگار می‌کند، نمی‌توان آن را مستقیماً به یک برد FTDI متصل کرد.

برای اطلاعات بیشتر، حتماً بخش بعدی در مورد اتصال سخت‌افزاری را بررسی کنید.

SPI

همچنین چهار نقطه تست SPI در انتهای دیگر برد وجود دارد. می‌توانید از آنها برای برنامه‌ریزی مجدد بوت لودر روی ATmega328 استفاده کنید.

• جدیدترین OpenLog (DEV-13712) این پین‌ها را روی سوراخ‌های کوچک‌تر آبکاری شده قرار می‌دهد. اگر نیاز دارید از یک ISP برای برنامه‌ریزی مجدد یا آپلود یک بوت‌لودر جدید به OpenLog استفاده کنید، می‌توانید از پین‌های pogo برای اتصال به این نقاط تست استفاده کنید.
• رابط نهایی برای برقراری ارتباط با OpenLog، خود کارت microSD است. برای برقراری ارتباط، کارت microSD به پین‌های SPI نیاز دارد. این پین‌ها نه تنها محل ذخیره داده‌ها توسط OpenLog هستند، بلکه می‌توانید پیکربندی OpenLog را از طریق فایل config.txt نیز به‌روزرسانی کنید. file روی کارت microSD
  کارت microSD

تمام داده‌های ثبت‌شده توسط OpenLog روی کارت microSD ذخیره می‌شوند. OpenLog با کارت‌های microSD که دارای ویژگی‌های زیر هستند، کار می‌کند:

• 64 مگابایت تا 32 گیگابایت
• FAT16 یا FAT32

دو چراغ LED وضعیت روی OpenLog وجود دارد که به شما در عیب‌یابی کمک می‌کند.

• STAT1 – این LED نشانگر آبی به آردوینو D5 (ATmega328 PD5) متصل است و با دریافت یک کاراکتر جدید روشن/خاموش می‌شود. این LED هنگام برقراری ارتباط سریال چشمک می‌زند.
• STAT2 – این LED سبز به آردوینو D13 (خط کلاک سریال SPI/ ATmega328 PB5) متصل است. این LED فقط زمانی چشمک می‌زند که رابط SPI فعال باشد. وقتی OpenLog 512 بایت را روی کارت microSD ضبط می‌کند، چشمک می‌زند.

اتصال سخت افزاری

دو روش اصلی برای اتصال OpenLog به یک مدار وجود دارد. برای اتصال به چند هدر یا سیم نیاز دارید. مطمئن شوید که برای اتصال ایمن، آن را به برد لحیم کرده‌اید.

اتصال سریال پایه

نکتهاگر یک هدر ماده روی OpenLog و یک هدر ماده روی FTDI دارید، برای اتصال به سیم‌های جامپر M/F نیاز خواهید داشت.

این اتصال سخت‌افزاری برای ارتباط با OpenLog طراحی شده است، در صورتی که نیاز به برنامه‌ریزی مجدد برد یا ثبت داده‌ها از طریق یک اتصال سریال ساده داشته باشید.

اتصالات زیر را انجام دهید:
OpenLog → برک‌اوت پایه FTDI 3.3 ولت

• GND → GND
• GND → GND
• VCC → ۳.۳ ولت
• TXO → RXI
• RXI → TXO
• دی‌تی‌آر → دی‌تی‌آر

توجه داشته باشید که این یک ارتباط مستقیم بین 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 که قصد اجرای آن را دارید آپلود کنید. لطفاً برای برخی از مثال‌ها، طرح‌های آردوینو را بررسی کنید.ampکدی که می‌توانید از آن استفاده کنید.

توجه: اگر مطمئن نیستید که چگونه Pro Mini خود را برنامه ریزی کنید، لطفاً آموزش ما را اینجا ببینید.

استفاده از آردوینو پرو مینی ۳.۳ ولتی

• این آموزش، راهنمای شما برای همه چیز در مورد آردوینو پرو مینی است. توضیح می‌دهد که این برد چه هست، چه نیست و چگونه می‌توانید از آن استفاده کنید.
• پس از برنامه‌ریزی Pro Mini، می‌توانید برد FTDI را برداشته و آن را با OpenLog جایگزین کنید. مطمئن شوید که پین‌های با برچسب BLK را روی هر دو Pro Mini و OpenLog وصل می‌کنید (پین‌های با برچسب GRN در هر دو نیز در صورت انجام صحیح، با هم مطابقت دارند).
• اگر نمی‌توانید OpenLog را مستقیماً به Pro Mini وصل کنید (به دلیل هدرهای ناسازگار یا بردهای دیگر در مسیر)، می‌توانید از سیم‌های رابط استفاده کرده و اتصالات زیر را برقرار کنید.

OpenLog → Arduino Pro/Arduino Pro Mini

• GND → GND
• GND → GND
• وی سی سی → وی سی سی
• TXO → RXI
• RXI → TXO
• دی‌تی‌آر → دی‌تی‌آر

پس از اتمام کار، اتصالات شما باید مانند شکل زیر با آردوینو پرو مینی و آردوینو پرو باشد. نمودار Fritzing، OpenLogs را با هدرهای آینه‌ای نشان می‌دهد. اگر سوکت microSD را نسبت به بالای آردوینو بچرخانید view، آنها باید مانند یک FTDI با هدر برنامه‌نویسی مطابقت داشته باشند.

توجه داشته باشید که اتصال به صورت مستقیم و با OpenLog «وارونه» (با کارت حافظه microSD رو به بالا) انجام می‌شود.

توجه: از آنجایی که پین‌های Vcc و GND بین OpenLog و آردوینو توسط هدرها اشغال شده‌اند، باید تغذیه را به پین‌های دیگر موجود در آردوینو وصل کنید. در غیر این صورت، می‌توانید سیم‌ها را به پین‌های تغذیه‌ی بدون پوشش روی هر دو برد لحیم کنید.

سیستم خود را روشن کنید، و آماده شروع ثبت وقایع هستید!

طرح‌های آردوینو

شش مورد قبلی مختلف وجود داردampطرح‌هایی شامل این موارد هستند که می‌توانید هنگام اتصال به OpenLog روی آردوینو از آنها استفاده کنید.

• OpenLog_Benchmarking - این مثالample برای آزمایش OpenLog استفاده می‌شود. این برنامه حجم بسیار زیادی از داده‌ها را با سرعت ۱۱۵۲۰۰ بیت بر ثانیه از طریق چندین ... ارسال می‌کند. files.
• OpenLog_CommandTest - این مثالample نحوه ایجاد و الحاق a را نشان می‌دهد. file از طریق کنترل خط فرمان از طریق آردوینو.
• OpenLog_ReadExample — این سابقample نحوه کنترل OpenLog از طریق خط فرمان را شرح می‌دهد.
• OpenLog_ReadExampبزرگFile - سابقampنحوه باز کردن یک انبار بزرگ file روی OpenLog و از طریق اتصال بلوتوث محلی گزارش دهید.
• OpenLog_Test_Sketch — برای آزمایش OpenLog با داده‌های سریال زیاد استفاده می‌شود.
• OpenLog_Test_Sketch_Binary — برای آزمایش OpenLog با داده‌های دودویی و کاراکترهای escape استفاده می‌شود.

سیستم عامل

OpenLog دو نرم‌افزار اصلی روی خود دارد: بوت‌لودر و میان‌افزار.

بوت لودر آردوینو

توجه: اگر از OpenLog ای استفاده می‌کنید که قبل از مارس ۲۰۱۲ خریداری شده است، بوت لودر داخلی آن با تنظیمات «Arduino Pro یا Pro Mini 2012V/5MHz w/ ATmega16» در Arduino IDE سازگار است.

• همانطور که قبلاً ذکر شد، OpenLog دارای بوت لودر سریال Optiboot است. می‌توانید هنگام آپلود فایل‌های ex، OpenLog را درست مانند یک Arduino Uno مدیریت کنید.ampکد یا میان‌افزار جدید را به برد اضافه کنید.
• اگر در نهایت OpenLog شما از کار افتاد و نیاز به نصب مجدد بوت لودر داشتید، باید Optiboot را نیز روی برد آپلود کنید. لطفاً برای اطلاعات بیشتر، آموزش ما در مورد نصب بوت لودر آردوینو را بررسی کنید.

کامپایل و بارگذاری میان‌افزار روی OpenLog

توجه: اگر این اولین بار است که از آردوینو استفاده می‌کنید، لطفاً دوبارهview آموزش ما در مورد نصب Arduino IDE. اگر قبلاً کتابخانه آردوینو نصب نکرده‌اید، لطفاً برای نصب دستی کتابخانه‌ها، راهنمای نصب ما را بررسی کنید.

• اگر به هر دلیلی نیاز به به‌روزرسانی یا نصب مجدد میان‌افزار OpenLog خود دارید، مراحل زیر برد شما را راه‌اندازی و اجرا خواهد کرد.
• ابتدا، لطفاً Arduino IDE نسخه ۱.۶.۵ را دانلود کنید. نسخه‌های دیگر IDE ممکن است برای کامپایل فریمور OpenLog کار کنند، اما ما این نسخه را به عنوان یک نسخه خوب تأیید کرده‌ایم.
• در مرحله بعد، میان‌افزار OpenLog و بسته کتابخانه‌های مورد نیاز را دانلود کنید.

دانلود بسته نرم‌افزاری Openlog (ZIP)

• پس از دانلود کتابخانه‌ها و میان‌افزار، کتابخانه‌ها را در آردوینو نصب کنید. اگر مطمئن نیستید که چگونه کتابخانه‌ها را به صورت دستی در IDE نصب کنید، لطفاً آموزش ما را بررسی کنید: نصب کتابخانه آردوینو: نصب دستی کتابخانه.

توجه:

• ما از نسخه‌های اصلاح‌شده‌ی کتابخانه‌های SdFat و SerialPort استفاده می‌کنیم تا بتوانیم به طور دلخواه اندازه‌ی بافرهای TX و RX را تعیین کنیم. OpenLog ایجاب می‌کند که بافر TX بسیار کوچک (0) و بافر RX تا حد امکان بزرگ باشد.
• استفاده از این دو کتابخانه اصلاح‌شده در کنار هم، امکان افزایش عملکرد OpenLog را فراهم می‌کند.

دنبال آخرین نسخه‌ها هستید؟
اگر جدیدترین نسخه‌های کتابخانه‌ها و میان‌افزار را ترجیح می‌دهید، می‌توانید آنها را مستقیماً از مخازن GitHub که در زیر لینک شده‌اند دانلود کنید. کتابخانه‌های SdFatLib و Serial Port در مدیریت برد آردوینو قابل مشاهده نیستند، بنابراین باید کتابخانه را به صورت دستی نصب کنید.

• GitHub: OpenLog > Firmware > OpenLog_Firmware
• کتابخانه‌های آردوینو بیل گریمن
  • بتای SdFatLib
  • پورت سریال
• بعد، برای پیشرفتtagاز کتابخانه‌های اصلاح‌شده، فایل SerialPort.hh را تغییر دهید file در پوشه \Arduino\Libraries\SerialPort یافت می‌شود. مقدار BUFFERED_TX را به 0 و مقدار ENABLE_RX_ERROR_CHECKING را به 0 تغییر دهید. فایل را ذخیره کنید. fileو نرم‌افزار آردوینو IDE را باز کنید.
• اگر هنوز این کار را نکرده‌اید، OpenLog خود را از طریق یک برد FTDI به رایانه متصل کنید. لطفاً موارد قبلی را دوباره بررسی کنید.ampاگر مطمئن نیستید که چگونه این کار را به درستی انجام دهید، مدار را باز کنید.
• طرح OpenLog مورد نظر برای آپلود را از منوی Tools>Board باز کنید، گزینه “Arduino/Genuino Uno” را انتخاب کنید و پورت COM مناسب برای برد FTDI خود را از منوی Tools>Port انتخاب کنید.
• کد را آپلود کنید.
• همین! OpenLog شما اکنون با میان‌افزار جدید برنامه‌ریزی شده است. اکنون می‌توانید مانیتور سریال را باز کنید و با OpenLog تعامل داشته باشید. هنگام روشن شدن، یکی از دو علامت ۱۲> یا ۱۲< را خواهید دید. ۱ نشان می‌دهد که اتصال سریال برقرار شده است، ۲ نشان می‌دهد که کارت SD با موفقیت راه‌اندازی شده است، < نشان می‌دهد که OpenLog آماده ثبت هرگونه داده سریال دریافتی است و > نشان می‌دهد که OpenLog آماده دریافت دستورات است.

طرح‌های میان‌افزار OpenLog
سه طرح اولیه وجود دارد که می‌توانید بسته به کاربرد خاص خود، در OpenLog از آنها استفاده کنید.

• OpenLog – این میان‌افزار به طور پیش‌فرض روی OpenLog ارائه می‌شود. ارسال دستور ? نسخه میان‌افزار بارگذاری شده روی دستگاه را نشان می‌دهد.
• OpenLog_Light - این نسخه از طرح، حالت منو و دستور را حذف می‌کند و امکان افزایش بافر دریافتی را فراهم می‌کند. این گزینه خوبی برای ثبت وقایع با سرعت بالا است.
• OpenLog_Minimal – نرخ باود باید در کد تنظیم و آپلود شود. این طرح برای کاربران باتجربه توصیه می‌شود، اما همچنین بهترین گزینه برای ثبت وقایع با بالاترین سرعت است.

مجموعه فرمان

شما می‌توانید از طریق یک ترمینال سریال با OpenLog ارتباط برقرار کنید. دستورات زیر به شما در خواندن، نوشتن و حذف کمک می‌کنند. fileو همچنین تنظیمات OpenLog را تغییر دهید. برای استفاده از تنظیمات زیر باید در حالت Command باشید.

در حالی که OpenLog در حالت فرمان (Command Mode) است، STAT1 برای هر کاراکتر دریافتی روشن/خاموش می‌شود. LED تا دریافت کاراکتر بعدی روشن می‌ماند.

• جدید File - یک مورد جدید ایجاد می‌کند file نام برد File در دایرکتوری فعلی. استاندارد ۸.۳ fileنام‌ها پشتیبانی می‌شوند. برای مثالampمثلاً «۸۷۶۵۴۳۲۱.۱۲۳» قابل قبول است، در حالی که «۹۸۷۶۵۴۳۲۱.۱۲۳» قابل قبول نیست.
  • Exampلو: جدید file۱.txt
• ضمیمه File - اضافه کردن متن به انتهای Fileسپس داده‌های سریال از UART در یک جریان خوانده شده و به ... اضافه می‌شوند. file. از طریق ترمینال سریال منعکس نمی‌شود. اگر File وقتی این تابع فراخوانی می‌شود، وجود ندارد، file ایجاد خواهد شد.
  • Example: اضافه کردن مورد جدیدfilecsv
• بنویسید File OFFSET - نوشتن متن در File از محل OFFSET در داخل fileمتن از UART، خط به خط خوانده می‌شود و به صورت اکو (بازتاب) برگردانده می‌شود. برای خروج از این حالت، یک خط خالی ارسال کنید.
  • Example: نوشتن logs.txt 516
• rm File – حذف می‌کند File از دایرکتوری فعلی. کاراکترهای جایگزین (Wildcards) پشتیبانی می‌شوند.
  • Example: فایل README.txt از rm
• اندازه File – اندازه خروجی File بر حسب بایت.
  • Example: اندازه Log112.csv
  • خروجی: 11
• بخوانید File + شروع + نوع طول – محتوای File از START شروع می‌شود و به LENGTH می‌رسد. اگر START حذف شود، کل file گزارش می‌شود. اگر LENGTH حذف شود، کل محتوا از نقطه شروع گزارش می‌شود. اگر TYPE حذف شود، OpenLog به طور پیش‌فرض به صورت ASCII گزارش می‌دهد. سه نوع خروجی وجود دارد:
  • اسکی = ۱
  • هگز = ۲
  • خام = ۳
• می‌توانید برخی از آرگومان‌های دنباله‌دار را حذف کنید. مثال زیر را بررسی کنیدamples
• خواندن اولیه + پرچم‌های حذف شده:
  • Example: فایل LOG00004.txt را بخوانید
  • خروجی: شتاب‌سنج X=12 Y=215 Z=317
• خواندن از ابتدای ۰ با طول ۵:
  • Example: فایل LOG00004.txt را بخوانید 0 5
  • خروجی: شتاب
• خواندن از موقعیت ۱ با طول ۵ در قالب هگز:
  • Example: فایل LOG00004.txt را بخوانید ۱ ۵ ۲
  • خروجی: ۶۳ ۶۳ ۶۵ ۶C
• خواندن از موقعیت ۰ با طول ۵۰ در فرمت RAW:
  • Example: فایل LOG00137.txt را بخوانید ۱ ۵ ۲
  • خروجی: André– -þ آزمون شخصیت توسعه‌یافته
• گربه File - محتوای یک را بنویسید file در هگز به مانیتور سریال برای viewگاهی اوقات مفید است که ببینیم الف file بدون نیاز به بیرون کشیدن کارت SD، به درستی ضبط می‌کند و view را file روی رایانه
  • Example: گربه LOG00004.txt
  • خروجی: 00000000: 41 63 65 6c 3a 20 31

دستکاری دایرکتوری

• ls – تمام محتویات دایرکتوری فعلی را لیست می‌کند. از کاراکترهای Wildcards پشتیبانی می‌شود.
  • Exampلو: LS
  • خروجی: \src
• زیرشاخه md - ایجاد یک زیرشاخه در دایرکتوری فعلی.
  • Example: md سابقampطرح‌های le
• زیرشاخه cd - تغییر به زیرشاخه.
  • Example: سی دی سلام_جهان
• cd .. – رفتن به دایرکتوری پایین‌تر در درخت. توجه داشته باشید که بین 'cd' و '..' یک فاصله وجود دارد. این به تجزیه‌کننده رشته اجازه می‌دهد تا دستور CD را ببیند.
  • Exampلو: سی دی ..
• rm Subdirectory - زیرشاخه را حذف می‌کند. برای اینکه این دستور کار کند، دایرکتوری باید خالی باشد.
  • Example: دماهای کنترل شده
• rm -rf Directory - دایرکتوری و هر دایرکتوری دیگری را حذف می‌کند. fileدرون آن قرار دارد.
  • Example: کتابخانه‌های rm -rf

دستورات تابع سطح پایین

• ? – این دستور لیستی از دستورات موجود در OpenLog را نمایش می‌دهد.
• دیسک - شناسه سازنده کارت، شماره سریال، تاریخ ساخت و اندازه کارت را نشان می‌دهد. مثالampخروجی le عبارت است از:
  • نوع کارت: SD2 شناسه سازنده: 3
  • شناسه نصب شده: SD
  • محصول: SU01G
  • نسخه: 8.0
  • شماره سریال: ۳۹۷۲۳۰۴۲ تاریخ تولید: ۱/۲۰۱۰ حجم کارت: ۹۶۵۱۲۰ کیلوبایت
• init - سیستم را دوباره راه‌اندازی کرده و کارت SD را دوباره باز می‌کند. این در صورتی مفید است که کارت SD از کار افتاده باشد.
• همگام‌سازی - محتویات فعلی بافر را با کارت SD همگام‌سازی می‌کند. این دستور در صورتی مفید است که کمتر از ۵۱۲ کاراکتر در بافر داشته باشید و بخواهید آنها را روی کارت SD ضبط کنید.
• تنظیم مجدد - OpenLog را به مکان صفر پرش می‌کند، بوت لودر و سپس کد init را دوباره اجرا می‌کند. این دستور در صورت نیاز به ویرایش پیکربندی مفید است. file، OpenLog را بازنشانی کنید و استفاده از پیکربندی جدید را شروع کنید. چرخه برق هنوز روش ارجح برای بازنشانی برد است، اما این گزینه در دسترس است.

تنظیمات سیستم

این تنظیمات را می‌توان به صورت دستی به‌روزرسانی کرد یا در فایل config.txt ویرایش نمود. file.

• Echo STATE - وضعیت سیستم را تغییر می‌دهد و در حافظه سیستم ذخیره می‌شود. STATE می‌تواند روشن یا خاموش باشد. در حالت روشن، OpenLog داده‌های سریال دریافتی را در خط فرمان نمایش می‌دهد. در حالت خاموش، سیستم کاراکترهای دریافتی را بازخوانی نمی‌کند.

توجه: در طول ثبت وقایع عادی، اکو خاموش خواهد شد. تقاضای منابع سیستم برای اکو کردن داده‌های دریافتی در طول ثبت وقایع بسیار زیاد است.

• Verbose STATE - وضعیت گزارش خطای verbose را تغییر می‌دهد. STATE می‌تواند روشن یا خاموش باشد. این دستور در حافظه ذخیره می‌شود. با خاموش کردن خطاهای verbose، OpenLog در صورت وجود خطا، به جای یک دستور ناشناخته، فقط با یک ! پاسخ می‌دهد: C OMMAND.D..T تجزیه کاراکترها برای سیستم‌های تعبیه‌شده آسان‌تر از تجزیه کل خطا است. اگر از ترمینال استفاده می‌کنید، روشن گذاشتن verbose به شما امکان می‌دهد پیام‌های خطای کامل را مشاهده کنید.
• baud – این دستور یک منوی سیستمی را باز می‌کند که به کاربر اجازه می‌دهد نرخ انتقال داده (baud rate) را وارد کند. هر نرخ انتقال داده‌ای بین ۳۰۰ بیت بر ثانیه و ۱ مگابیت بر ثانیه پشتیبانی می‌شود. انتخاب نرخ انتقال داده بلافاصله انجام می‌شود و OpenLog برای اعمال تنظیمات نیاز به یک چرخه روشن/خاموش دارد. نرخ انتقال داده در EEPROM ذخیره می‌شود و هر بار که OpenLog روشن می‌شود، بارگذاری می‌شود. مقدار پیش‌فرض ۹۶۰۰ ۸N۱ است.

به یاد داشته باشید: اگر برد در نرخ انتقال داده نامشخصی گیر کرد، می‌توانید RX را به GND وصل کنید و OpenLog را روشن کنید. چراغ‌های LED به مدت ۲ ثانیه به عقب و جلو چشمک می‌زنند و سپس همزمان چشمک می‌زنند. OpenLog را خاموش کنید و جامپر را بردارید. OpenLog اکنون با فشردن سه بار متوالی کلید `CTRL-Z` به ۹۶۰۰ بیت بر ثانیه تنظیم مجدد می‌شود. این ویژگی را می‌توان با تنظیم بیت Emergency Override به ۱ لغو کرد. برای اطلاعات بیشتر به config.txt مراجعه کنید.

• Set - این دستور منوی سیستم را برای انتخاب حالت بوت باز می‌کند. این تنظیمات در روشن شدن بعدی اعمال می‌شوند و در حافظه EEPROM غیرفرار ذخیره می‌شوند.
  • جدید File ثبت وقایع - این حالت یک مورد جدید ایجاد می‌کند file هر بار که OpenLog روشن می‌شود. OpenLog عدد ۱ (UART فعال است)، عدد ۲ (کارت SD مقداردهی اولیه شده است) و سپس عدد < (OpenLog آماده دریافت داده است) را ارسال می‌کند. تمام داده‌ها در فایل LOG#####.txt ثبت می‌شوند. عدد ##### هر بار که OpenLog روشن می‌شود افزایش می‌یابد (حداکثر ۶۵۵۳۳ لاگ است). این عدد در EEPROM ذخیره می‌شود و می‌توان آن را از منوی تنظیمات بازنشانی کرد. همه کاراکترهای دریافتی تکرار نمی‌شوند. می‌توانید با ارسال CTRL+z (ASCII 1) از این حالت خارج شوید و وارد حالت فرمان شوید. تمام داده‌های بافر شده ذخیره می‌شوند.
• توجه: اگر تعداد لاگ‌های ایجاد شده خیلی زیاد باشد، OpenLog خطای **Too many logs** را نمایش می‌دهد، از این حالت خارج شوید و به Command Prompt بروید. خروجی سریال به شکل `12!Too many logs!` خواهد بود.
  • ضمیمه File ثبت وقایع - این حالت که به عنوان حالت ترتیبی نیز شناخته می‌شود، یک ... ایجاد می‌کند. file اگر SEQLOG.txt از قبل وجود نداشته باشد، آن را فراخوانی می‌کند و هر داده دریافتی را به آن اضافه می‌کند. fileOpenLog مقدار ۱۲< را ارسال می‌کند که در آن زمان OpenLog آماده دریافت داده است. کاراکترها تکرار نمی‌شوند. می‌توانید با ارسال CTRL+z (کد اسکی ۲۶) از این حالت خارج شده و وارد حالت فرمان شوید. تمام داده‌های بافر شده ذخیره خواهند شد.
  • خط فرمان - OpenLog 12> را ارسال می‌کند که در آن زمان سیستم آماده دریافت دستورات است. توجه داشته باشید که علامت > نشان می‌دهد که OpenLog آماده دریافت دستورات است، نه داده‌ها. می‌توانید ایجاد کنید fileو داده‌ها را به آن اضافه کنید files است، اما این نیاز به تجزیه سریالی (برای بررسی خطا) دارد، بنابراین ما این حالت را به طور پیش‌فرض تنظیم نمی‌کنیم.
  • تنظیم مجدد جدید File شماره - این حالت گزارش را بازنشانی می‌کند file عدد را به LOG000.txt ارسال کنید. این کار در صورتی مفید است که اخیراً کارت microSD را پاک کرده‌اید و می‌خواهید گزارش را ببینید. file اعدادی برای شروع دوباره.
  • کاراکتر گریز جدید - این گزینه به کاربر اجازه می‌دهد تا یک کاراکتر مانند CTRL+z یا $ وارد کند و آن را به عنوان کاراکتر گریز جدید تنظیم کند. این تنظیم در هنگام بازنشانی اضطراری به CTRL+z بازنشانی می‌شود.
  • تعداد کاراکترهای گریز - این گزینه به کاربر اجازه می‌دهد تا یک کاراکتر (مانند ۱، ۳ یا ۱۷) وارد کند و تعداد جدید کاراکترهای گریز مورد نیاز برای رها کردن به حالت فرمان را به‌روزرسانی کند. برای مثالampبرای رفتن به حالت فرمان، وارد کردن عدد ۸ مستلزم آن است که کاربر هشت بار کلیدهای CTRL+z را فشار دهد. این تنظیم در هنگام ریست اضطراری به عدد ۳ بازنشانی می‌شود.
• توضیح کاراکترهای گریز: دلیل اینکه OpenLog برای ورود به حالت فرمان نیاز به زدن `CTRL+z` سه بار دارد، جلوگیری از ریست شدن تصادفی برد در هنگام آپلود کد جدید از Arduino IDE است. این احتمال وجود دارد که برد هنگام بوت شدن، کاراکتر `CTRL+z` را ببیند (مشکلی که در نسخه‌های اولیه فریمور OpenLog دیدیم)، بنابراین هدف از این کار جلوگیری از این امر است. اگر به این دلیل مشکوک شدید که برد شما از کار افتاده است، همیشه می‌توانید با نگه داشتن پین RX روی زمین هنگام روشن کردن، یک ریست اضطراری انجام دهید.

پیکربندی File

اگر ترجیح می‌دهید از ترمینال سریال برای تغییر تنظیمات OpenLog خود استفاده نکنید، می‌توانید تنظیمات را با تغییر فایل CONFIG.TXT به‌روزرسانی کنید. file.

توجه: این ویژگی فقط روی نسخه ۱.۶ یا جدیدتر فریمور کار می‌کند. اگر OpenLog را بعد از سال ۲۰۱۲ خریداری کرده‌اید، از نسخه ۱.۶ یا بالاتر فریمور استفاده خواهید کرد.

• برای انجام این کار، به یک کارت خوان microSD و یک ویرایشگر متن نیاز دارید. فایل config.txt را باز کنید. file (با حروف بزرگ نوشتن file (اسم مهم نیست)، و پیکربندی را انجام دهید! اگر قبلاً OpenLog خود را با کارت SD روشن نکرده‌اید، می‌توانید آن را به صورت دستی نیز ایجاد کنید. fileاگر قبلاً OpenLog را با کارت microSD وارد شده روشن کرده‌اید، هنگام خواندن کارت microSD باید چیزی شبیه به تصویر زیر ببینید.OpenLog یک فایل config.txt و یک فایل LOG0000.txt ایجاد می‌کند. file با اولین روشن شدن.
• پیکربندی پیش فرض file یک خط تنظیمات و یک خط تعاریف دارد.پیکربندی پیش فرض file توسط OpenLog نوشته شده است.
• توجه داشته باشید که اینها کاراکترهای قابل مشاهده معمولی هستند (هیچ مقدار غیر قابل مشاهده یا دودویی وجود ندارد) و هر مقدار با کاما از هم جدا شده است.

تنظیمات به صورت زیر تعریف می‌شوند:

• baud: نرخ انتقال داده (baud rate) ارتباط. ۹۶۰۰ بیت بر ثانیه (bps) پیش‌فرض است. مقادیر قابل قبول که با Arduino IDE سازگار هستند عبارتند از ۲۴۰۰، ۴۸۰۰، ۹۶۰۰، ۱۹۲۰۰، ۳۸۴۰۰، ۵۷۶۰۰ و ۱۱۵۲۰۰. می‌توانید از نرخ‌های انتقال داده دیگری استفاده کنید، اما قادر به برقراری ارتباط با OpenLog از طریق مانیتور سریال Arduino IDE نخواهید بود.
• Escap:e مقدار ASCII (در قالب اعشاری) کاراکتر escape. عدد ۲۶ معادل CTRL+z است و مقدار پیش‌فرض است. عدد ۳۶ معادل $ است و یک کاراکتر escape رایج است.
• Esc#: تعداد کاراکترهای escape مورد نیاز. به طور پیش‌فرض، این عدد سه است، بنابراین برای رفتن به حالت فرمان باید سه بار کاراکتر escape را فشار دهید. مقادیر قابل قبول از ۰ تا ۲۵۴ هستند. تنظیم این مقدار روی ۰، بررسی کاراکتر escape را به طور کامل غیرفعال می‌کند.
• حالت سیستم. OpenLog به طور پیش‌فرض در حالت New Log (0) شروع می‌شود. مقادیر قابل قبول عبارتند از: 0 = New Log، 1 = Sequential Log، 2 = Command Mode.
• فعل: حالت مفصل. پیام‌های خطای طولانی (طولانی) به طور پیش‌فرض فعال هستند. تنظیم این مقدار روی ۱، پیام‌های خطای طولانی (مانند دستور ناشناخته: remove !) را فعال می‌کند. تنظیم این مقدار روی ۰، خطاهای طولانی را غیرفعال می‌کند، اما در صورت وجود خطا با ! پاسخ می‌دهد. غیرفعال کردن حالت مفصل در صورتی مفید است که سعی در مدیریت خطاهای یک سیستم تعبیه‌شده دارید.
• اکو: حالت اکو. در حالت فرمان، کاراکترها به طور پیش‌فرض اکو می‌شوند. تنظیم این مقدار روی ۰، اکوی کاراکتر را خاموش می‌کند. خاموش کردن این حالت در صورت مدیریت خطاها مفید است و شما نمی‌خواهید دستورات ارسالی به OpenLog.II اکو شوند.
• نادیده گرفتن لغو اضطراری RX. معمولاً OpenLog وقتی پین RX در حین روشن شدن در حالت Low قرار می‌گیرد، به صورت اضطراری ریست می‌شود. تنظیم این گزینه روی ۱، بررسی پین RX را در حین روشن شدن غیرفعال می‌کند. این می‌تواند برای سیستم‌هایی که به دلایل مختلف خط RX را در حالت Low نگه می‌دارند، مفید باشد. اگر لغو اضطراری غیرفعال باشد، نمی‌توانید دستگاه را مجبور به بازگشت به ۹۶۰۰ بیت بر ثانیه کنید و پیکربندی 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 به حالت خوبِ شناخته‌شده‌ی ۹۶۰۰،۲۶،۳،۰،۱،۱،۰.
• مقادیر غیرمجاز در پیکربندی fileاگر OpenLog تنظیماتی حاوی مقادیر غیرمجاز را کشف کند، OpenLog مقادیر خراب موجود در config.txt را بازنویسی می‌کند. file با تنظیمات سیستم EEPROM ذخیره شده فعلی.
• تغییرات از طریق خط فرمان: اگر تنظیمات سیستم از طریق خط فرمان (چه از طریق اتصال سریال و چه از طریق دستورات سریال میکروکنترلر) تغییر کند، این تغییرات هم در حافظه EEPROM سیستم و هم در فایل config.txt ثبت می‌شوند. file.
• تنظیم مجدد اضطراری: اگر OpenLog با یک جامپر بین RX و GND روشن و خاموش شود و بیت لغو اضطراری روی ۰ تنظیم شود (امکان تنظیم مجدد اضطراری فراهم شود)، OpenLog هم تنظیمات داخلی EEPROM و هم تنظیمات config.txt را بازنویسی می‌کند. file به حالت خوبِ شناخته‌شده‌ی ۹۶۰۰،۲۶،۳،۰،۱،۱،۰.

عیب یابی

چندین گزینه مختلف برای بررسی اینکه آیا در اتصال از طریق مانیتور سریال مشکل دارید، با مشکل حذف کاراکترها در گزارش‌ها مواجه هستید یا با OpenLog از کار افتاده مواجه هستید، وجود دارد.

بررسی رفتار LED STAT1
چراغ LED مربوط به STAT1 برای دو خطای رایج مختلف، رفتار متفاوتی نشان می‌دهد.

• ۳ چشمک می‌زند: کارت microSD راه‌اندازی اولیه نشد. ممکن است لازم باشد کارت را با FAT/FAT3 در رایانه فرمت کنید.
• ۵ چشمک می‌زند: OpenLog به نرخ انتقال داده جدیدی تغییر کرده است و نیاز به وصل مجدد برق دارد.

بررسی مجدد ساختار زیرشاخه‌ها

• اگر از OpenLog.ino ex پیش‌فرض استفاده می‌کنیدampدر اینجا، OpenLog فقط از دو زیرشاخه پشتیبانی می‌کند. شما باید FOLDER_TRACK_DEPTH را از ۲ به تعداد زیرشاخه‌هایی که باید پشتیبانی کنید تغییر دهید. پس از انجام این کار، کد را دوباره کامپایل کنید و میان‌افزار اصلاح‌شده را آپلود کنید.
• تعداد را تأیید کنید Files در دایرکتوری ریشه
• OpenLog فقط تا 65,534 لاگ را پشتیبانی می‌کند. files در دایرکتوری ریشه قرار دارد. توصیه می‌کنیم برای بهبود سرعت ثبت وقایع، کارت microSD خود را فرمت مجدد کنید.
• حجم میان‌افزار اصلاح‌شده خود را تأیید کنید
• اگر در حال نوشتن یک طرح سفارشی برای OpenLog هستید، بررسی کنید که طرح شما بزرگتر از ۳۲۲۵۶ نباشد. در این صورت، ۵۰۰ بایت بالایی حافظه فلش که توسط بوت لودر سریال Optiboot استفاده می‌شود، برش داده خواهد شد.
• دوبار چک کنید File نام ها
• همه file نام‌ها باید ترکیبی از حروف و اعداد باشند. MyLOG1.txt مشکلی ندارد، اما Hi !e _ .txtt ممکن است کار نکند.
• از ۹۶۰۰ باود استفاده کنید
• OpenLog روی ATmega328 اجرا می‌شود و مقدار محدودی رم (2048 بایت) دارد. وقتی کاراکترهای سریال را به OpenLog ارسال می‌کنید، این کاراکترها بافر می‌شوند. مشخصات ساده‌شده گروه SD به یک کارت SD اجازه می‌دهد تا 250 میلی‌ثانیه (بخش 4.6.2.2 نوشتن) برای ضبط یک بلوک داده در حافظه فلش زمان ببرد.
• با سرعت ۹۶۰۰ بیت بر ثانیه، این یعنی ۹۶۰ بایت (۱۰ بیت در هر بایت) در ثانیه. یعنی ۱.۰۴ میلی‌ثانیه در هر بایت. OpenLog در حال حاضر از یک بافر دریافت ۵۱۲ بایتی استفاده می‌کند، بنابراین می‌تواند حدود ۵۰ میلی‌ثانیه کاراکتر را بافر کند. این به OpenLog اجازه می‌دهد تا تمام کاراکترهای دریافتی با سرعت ۹۶۰۰ بیت بر ثانیه را با موفقیت دریافت کند. با افزایش نرخ انتقال داده، بافر مدت زمان کمتری دوام خواهد آورد.

زمان سرریز بافر OpenLog

بسیاری از کارت‌های SD زمان ضبط سریع‌تری از ۲۵۰ میلی‌ثانیه دارند. این می‌تواند تحت تأثیر «کلاس» کارت و میزان داده ذخیره شده روی کارت باشد. راه حل این است که از نرخ بیت در ثانیه پایین‌تری استفاده کنید یا فاصله زمانی بین ارسال کاراکترها را با نرخ بیت در ثانیه بالاتر افزایش دهید.

سوالات متداول