Технічні характеристики

• Назва продукту: Реєстратор даних OpenLog
• Модель: DEV-13712
• Вхідне живлення: 3.3 В - 12 В (рекомендовано 3.3 В - 5 В)
• Вхідний гучність RXItagе: 2.0В-3.8В
• Вихідний гучність TXOtage: 3.3 В.
• Струм споживання в режимі очікування: ~2 мА-5 мА (без карти microSD), ~5 мА-6 мА (з картою microSD)
• Струм активного запису: ~20-23 мА (з картою microSD)

Інструкція з використання продукту

Необхідні матеріали:

• Arduino Pro Mini 328 – 3.3 В/8 МГц
• Базовий роз'єм SparkFun FTDI – 3.3V
• USB-кабель SparkFun Cerberus – 6 м
• Карта microSD з адаптером – 16 ГБ (клас 10)
• USB-зчитувач microSD
• Жіночі заголовки
• Дроти-перемички преміум-класу, 6 M/M, упаковка з 10 штук
• Відривні чоловічі заголовки – прямий кут

Рекомендована література:

• Як паяти: пайка через отвір
• Основи послідовного зв'язку
• Послідовний периферійний інтерфейс (SPI)
• Основи послідовного терміналу

Обладнання закінченоview:
OpenLog працює з такими налаштуваннями:

вступ

Увага! Цей посібник стосується Open Log для послідовного UART [DEV-13712]. Якщо ви використовуєте Qwiic OpenLog для IC [DEV-15164], зверніться до Посібника з підключення Qwiic OpenLog.

Реєстратор даних OpenLog — це просте у використанні рішення з відкритим кодом для реєстрації послідовних даних з ваших проектів. OpenLog надає простий послідовний інтерфейс для реєстрації даних з проекту на карту microSD.

SparkFun OpenLog
DEV-13712

SparkFun OpenLog із заголовками
DEV-13955

Товарів не знайдено

Необхідні матеріали
Щоб повністю опанувати цей посібник, вам знадобляться наступні компоненти. Однак, вам може знадобитися не все, залежно від того, що у вас є. Додайте все до кошика, прочитайте посібник і за потреби налаштуйте кошик.

Посібник з підключення OpenLog

Список бажань SparkFun

Рекомендована література
Якщо ви не знайомі або не відчуваєте себе комфортно з наступними концепціями, радимо ознайомитися з ними, перш ніж продовжувати роботу з посібником з підключення OpenLog.

• Як паяти: Пайка через отвір. Цей посібник охоплює все, що вам потрібно знати про пайку через отвір.
• Послідовний зв'язок Концепції асинхронного послідовного зв'язку: пакети, рівні сигналів, швидкість передачі даних, UART та багато іншого!
• Послідовний периферійний інтерфейс (SPI) SPI зазвичай використовується для підключення мікроконтролерів до периферійних пристроїв, таких як датчики, регістри зсуву та SD-карти.
• Основи послідовного терміналу У цьому посібнику ви дізнаєтесь, як взаємодіяти з послідовними пристроями за допомогою різноманітних програм емулятора терміналу.

Обладнання закінченоview

потужність
OpenLog працює з такими налаштуваннями:

Номінальні потужності OpenLog

Споживання струму OpenLog під час запису на картку microSD становить приблизно від 20 мА до 23 мА. Залежно від розміру картки microSD та її виробника, активне споживання струму може змінюватися, коли OpenLog записує на картку пам'яті. Збільшення швидкості передачі даних також призведе до збільшення споживання струму.

Мікроконтролер
OpenLog працює на вбудованому кварцовому мікросхемі ATmega328 з частотою 16 МГц завдяки вбудованому кристалу. На ATmega328 завантажено завантажувач Optiboot, що забезпечує сумісність OpenLog з...
Налаштування плати «Arduino Uno» в середовищі розробки Arduino IDE.

Інтерфейс

Послідовний UART
Основним інтерфейсом з OpenLog є роз'єм FTDI на краю плати. Цей роз'єм призначений для безпосереднього підключення до Arduino Pro або Pro Mini, що дозволяє мікроконтролеру надсилати дані через послідовне з'єднання до OpenLog.

УВАГА! Через порядок виведення контактів, що робить його сумісним з Arduino, його не можна підключати безпосередньо до плати FTDI.

