Кіраўніцтва па падключэнні OpenLog

Уводзіны

Увага! Гэты падручнік прызначаны для Open Log для паслядоўнага UART [DEV-13712]. Калі вы выкарыстоўваеце Qwiic OpenLog для IC [DEV-15164], звярніцеся да кіраўніцтва па падключэнні Qwiic OpenLog.
Рэгістратар даных OpenLog — гэта простае ў выкарыстанні рашэнне з адкрытым зыходным кодам для рэгістрацыі паслядоўных даных з вашых праектаў. OpenLog забяспечвае просты паслядоўны інтэрфейс для рэгістрацыі даных з праекта на карту microSD.SparkFun OpenLog
• DEV-13712SparkFun OpenLog з загалоўкамі
• DEV-13955

тавар не знойдзены
Неабходныя матэрыялы
Каб цалкам азнаёміцца ​​з гэтым кіраўніцтвам, вам спатрэбяцца наступныя кампаненты. Аднак вам можа спатрэбіцца не ўсё, у залежнасці ад таго, што ў вас ёсць. Дадайце ўсё ў кошык, прачытайце кіраўніцтва і пры неабходнасці адкарэктуйце кошык.
Кіраўніцтва па падключэнні OpenLog Спіс пажаданняў SparkFun

	Arduino Pro Mini 328 – 3.3 В/8 МГц DEV-11114 Ён сіні! Ён тонкі! Гэта Arduino Pro Mini! Мінімалістычны падыход SparkFun да дызайну Arduino. Гэта Arduino на 3.3 В…
	Базавы раз'ём SparkFun FTDI – 3.3 В DEV-09873 Гэта найноўшая версія нашага [FTDI Basic](http://www.sparkfun.com/commerce/product_info.php?products_id= ...
	USB-кабель SparkFun Cerberus – 6 м КАБ-12016 У вас няправільны USB-кабель. Не мае значэння, які ў вас, гэта няправільны. Але што, калі б вы маглі мець…
	SparkFun OpenLog DEV-13712 SparkFun OpenLog — гэта рэгістратар дадзеных з адкрытым зыходным кодам, які працуе праз простае паслядоўнае злучэнне і падтрымлівае мікра...
	Карта microSD з адаптарам – 16 ГБ (клас 10) COM-13833 Гэта карта памяці microSD класа 10 аб'ёмам 16 ГБ, ідэальна падыходзіць для аперацыйных сістэм аднаплатных кампутараў...
	USB-счытвальнік microSD COM-13004 Гэта цудоўны маленькі USB-рыдэр для карт microSD. Проста ўстаўце карту microSD у USB-раздым, і…
	Жаночыя загалоўкі ПРТ-00115 Адзін рад 40-адтуліннай разеткі з жаночым раз'ёмам. Можна парэзаць па памеры кусачкамі. Стандартная адлегласць паміж адтулінамі 1 цалі. Мы выкарыстоўваем…
	Перамычкі прэміум-класа, 6 цаляў, сярэдні/средні, упакоўка з 10 штук ПРТ-08431 Гэта эксклюзіў ад SparkFun! Гэта перамычкі даўжынёй 155 мм з мужчынскімі раздымамі на абодвух канцах. Выкарыстоўвайце іх, каб…
	Адрыўныя мужчынскія загалоўкі – прамы кут ПРТ-00553 Шэраг прамавугольных мужчынскіх раз'ёмаў — ламаюцца для падбору. 40 кантактаў, якія можна абрэзаць па любым памеры. Выкарыстоўваюцца з заказнымі друкаванымі платамі або генератарамі…

Рэкамендуецца прачытаць
Калі вы не знаёмыя або не адчуваеце сябе камфортна з наступнымі канцэпцыямі, мы рэкамендуем азнаёміцца ​​з імі, перш чым працягнуць чытанне Кіраўніцтва па падключэнні OpenLog.
Як паяць: пайка праз адтуліну
У гэтым уроку вы знойдзеце ўсё, што вам трэба ведаць пра пайку праз адтуліны.
Паслядоўны перыферыйны інтэрфейс (SPI)
SPI звычайна выкарыстоўваецца для падлучэння мікракантролераў да перыферыйных прылад, такіх як датчыкі, рэгістраў зруху і SD-карт.
Паслядоўная сувязь
Канцэпцыі асінхроннай паслядоўнай сувязі: пакеты, узроўні сігналу, хуткасць перадачы дадзеных, UART і многае іншае!
Асновы паслядоўнага тэрмінала
У гэтым уроку вы даведаецеся, як мець зносіны з паслядоўнымі прыладамі з дапамогай розных праграм эмулятара тэрмінала.

