Тэхнічныя характарыстыкі

• Назва прадукту: Рэгістратар дадзеных 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)

Інструкцыя па ўжыванні прадукту

Неабходныя матэрыялы:

• Arduino Pro Mini 328 – 3.3 В/8 МГц
• Базавы раз'ём SparkFun FTDI – 3.3 В
• USB-кабель SparkFun Cerberus – 6 м
• Карта microSD з адаптарам – 16 ГБ (клас 10)
• USB-счытвальнік microSD
• Жаночыя загалоўкі
• Перамычкі прэміум-класа, 6 сярэдніх/сярэдніх памераў, упакоўка з 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 — Гэты эксample паказвае, як стварыць і дадаць 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 з ATmega328» у Arduino IDE.

• Як ужо згадвалася раней, 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, каб адвольна задаваць памер буфераў перадачы і прыёму. OpenLog патрабуе, каб буфер перадачы быў вельмі маленькім (0), а буфер прыёму — як мага большым.
• Сумеснае выкарыстанне гэтых двух мадыфікаваных бібліятэк дазваляе павысіць прадукцыйнасць 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 у байтах.
  • Example: памер Log112.csv
  • Выхад: 11
• Прачытайце File + ПАЧАТАК+ ТЫП ДАЎЖЫНІ – Вывесці змест File пачынаючы з START і працягваючы да LENGTH. Калі START прапушчаны, увесь file паведамляецца. Калі LENGTH прапушчаны, паведамляецца ўвесь змест з пачатковай кропкі. Калі TYPE прапушчаны, OpenLog па змаўчанні будзе паведамляць у ASCII. Ёсць тры выходныя тыпы (TYPE):
  • ASCII = 1
  • HEX = 2
  • RAW = 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 Падкаталог – Выдаляе падкаталог. Каб гэтая каманда працавала, каталог павінен быць пустым.
  • Exampле: тэмпература ў сярэднім
• rm -rf Каталог – Выдаляе каталог і ўсе fileякія змяшчаюцца ў ім.
  • Example: rm -rf Бібліятэкі

Каманды нізкаўзроўневых функцый

• ? – Гэтая каманда адлюструе спіс даступных каманд у OpenLog.
• Дыск – Паказвае ідэнтыфікатар вытворцы карты, серыйны нумар, дату вытворчасці і памер карты. Напрыкладampвыхадны вынік:
  • Тып карты: SD2 Ідэнтыфікатар вытворцы: 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 будзе адказваць толькі сімвалам !, калі ёсць памылка, а не невядомай камандай: C OMMAND.D..T Сімвалы he лягчэй аналізаваць убудаванымі сістэмамі, чым поўныя паведамленні пра памылку. Калі вы выкарыстоўваеце тэрмінал, пакінуўшы падрабязны рэжым уключаным, вы зможаце бачыць поўныя паведамленні пра памылкі.
• бод – Гэтая каманда адкрые сістэмнае меню, якое дазволіць карыстальніку ўвесці хуткасць перадачы дадзеных. Падтрымліваецца любая хуткасць перадачы дадзеных ад 300 біт/с да 1 Мбіт/с. Выбар хуткасці перадачы дадзеных адбываецца імгненна, і для таго, каб налады ўступілі ў сілу, OpenLog патрабуе выключэння і аднаўлення харчавання. Хуткасць перадачы дадзеных захоўваецца ў EEPROM і загружаецца кожны раз пры ўключэнні OpenLog. Значэнне па змаўчанні — 9600 8N1.

Памятайце: Калі плата затрымалася на невядомай хуткасці перадачы дадзеных, можна падключыць RX да GND і ўключыць OpenLog. Святлодыёды будуць міргаць туды-сюды на працягу 2 секунд, а затым будуць міргаць адначасова. Выключыце OpenLog і зніміце перамычку. Цяпер хуткасць OpenLog скідаецца да 9600 біт/с пры тройным націсканні сімвала выхаду `CTRL-Z`. Гэтую функцыю можна адключыць, усталяваўшы біт аварыйнага пераключэння ў 1. Глядзіце 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, калі яго там яшчэ няма, і дадае любыя атрыманыя дадзеныя ў 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 (у дзесятковым фармаце) сімвала escape. 26 — гэта CTRL+z і з'яўляецца сімвалам па змаўчанні. 36 — гэта $ і з'яўляецца часта выкарыстоўваным сімвалам escape.
• 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 мс. На гэта можа паўплываць «клас» карты і аб'ём дадзеных, якія ўжо захоўваюцца на карце. Рашэннем з'яўляецца выкарыстанне больш нізкай хуткасці перадачы дадзеных або павелічэнне часу паміж сімваламі, якія адпраўляюцца з больш высокай хуткасцю перадачы дадзеных.

Часта задаюць пытанні