Для отримання додаткової інформації обов’язково перегляньте наступний розділ про підключення обладнання.

SPI

Також на протилежному кінці плати є чотири тестові виходи SPI. Ви можете використовувати їх для перепрограмування завантажувача на ATmega328.

• В останньому варіанті OpenLog (DEV-13712) ці контакти виведені на менші наскрізні отвори з гальванічним покриттям. Якщо вам потрібно скористатися послугами інтернет-провайдера для перепрограмування або завантаження нового завантажувача в OpenLog, ви можете використовувати контакти pogo для підключення до цих тестових точок.
• Останнім інтерфейсом для зв'язку з OpenLog є сама карта microSD. Для зв'язку карті microSD потрібні контакти SPI. Тут не тільки зберігаються дані OpenLog, але й можна оновлювати конфігурацію OpenLog через файл config.txt. file на карті microSD.
  Картка microSD

Усі дані, що реєструються OpenLog, зберігаються на картці microSD. OpenLog працює з картками microSD, які мають такі функції:

• Від 64 Мб до 32 Гб
• FAT16 або FAT32

На OpenLog є два світлодіоди стану, які допоможуть вам у вирішенні проблем.

• STAT1 – Цей синій індикаторний світлодіод підключений до Arduino D5 (ATmega328 PD5) і вмикається/вимикається, коли отримується новий символ. Цей світлодіод блимає, коли працює послідовний зв'язок.
• STAT2 – Цей зелений світлодіод підключено до Arduino D13 (лінія послідовного тактового сигналу SPI/ATmega328 PB5). Цей світлодіод блимає лише тоді, коли інтерфейс SPI активний. Ви побачите, як він блимає, коли OpenLog записує 512 байт на карту microSD.

Підключення апаратного забезпечення

Існує два основних способи підключення вашого OpenLog до схеми. Вам знадобляться деякі роз'єми або дроти для підключення. Переконайтеся, що ви припаяли до плати для надійного з'єднання.

Базове послідовне з'єднання

ПідказкаЯкщо у вас є роз'єм типу "мама" на OpenLog та роз'єм типу "мама" на FTDI, вам знадобляться перемички M/F для підключення.

Це апаратне з'єднання призначене для взаємодії з OpenLog, якщо вам потрібно перепрограмувати плату або записати дані через звичайне послідовне з'єднання.

Виконайте такі з’єднання:
OpenLog → Базовий прохідний модуль FTDI 3.3V

• GND → GND
• GND → GND
• VCC → 3.3 В
• 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, який ви плануєте запустити. Будь ласка, перегляньте ескізи Arduino для деяких прикладів.ampкод, який ви можете використовувати.

Примітка: Якщо ви не знаєте, як запрограмувати свій Pro Mini, будь ласка, ознайомтеся з нашим посібником тут.

Використання Arduino Pro Mini 3.3V

• Цей посібник — ваш путівник по всьому, що пов'язано з Arduino 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
• ДТР → ДТР

Після завершення ваші з’єднання з Arduino Pro Mini та Arduino Pro повинні виглядати наступним чином. На діаграмі Fritzing показано OpenLogs із дзеркально відображеними заголовками. Якщо ви перевернете роз’єм microSD відносно верхньої частини Arduino view, вони повинні відповідати заголовку програмування, як у FTDI.

Зверніть увагу, що підключення пряме, з OpenLog «догори дном» (карткою microSD догори).

Примітка: Оскільки Vcc та GND між OpenLog та Arduino зайняті роз'ємами, вам потрібно буде підключити живлення до інших доступних контактів на Arduino. В іншому випадку ви можете припаяти дроти до відкритих контактів живлення на будь-якій платі.

Увімкніть свою систему, і ви готові розпочати ведення журналу!

Ескізи Arduino

Існує шість різних колишніхampвключені ескізи, які можна використовувати на Arduino при підключенні до OpenLog.

• OpenLog_Benchmarking — Цей ексample використовується для тестування OpenLog. Він надсилає дуже великі обсяги даних зі швидкістю 115200 біт/с через кілька files.
• OpenLog_CommandTest — Цей example показує, як створити та додати file через керування з командного рядка через Arduino.
• OpenLog_ReadExampле — Цей колишнійampУ цьому документі описано, як керувати OpenLog за допомогою командного рядка.
• OpenLog_ReadExample_LargeFile — Прampлекція про те, як відкрити велике сховище file на OpenLog та повідомити про це через локальне з’єднання Bluetooth.
• OpenLog_Test_Sketch — Використовується для тестування OpenLog з великою кількістю послідовних даних.
• OpenLog_Test_Sketch_Binary — Використовується для тестування OpenLog з двійковими даними та escape-символами.