Абсталяванне скончанаview

Магутнасць
OpenLog працуе з наступнымі наладах:
Паказчыкі магутнасці OpenLog

Уваход VCC	3.3 В–12 В (рэкамендуецца 3.3 В–5 В)
Уваход RXI	2.0В-3.8В
Выхад перадатчыка	3.3В
Ток халастога ходу	~2 мА-5 мА (без карты microSD), ~5 мА-6 мА (з картай microSD)
Ток актыўнага запісу	~20-23 мА (з картай microSD)

Спажыванне току 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

Статус LED
На 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 павінны выглядаць наступным чынам.
На дыяграме Фрыцынга паказаны 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.h 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 названы File у бягучым каталогу. Стандарт 8.3 fileімёны падтрымліваюцца.
  Напрыкладampнапрыклад, «87654321.123» прымальны, а «987654321.123» — не.
  • Прampле: новы file1.txt
• дадаць File – Дадаць тэкст у канец FileЗатым паслядоўныя дадзеныя зчытваюцца з UART у патоку і дадаюцца ў fileГэта не перадаецца праз паслядоўны тэрмінал. Калі File не існуе, калі выклікаецца гэтая функцыя, file будзе створана.
  • Прample: дадаць новыfile.csv
• пісаць File ЗРУШЭННЕ – Напісаць тэкст у File ад месцазнаходжання OFFSET у межах fileТэкст зчытваецца з UART радок за радком і перадаецца назад. Каб выйсці з гэтага стану, адпраўце пусты радок.
  • Прample: запіс logs.txt 516
• rm File – Выдаляе File з бягучага каталога. Падтрымліваюцца шаблоны падстаноўкі.
  • Прampфайл: rm README.txt
• памер File – Памер выхаднога сігналу File у байтах.
  • Прample: памер Log112.csv
  • Выхад: 11
• чытаць File + ПАЧАТАК+ ТЫП ДАЎЖЫНІ – Вывесці змест File пачынаючы з ПАЧАТКУ і працягваючы ДАЎЖЫНЮ.
  Калі START прапушчаны, увесь file паведамляецца. Калі LENGTH прапушчаны, паведамляецца ўвесь змест з пачатковай кропкі. Калі TYPE прапушчаны, OpenLog па змаўчанні будзе паведамляць у ASCII. Ёсць тры выходныя тыпы (TYPE):
  • ASCII = 1
  • HEX = 2
  • RAW = 3
  Вы можаце прапусціць некаторыя заключныя аргументы. Праверце наступны прыкладampлес.
  Базавыя сцягі чытання + прапушчаныя:
  • Прample: прачытаць LOG00004.txt
  • Выхад: Акселерометр X=12 Y=215 Z=317
  Чытаць з пачатку 0 з даўжынёй 5:
  • Прample: прачытаць LOG00004.txt 0 5
  • Выхад: Паскарэнне
  Чытаць з пазіцыі 1 даўжынёй 5 у шаснаццатковым фармаце:
  • Прample: прачытаць LOG00004.txt 1 5 2
  • Выхад: 63 63 65 6C
• Чытаць з пазіцыі 0 даўжынёй 50 у RAW:
• • Прample: прачытаць LOG00137.txt 0 50 3
• • Вынік: Андрэ– -þ Пашыраны тэст на характар
• кошка File – Напішыце змест file у шаснаццатковым выглядзе да паслядоўнага манітора для viewінг. Часам карысна бачыць, што file запісвае правільна без неабходнасці вымаць SD-карту і view у file на кампутары.
  • Прampфайл: cat LOG00004.txt
  • Вывад: 00000000: 41 63 65 6c 3a 20 31

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