Прошивка

OpenLog має два основні програмні компоненти: завантажувач та прошивку.

Завантажувач Arduino

Примітка: Якщо ви використовуєте OpenLog, придбаний до березня 2012 року, вбудований завантажувач сумісний з налаштуванням «Arduino Pro або Pro Mini 5V/16MHz w/ ATmega328» в середовищі розробки Arduino.

• Як згадувалося раніше, OpenLog має вбудований послідовний завантажувач Optiboot. Ви можете використовувати OpenLog так само, як Arduino Uno під час завантаження...ampкод або нову прошивку на плату.
• Якщо ви врешті-решт заблокували OpenLog і вам потрібно буде перевстановити завантажувач, вам також потрібно буде завантажити Optiboot на плату. Будь ласка, ознайомтеся з нашим посібником зі встановлення завантажувача Arduino для отримання додаткової інформації.

Компіляція та завантаження прошивки в OpenLog

Примітка: Якщо ви вперше використовуєте Arduino, будь ласка, повторітьview наш посібник зі встановлення середовища розробки Arduino. Якщо ви раніше не встановлювали бібліотеку Arduino, будь ласка, ознайомтеся з нашим посібником зі встановлення, щоб встановити бібліотеки вручну.

• Якщо з будь-якої причини вам потрібно оновити або перевстановити прошивку на вашому OpenLog, наступний процес допоможе вам запустити та запустити вашу плату.
• Спочатку завантажте Arduino IDE версії 1.6.5. Інші версії IDE можуть працювати для компіляції прошивки OpenLog, але ми перевірили цю версію як справну.
• Далі завантажте прошивку OpenLog та необхідний пакет бібліотек.

ЗАВАНТАЖИТИ ПАКЕТ ПРОШИВКИ OPENLOG (ZIP)

• Після завантаження бібліотек та прошивки встановіть їх в Arduino. Якщо ви не знаєте, як вручну встановити бібліотеки в IDE, ознайомтеся з нашим посібником: Встановлення бібліотеки Arduino: Ручне встановлення бібліотеки.

Примітка:

• Ми використовуємо модифіковані версії бібліотек SdFat та SerialPort, щоб довільно визначати розмір буферів передачі (TX) та прийому (RX). OpenLog вимагає, щоб буфер передачі (TX) був дуже малим (0), а буфер прийому (RX) — якомога більшим.
• Використання цих двох модифікованих бібліотек разом дозволяє підвищити продуктивність OpenLog.

Шукаєте найновіші версії?
Якщо ви бажаєте отримати найновіші версії бібліотек та прошивки, ви можете завантажити їх безпосередньо з репозиторіїв GitHub, посилання на які наведено нижче. Бібліотеки SdFatLib та Serial Port не відображаються в менеджері плат Arduino, тому вам потрібно буде встановити бібліотеку вручну.

• GitHub: OpenLog > Firmware > OpenLog_Firmware
• Бібліотеки Білла Греймана для Arduino
  • SdFatLib-бета-версія
  • Серійний порт
• Далі, щоб скористатися перевагамиtagсеред змінених бібліотек, модифікуйте SerialPort.hh file знаходиться в каталозі \Arduino\Libraries\SerialPort. Змініть BUFFERED_TX на 0 та ENABLE_RX_ERROR_CHECKING на 0. Збережіть fileта відкрийте середовище розробки Arduino.
• Якщо ви ще цього не зробили, підключіть свій 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 вмикатиметься/вимикатиметься для кожного прийнятого символу. Світлодіод світитиметься, доки не буде отримано наступний символ.

• новий File – Створює новий file названий File у поточному каталозі. Стандарт 8.3 fileімена підтримуються. Наприкладampтобто, «87654321.123» прийнятний, тоді як «987654321.123» – ні.
  • Exampле: новий file1.txt
• Додайте File – Додати текст у кінець FileПотім послідовні дані зчитуються з UART у потоці та додаються до file. Це не передається через послідовний термінал. Якщо File не існує, коли викликається ця функція, то file буде створено.
  • Example: додати новеfile.csv
• Напишіть File ЗМІЩЕННЯ – Написати текст у File від розташування OFFSET у межах fileТекст зчитується з UART рядок за рядком і відсилається назад. Щоб вийти з цього стану, надішліть порожній рядок.
  • Example: записати logs.txt 516
• rm File – Видаляє File з поточного каталогу. Підтримуються шаблони підстановки.
  • Exampфайл: rm README.txt
• розмір File – Розмір виводу File у байтах.
  • Exampле: розмір Log112.csv
  • Вихід: 11
• Прочитайте File + ПОЧАТОК+ ТИП ДОВЖИНИ – Вивести вміст File починаючи з START і продовжуючи до LENGTH. Якщо START пропущено, весь 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 у шістнадцятковому форматі:
  • Example: читання LOG00004.txt 1 5 2
  • Вихід: 63 63 65 6C
• Зчитування з позиції 0 довжиною 50 у RAW:
  • Example: читання LOG00137.txt 0 50 3
  • Вихід: Андре– -þ Розширений тест на характер
• кішка File – Напишіть зміст file у шістнадцятковому форматі до монітора послідовного порту для viewінг. Іноді корисно побачити, що file записує правильно без необхідності виймати SD-карту та view в file на комп’ютері.
  • Exampфайл: cat LOG00004.txt
  • Вихід: 00000000: 41 63 65 6c 3a 20 31

Маніпуляції з каталогами

• ls – Виводить весь вміст поточного каталогу. Підтримуються шаблони підстановки.
  • Exampле: лс
  • Вивід: \src
• Підкаталог md – Створити підкаталог у поточному каталозі.
  • Example: md Example_Sketches
• Підкаталог cd – Змінити на підкаталог.
  • Example: cd Привіт_Світ
• cd .. – Перехід до нижчого каталогу в дереві. Зверніть увагу, що між 'cd' та '..' є пробіл. Це дозволяє синтаксичному аналізу рядків побачити команду CD.
  • Exampле: кд ..
• rm Піддиректорія – Видаляє піддиректорію. Директорія має бути порожньою, щоб ця команда працювала.
  • Example: температура в повітрі
• rm -rf Каталог – Видаляє Каталог та будь-які fileщо містяться в ньому.
  • Example: rm -rf Бібліотеки

Команди низького рівня функцій

• ? – Ця команда відобразить список доступних команд у OpenLog.
• Диск – Відображає ідентифікатор виробника карти, серійний номер, дату виробництва та розмір карти. Наприкладampвихідний сигнал:
  • Тип карти: SD2, ID виробника: 3
  • Ідентифікатор OEM: SD
  • Продукт: SU01G
  • Версія: 8.0
  • Серійний номер: 39723042 Дата виробництва: 1/2010 Розмір картки: 965120 КБ
• init – Переініціалізація системи та повторне відкриття SD-карти. Це корисно, якщо SD-карта перестала відповідати.
• Синхронізація – синхронізує поточний вміст буфера з SD-картою. Ця команда корисна, якщо у вашому буфері менше 512 символів, і ви хочете записати їх на SD-карту.
• Скидання – Перемикає OpenLog до нульової позиції, перезапускає завантажувач, а потім код ініціалізації. Ця команда корисна, якщо вам потрібно редагувати конфігурацію. file, скиньте OpenLog та почніть використовувати нову конфігурацію. Вимкнення та повторне ввімкнення живлення все ще є кращим методом скидання налаштувань плати, але ця опція доступна.

Налаштування системи

Ці налаштування можна оновити або відредагувати вручну у файлі config.txt file.

• Echo STATE – Змінює стан системи та зберігається в системній пам'яті. STATE може бути як увімкнено, так і вимкнено. Коли OpenLog увімкнено, він відображатиме отримані послідовні дані в командному рядку. Коли вимкнено, система не зчитує отримані символи.

Примітка: Під час звичайного ведення журналу відлуння буде вимкнено. Вимоги до системних ресурсів для відображення отриманих даних занадто високі під час ведення журналу.