• ls – Выводзіць увесь змест бягучага каталога. Падтрымліваюцца шаблоны падстаноўкі.
  • Прampле: лс
  • Вывад: \src
• Падкаталог md – Стварыць падкаталог у бягучым каталогу.
  • Прample: md Example_Sketches
• Падкаталог cd – Змяніць на падкаталог.
  • Прample: cd Прывітанне_Свет
• cd .. – Пераход у ніжэйшы каталог у дрэве. Звярніце ўвагу, што паміж «cd» і «..» ёсць прабел. Гэта дазваляе парсеру радкоў бачыць каманду cd.
  • Прampле: кампакт-дыск ..
• rm Падкаталог – Выдаляе падкаталог. Каб гэтая каманда працавала, каталог павінен быць пустым.
  • Прampле: тэмпература ў сярэднім
• rm -rf Каталог – Выдаляе каталог і любыя fileякія змяшчаюцца ў ім.
  • Прample: rm -rf Бібліятэкі

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

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

Налады сістэмы

Гэтыя налады можна абнавіць уручную або адрэдагаваць у файле config.txt file.

• echo STATE – Змяняе стан сістэмнага echo і захоўваецца ў сістэмнай памяці. STATE можа быць як уключаны, так і выключаны. Калі , OpenLog будзе адлюстроўваць атрыманыя паслядоўныя даныя ў камандным радку. Калі выключаны, сістэма не зчытвае атрыманыя сімвалы.
  Заўвага: Падчас звычайнага запісу ў журнал рэха будзе адключана. Патрабаванні да сістэмных рэсурсаў для рэха атрыманых дадзеных занадта высокія падчас запісу ў журнал.
• падрабязны STATE – Змяняе стан падрабязных паведамленняў пра памылкі. STATE можа быць як уключаны, так і выключаны. Гэта каманда захоўваецца ў памяці. Пры адключэнні падрабязных паведамленняў пра памылкі OpenLog будзе адказваць толькі сімвалам !, калі ёсць памылка, а не невядомай камандай: COMMAND. Сімвал ! лягчэй апрацоўваць убудаванымі сістэмамі, чым поўная памылка. Калі вы выкарыстоўваеце тэрмінал, пакінуўшы падрабязны рэжым уключаным, вы зможаце бачыць поўныя паведамленні пра памылкі.
• бод – Гэтая каманда адкрые сістэмнае меню, якое дазволіць карыстальніку ўвесці хуткасць перадачы дадзеных. Падтрымліваецца любая хуткасць перадачы дадзеных ад 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.
• escape: Значэнне ASCII (у дзесятковым фармаце) сімвала escape. 26 — гэта CTRL+z і з'яўляецца сімвалам па змаўчанні. 36 — гэта $ і з'яўляецца часта выкарыстоўваным сімвалам escape.
• esc#: Неабходная колькасць escape-сімвалаў. Па змаўчанні гэта тры, таму для пераходу ў камандны рэжым трэба націснуць escape-сімвал тры разы. Дапушчальныя значэнні — ад 0 да 254. Устаноўка гэтага значэння на 0 цалкам адключыць праверку escape-сімвалаў.
• рэжым: сістэмны рэжым. OpenLog па змаўчанні запускаецца ў рэжыме новага журнала (0). Дапушчальныя значэнні: 0 = новы журнал, 1 = паслядоўны журнал, 2 = камандны рэжым.
• дзеяслоў: Падрабязны рэжым. Пашыраныя (падрабязныя) паведамленні пра памылкі ўключаны па змаўчанні. Устаноўка значэння 1 уключае падрабязныя паведамленні пра памылкі (напрыклад, невядомая каманда: выдаліць !). Устаноўка значэння 0 выключае падрабязныя паведамленні пра памылкі, але ў выпадку памылкі будзе выдадзены сімвал !. Адключэнне падрабязнага рэжыму зручна, калі вы спрабуеце апрацоўваць памылкі з убудаванай сістэмы.
• echo: Рэжым адлюстравання. У камандным рэжыме сімвалы адлюструюцца па змаўчанні. Устаноўка гэтага значэння ў 0 адключае адлюстраванне сімвалаў. Адключэнне гэтага зручна, калі вы апрацоўваеце памылкі і не хочаце, каб адпраўленыя каманды адлюстраваліся назад у OpenLog.
• ignoreRX: Аварыйнае перавызначэнне. Звычайна 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 _.txt можа не працаваць.
Выкарыстоўваць 9600 бод
OpenLog працуе на базе ATmega328 і мае абмежаваны аб'ём аператыўнай памяці (2048 байт). Пры адпраўцы паслядоўных сімвалаў у OpenLog яны буферызуюцца. Спрошчаная спецыфікацыя SD Group дазваляе SD-карце запісаць блок дадзеных у флэш-памяць за 250 мс (раздзел 4.6.2.2 Запіс).
Пры хуткасці 9600 біт/с гэта складае 960 байт (10 біт на байт) у секунду. Гэта 1.04 мс на байт. OpenLog у цяперашні час выкарыстоўвае буфер прыёму памерам 512 байт, таму ён можа буферызаваць каля 50 мс сімвалаў. Гэта дазваляе OpenLog паспяхова атрымліваць усе сімвалы, якія паступаюць са хуткасцю 9600 біт/с. Пры павелічэнні хуткасці перадачы дадзеных буфер будзе захоўвацца менш часу.
Час перапаўнення буфера OpenLog