• Детальний стан – змінює стан детального звітування про помилки. STATE може бути як увімкнено, так і вимкнено. Ця команда зберігається в пам'яті. Якщо вимкнути детальне звітування про помилки, OpenLog відповість лише символом !, якщо виникла помилка, а не невідомою командою: COMMAND.D..T Символи he легше розібрати вбудованим системам, ніж повну помилку. Якщо ви використовуєте термінал, якщо залишити детальне звітування увімкненим, ви зможете бачити повні повідомлення про помилки.
• бод – Ця команда відкриє системне меню, яке дозволить користувачеві ввести швидкість передачі даних. Підтримується будь-яка швидкість передачі даних від 300 біт/с до 1 Мбіт/с. Вибір швидкості передачі даних відбувається миттєво, і OpenLog потребує вимкнення та вимкнення живлення, щоб налаштування набули чинності. Швидкість передачі даних зберігається в EEPROM та завантажується щоразу, коли OpenLog увімкнено. Значення за замовчуванням – 9600 8N1.

Пам'ятайте: Якщо плата зависла на невідомій швидкості передачі даних, ви можете підключити RX до GND та увімкнути OpenLog. Світлодіоди блиматимуть туди-сюди протягом 2 секунд, а потім блиматимуть синхронно. Вимкніть OpenLog та зніміть перемичку. Тепер швидкість OpenLog скидається до 9600 біт/с після триразового натискання клавіші `CTRL-Z`. Цю функцію можна скасувати, встановивши біт аварійного перемикання в 1. Див. config.txt для отримання додаткової інформації.

• Set – Ця команда відкриває системне меню для вибору режиму завантаження. Ці налаштування будуть застосовані під час наступного ввімкнення та зберігаються в енергонезалежній 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, якщо його ще немає, і додає будь-які отримані дані до fileOpenLog передасть 12<, після чого OpenLog буде готовий приймати дані. Символи не відображаються. Ви можете вийти з цього режиму та перейти в командний режим, надіславши CTRL+z (ASCII 26). Усі буферизовані дані будуть збережені.
  • Командний рядок – OpenLog передасть 12>, після чого система буде готова приймати команди. Зверніть увагу, що знак > вказує на те, що OpenLog готовий приймати команди, а не дані. Ви можете створити fileта додавати дані до files, але це вимагає певного послідовного розбору (для перевірки помилок), тому ми не встановлюємо цей режим за замовчуванням.
  • Скинути Нове File Номер – Цей режим скине журнал file номер до LOG000.txt. Це корисно, якщо ви нещодавно очистили карту microSD і хочете, щоб журнал file числа, щоб почати спочатку.
  • Новий символ керування – ця опція дозволяє користувачеві ввести символ, такий як CTRL+z або $, і встановити його як новий символ керування. Цей параметр скидається до CTRL+z під час аварійного скидання.
  • Кількість escape-символів – ця опція дозволяє користувачеві ввести символ (наприклад, 1, 3 або 17), оновлюючи нову кількість escape-символів, необхідних для переходу в командний режим. Наприкладampтобто, введення числа 8 вимагатиме від користувача натиснути CTRL+z вісім разів, щоб перейти в командний режим. Цей параметр скидається до значення 3 під час аварійного скидання.
• Пояснення символів керування: Причина, чому OpenLog вимагає триразового натискання `CTRL+z` для переходу в командний режим, полягає в запобіганні випадковому перезавантаженню плати під час завантаження нового коду з Arduino IDE. Існує ймовірність того, що плата побачить символ `CTRL+z` під час завантаження (проблема, яку ми спостерігали в ранніх версіях прошивки OpenLog), тому ця функція спрямована на запобігання цьому. Якщо ви підозрюєте, що ваша плата була заблокована через це, ви завжди можете виконати екстрене скидання, утримуючи контакт RX на землі під час увімкнення живлення.