Хуткасць перадачы дадзеных	Час на байт	Час да перапаўнення буфера
9600 біт/с	1.04 мс	532 мс
57600 біт/с	0.174 мс	88 мс
115200 біт/с	0.087 мс	44 мс

Многія SD-карты маюць час запісу хутчэйшы за 250 мс. На гэта можа паўплываць «клас» карты і аб'ём дадзеных, якія ўжо захоўваюцца на карце. Рашэннем з'яўляецца выкарыстанне больш нізкай хуткасці перадачы дадзеных або павелічэнне часу паміж сімваламі, якія адпраўляюцца з больш высокай хуткасцю перадачы дадзеных.
Адфарматуйце карту MicroSD
Памятайце, што трэба выкарыстоўваць карту з невялікай колькасцю або без яе fileна ім. Карта microSD з ZIP-архівам аб'ёмам 3.1 ГБ files або MP3-файлы маюць больш павольны час водгуку, чым пустая карта.
Калі вы не фарматавалі карту microSD у аперацыйнай сістэме Windows, перафарматуйце яе і стварыце файл DOS. fileсістэма на SD-карце.
Замена карт MicroSD
Існуе мноства розных вытворцаў картак, карт з перамаркіроўкай, памерамі і класамі карт, і не ўсе яны могуць працаваць належным чынам. Звычайна мы выкарыстоўваем карту microSD класа 8 на 4 ГБ, якая добра працуе са хуткасцю 9600 біт/с. Калі вам патрэбна больш высокая хуткасць перадачы дадзеных або больш месца для захоўвання, вы можаце паспрабаваць карты класа 6 або вышэй.
Дадаць затрымкі паміж запісамі сімвалаў
Дадаўшы невялікую затрымку паміж аператарамі Serial.print(), вы можаце даць OpenLog магчымасць запісаць бягучы
буфер.
Напрыкладampль:
Serial.begin(115200);
для(int i = 1; i < 10; i++) {
Serial.print(i, DEC);
Серыйны.println(“:abcdefghijklmnopqrstuvwxyz-!#”);
}

можа не запісвацца належным чынам, бо побач адпраўляецца шмат сімвалаў. Устаўка невялікай затрымкі ў 15 мс паміж запісамі вялікіх сімвалаў дапаможа OpenLog запісваць без страты сімвалаў.
Serial.begin(115200);
для(int i = 1; i < 10; i++) {
Serial.print(i, DEC);
Серыйны.println(“:abcdefghijklmnopqrstuvwxyz-!#”);
затрымка(15);
}

Дадаць сумяшчальнасць манітора паслядоўнага порта Arduino
Калі вы спрабуеце выкарыстоўваць OpenLog з убудаванай бібліятэкай паслядоўнага порта або бібліятэкай SoftwareSerial, вы можаце сутыкнуцца з праблемамі ў камандным рэжыме. Serial.println() адпраўляе як сімвал новага радка, так і сімвал вяртання карэткі. Ёсць дзве альтэрнатыўныя каманды для вырашэння гэтай праблемы.
Першы спосаб — выкарыстоўваць каманду \r (вяртанне карэткі ASCII):
Серыйны.друк(“ТЭКСТ\r”);
Акрамя таго, вы можаце адправіць значэнне 13 (дзесятковы сімвал вяртання карэткі):
Serial.print(“ТЭКСТ”);
Serial.write(13);

Аварыйны скід
Памятайце, што калі вам трэба скінуць OpenLog да стану па змаўчанні, вы можаце скінуць налады платы, падключыўшы кантакт RX да GND, уключыўшы OpenLog, пачакаўшы, пакуль святлодыёды пачнуць міргаць адначасова, а затым выключыўшы OpenLog і зняўшы перамычку.
Калі вы змянілі біт аварыйнага адключэння на 1, вам трэба будзе змяніць канфігурацыю file, бо аварыйны скід не будзе працаваць.
Звярніцеся ў супольнасць
Калі ў вас усё яшчэ ёсць праблемы з вашым OpenLog, калі ласка, азнаёмцеся з бягучымі і закрытымі праблемамі ў нашым рэпазітарыі GitHub тут. З OpenLog працуе вялікая супольнасць, таму, хутчэй за ўсё, хтосьці знайшоў выпраўленне праблемы, з якой вы сутыкаецеся.

Рэсурсы і далейшыя крокі

Цяпер, калі вы паспяхова запісалі дадзеныя з дапамогай OpenLog, вы можаце ствараць аддаленыя праекты і кантраляваць усе магчымыя паступаючыя дадзеныя. Падумайце аб стварэнні ўласнага праекта Citizen Science або нават трэкера для хатніх жывёл, каб паглядзець, што робіць Флафі, калі ён знаходзіцца па-за домам!
Азнаёмцеся з гэтымі дадатковымі рэсурсамі для пошуку і ліквідацыі непаладак, атрымання дапамогі або натхнення для вашага наступнага праекта.

• OpenLog GitHub
• Праект Illumitune
• Падключэнне датчыка асвятлення LilyPad
• BadgerHack: Дадатак да датчыка глебы
• Пачатак працы з OBD-II
• Фотабрама Верньера

Патрэбна яшчэ натхнення? Азнаёмцеся з некаторымі з гэтых падобных урокаў:
Датчык узроўню вады Photon з дыстанцыйным кіраваннем
Даведайцеся, як пабудаваць дыстанцыйны датчык узроўню вады для рэзервуара для захоўвання вады і як аўтаматызаваць помпу на аснове паказанняў!
Датчык узроўню вады Photon з дыстанцыйным кіраваннем
Даведайцеся, як пабудаваць дыстанцыйны датчык узроўню вады для рэзервуара для захоўвання вады і як аўтаматызаваць помпу на аснове паказанняў!
Запіс дадзеных у Google Табліцы з дапамогай Tessel 2
Гэты праект апісвае, як двума спосабамі запісваць дадзеныя ў Google Табліцы: з дапамогай IFTTT з web падключэнне або USB-флэшку і «sneakernet» без іх.
Графікі дадзеных датчыкаў з дапамогай Python і Matplotlib
Выкарыстоўвайце matplotlib для стварэння графіка тэмпературных дадзеных у рэжыме рэальнага часу, сабраных з датчыка TMP102, падлучанага да Raspberry Pi.
Калі ў вас ёсць якія-небудзь водгукі аб падручніку, калі ласка, наведайце каментарыі або звяжыцеся з нашай службай тэхнічнай падтрымкі па адрасе TechSupport@sparkfun.com.

Дакументы / Рэсурсы

Платы распрацоўкі SparkFun DEV-13712 [pdfКіраўніцтва карыстальніка DEV-13712, DEV-11114, DEV-09873, CAB-12016, COM-13833, COM-13004, PRT-00115, PRT-08431, DEV-13712 Мадэльныя платы SparkFun, DEV-13712, Мадэльныя платы SparkFun, Мадэльныя платы, Платы

Спасылкі

• Кіраўніцтва карыстальніка