Конфігурація 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 IDE: 2400, 4800, 9600, 19200, 38400, 57600 та 115200. Ви можете використовувати інші швидкості передачі даних, але ви не зможете зв'язатися з OpenLog через монітор послідовного порту Arduino IDE.
• Escap:e Значення ASCII (у десятковому форматі) символу керування. 26 – це CTRL+z і є значенням за замовчуванням. 36 – це $ і є поширеним символом керування.
• Esc #: Необхідна кількість escape-символів. За замовчуванням це три, тому для переходу в командний режим потрібно натиснути escape-символ тричі. Допустимі значення від 0 до 254. Встановлення цього значення на 0 повністю вимкне перевірку escape-символів.
• Режим Системний режим. OpenLog запускається в режимі нового журналу (0) за замовчуванням. Допустимі значення: 0 = новий журнал, 1 = послідовний журнал, 2 = командний режим.
• Дієслово: Докладний режим. Розширені (детальні) повідомлення про помилки ввімкнено за замовчуванням. Встановлення цього значення на 1 вмикає докладні повідомлення про помилки (наприклад, невідома команда: видалити !). Встановлення цього значення на 0 вимикає докладні повідомлення про помилки, але реагуватиме символом !, якщо виникне помилка. Вимкнення докладного режиму зручно, якщо ви намагаєтеся обробляти помилки з вбудованої системи.
• Відлуння: Режим відлуння. У командному режимі символи відображаються за замовчуванням. Встановлення цього значення на 0 вимикає відлуння символів. Вимкнення цього параметра зручне для обробки помилок, і ви не хочете, щоб надіслані команди відображалися назад до OpenLog.II.
• iignoreRXEmergency Override. Зазвичай OpenLog виконує аварійне скидання, коли під час увімкнення живлення виводиться низький рівень на виводі RX. Встановлення цього параметра на 1 вимкне перевірку виводу RX під час увімкнення живлення. Це може бути корисним для систем, які з різних причин утримують низький рівень на лінії RX. Якщо аварійне перевизначення вимкнено, ви не зможете примусово повернути пристрій до 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.
• Недопустимі значення в конфігурації 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.

Усунення несправностей

Існує кілька різних варіантів перевірки, якщо у вас виникли проблеми з підключенням через монітор послідовного порту, проблеми з втраченими символами в журналах або боротьба з блокуванням OpenLog.

Перевірте поведінку світлодіода STAT1
Світлодіод STAT1 показує різну поведінку для двох різних поширених помилок.

• 3 миготіння: Не вдалося ініціалізувати карту microSD. Можливо, вам потрібно буде відформатувати карту у файловій системі FAT/FAT16 на комп’ютері.
• 5 миготінь: OpenLog змінив швидкість передачі даних і потребує повторного ввімкнення/вимкнення живлення.

Подвійна перевірка структури підкаталогів

• Якщо ви використовуєте стандартний OpenLog.ino exampОтже, OpenLog підтримуватиме лише два підкаталоги. Вам потрібно буде змінити FOLDER_TRACK_DEPTH з 2 на кількість підкаталогів, які потрібно підтримувати. Після цього перекомпілюйте код і завантажте змінену прошивку.
• Перевірте кількість Fileв кореневому каталозі
• OpenLog підтримуватиме лише до 65,534 XNUMX журналів. files у кореневому каталозі. Ми рекомендуємо переформатувати карту microSD, щоб покращити швидкість запису.
• Перевірте розмір модифікованої прошивки
• Якщо ви пишете власний ескіз для OpenLog, переконайтеся, що ваш ескіз не перевищує 32,256 500. Якщо так, він займатиме верхні XNUMX байт флеш-пам'яті, які використовуються послідовним завантажувачем Optiboot.
• Подвійна перевірка File імена
• всі file імена мають бути літерно-цифровими. MyLOG1.txt — це нормально, але Hi !e _ .txtt може не працювати.
• Використовуйте 9600 бод
• OpenLog працює на базі ATmega328 та має обмежений обсяг оперативної пам'яті (2048 байт). Коли ви надсилаєте послідовні символи до OpenLog, ці символи буферизуються. Спрощена специфікація SD Group дозволяє SD-карті записувати блок даних у флеш-пам'ять до 250 мс (розділ 4.6.2.2 Запис).
• При швидкості 9600 біт/с це становить 960 байт (10 біт на байт) за секунду. Це 1.04 мс на байт. OpenLog наразі використовує буфер прийому розміром 512 байт, тому може буферизувати близько 50 мс символів. Це дозволяє OpenLog успішно отримувати всі символи, що надходять зі швидкістю 9600 біт/с. Зі збільшенням швидкості передачі даних буфер працюватиме коротше.

Час переповнення буфера OpenLog

Багато SD-карт мають час запису швидше, ніж 250 мс. На це може впливати «клас» карти та обсяг даних, що вже зберігаються на карті. Рішенням є використання нижчої швидкості передачі даних або збільшення часу між символами, що надсилаються з вищою швидкістю передачі даних.

Часті запитання