spésifikasi

• Ngaran produk: OpenLog Data Logger
• Modél: DEV-13712
• Input kakuatan: 3.3V-12V (Disarankeun 3.3V-5V)
• RXI Input Voltage: 2.0V-3.8V
• TXO Kaluaran Voltagieu: 3.3v
• Idle Current Draw: ~2mA-5mA (tanpa kartu microSD), ~5mA-6mA (kalayan kartu microSD)
• Tulisan Aktif Draw Ayeuna: ~ 20-23mA (kalayan kartu microSD)

Parentah Pamakéan Produk

Bahan diperlukeun:

• Arduino Pro Mini 328 - 3.3V / 8MHz
• SparkFun FTDI Dasar Breakout - 3.3V
• Kabel USB SparkFun Cerberus - 6ft
• Kartu microSD sareng adaptor - 16GB (Kelas 10)
• microSD USB Reader
• Headers bikang
• Jumper Wires Premium 6 M/M Paket 10
• Megatkeun jauh lulugu jalu - sudut katuhu

Disarankeun Bacaan:

• Kumaha Solder: Ngaliwatan-liang Soldering
• Dasar Komunikasi Serial
• Serial Peripheral Interface (SPI)
• Dasar Terminal Serial

Hardware Leuwihview:
OpenLog dijalankeun dina setélan ieu:

Bubuka

Mastaka tegak! Tutorial ieu kanggo Open Log pikeun serial UART [DEV-13712]. Upami Anjeun keur make Qwiic OpenLog pikeun IC [DEV-15164], mangga tingal Qwiic OpenLog Hookup Guide.

OpenLog Data Logger mangrupikeun solusi open-source anu saderhana pikeun ngarékam data séri tina proyék anjeun. OpenLog nyadiakeun antarbeungeut serial basajan pikeun log data tina hiji proyék ka kartu microSD.

SparkFun OpenLog
DEV-13712

SparkFun OpenLog sareng Headers
DEV-13955

Taya produk kapanggih

Bahan Diperlukeun
Pikeun pinuh ngerjakeun tutorial ieu, anjeun peryogi bagian-bagian di handap ieu. Anjeun panginten henteu peryogi sadayana sanaos gumantung kana naon anu anjeun gaduh. Tambihkeun kana karanjang anjeun, baca pituduh, sareng saluyukeun karanjang upami diperyogikeun.

OpenLog Hookup Guide

Daptar Kahayang SparkFun

Disarankeun Bacaan
Mun anjeun teu wawuh atawa teu nyaman jeung konsép di handap ieu, kami nyarankeun maca ngaliwatan ieu saméméh nuluykeun on kalawan OpenLog Hookup Guide.

• Kumaha Solder: Ngaliwatan-liang Soldering. tutorial ieu nyertakeun sagalana nu peryogi kauninga ngeunaan soldering ngaliwatan-liang.
• Komunikasi Serial Konsep komunikasi serial Asynchronous: pakét, tingkat sinyal, ongkos baud, UARTs, sarta leuwih!
• Serial Peripheral Interface (SPI) SPI biasana dianggo pikeun nyambungkeun mikrokontroler ka périferal sapertos sénsor, register shift, sareng kartu SD.
• Dasar Terminal Serial Tutorial ieu bakal nunjukkeun anjeun kumaha komunikasi sareng alat séri anjeun nganggo rupa-rupa aplikasi émulator terminal.

Hardware Leuwihview

Kakuatan
OpenLog dijalankeun dina setélan ieu:

OpenLog Power Ratings

Tarikan OpenLog ayeuna sakitar 20mA dugi ka 23mA nalika nyerat kana microSD. Gumantung kana ukuran kartu microSD sarta produsén na, draw ayeuna aktif bisa rupa-rupa nalika OpenLog keur nulis ka kartu memori. Ngaronjatkeun laju baud ogé bakal narik langkung ayeuna.

Mikrokontroler
OpenLog ngajalankeun ATmega328 onboard, dijalankeun dina 16MHz, hatur nuhun kana kristal onboard. ATmega328 gaduh bootloader Optiboot dimuat dina éta, anu ngamungkinkeun OpenLog cocog sareng
Setélan dewan "Arduino Uno" dina Arduino IDE.

Panganteur

Serial UART
Antarbeungeut primér sareng OpenLog nyaéta lulugu FTDI di tepi dewan. Header ieu dirancang pikeun nyolok langsung kana Arduino Pro atanapi Pro Mini, anu ngamungkinkeun mikrokontroler ngirim data liwat sambungan séri ka OpenLog.

Awas! Kusabab pin mesen nu ngajadikeun eta cocog sareng Arduinos, eta teu bisa nyolok langsung kana dewan breakout FTDI.

Kanggo inpo nu leuwih lengkep, pastikeun pikeun pariksa kaluar bagian salajengna dina Hardware Hookup.

SPI

Aya ogé opat titik uji SPI pegat kaluar dina tungtung sabalikna dewan. Anjeun tiasa nganggo ieu pikeun ngaprogram ulang bootloader dina ATmega328.

• The OpenLog panganyarna (DEV-13712) megatkeun kaluar pin ieu dina leutik plated ngaliwatan liang. Upami anjeun kedah nganggo ISP pikeun ngaprogram ulang atanapi unggah bootloader énggal ka OpenLog, anjeun tiasa nganggo pin pogo pikeun nyambung ka titik uji ieu.
• Antarbeungeut ahir pikeun komunikasi sareng OpenLog nyaéta kartu microSD sorangan. Pikeun komunikasi, kartu microSD merlukeun pin SPI. Henteu ngan ieu dimana data disimpen ku OpenLog, tapi anjeun ogé tiasa ngamutahirkeun konfigurasi OpenLog urang via config.txt. file dina kartu microSD.
  Kartu microSD

Sadaya data anu diasupkeun ku OpenLog disimpen dina kartu microSD. OpenLog tiasa dianggo sareng kartu microSD anu gaduh fitur ieu:

• 64MB dugi ka 32GB
• FAT16 atanapi FAT32

Aya dua status LEDs on OpenLog pikeun mantuan Anjeun ku ngungkulan.

• STAT1 - LED indikator biru ieu napel Arduino D5 (ATmega328 PD5) jeung toggles on / off lamun karakter anyar narima. LED ieu kedip-kedip nalika komunikasi serial berpungsi.
• STAT2 - LED héjo ieu disambungkeun ka Arduino D13 (SPI Serial Jam Line / ATmega328 PB5). LED Ieu ngan blinks lamun panganteur SPI aktip. Anjeun bakal ningali éta lampu kilat nalika OpenLog ngarékam 512 bait ka kartu microSD.

Hardware Hookup

Aya dua metodeu utama pikeun nyambungkeun OpenLog anjeun ka sirkuit. Anjeun peryogi sababaraha header atanapi kabel pikeun nyambungkeun. Pastikeun yén anjeun solder ka dewan pikeun sambungan aman.

Sambungan Serial Dasar

Tip: Upami Anjeun gaduh lulugu bikang dina OpenLog sarta lulugu bikang dina FTDI, Anjeun bakal peryogi M / F jumper kawat pikeun nyambungkeun.

sambungan hardware ieu dirancang pikeun interfacing kalawan OpenLog lamun perlu reprogram dewan atawa log data ngaliwatan sambungan serial dasar.

Jieun sambungan handap:
OpenLog → 3.3V FTDI Breakout Dasar

• GND → GND
• GND → GND
• VCC → 3.3V
• TXO → RXI
• RXI → TXO
• DTR → DTR

Perhatikeun yén éta sanés sambungan langsung antara FTDI sareng OpenLog - anjeun kedah ngalihkeun sambungan pin TXO sareng RXI.

Sambungan anjeun kedah sapertos kieu:

Sakali anjeun gaduh sambungan antara OpenLog sareng FTDI Basic, colokkeun papan FTDI anjeun kana kabel USB sareng komputer anjeun. Buka terminal séri, sambungkeun ka port COM FTDI Basic anjeun, sareng angkat ka kota!

Proyék Sambungan Hardware

Tip: Upami Anjeun gaduh headers bikang soldered on OpenLog, Anjeun tiasa solder headers jalu ka Arduino Pro Mini pikeun nyolok papan babarengan tanpa perlu kawat.

Bari interfacing jeung OpenLog ngaliwatan sambungan serial penting pikeun reprogramming atanapi debugging, tempat dimana OpenLog bersinar aya dina proyék embedded. Circuit umum ieu kumaha urang nyarankeun Anjeun Hook up OpenLog anjeun ka mikrokontroler a (dina hal ieu, Arduino Pro Mini) anu bakal nulis data serial kaluar ka OpenLog.

Mimiti, anjeun kedah unggah kodeu kana Pro Mini anjeun anu anjeun badé jalankeun. Mangga parios sketsa Arduino pikeun sababaraha example kode nu bisa Anjeun pake.

Catetan: Upami anjeun henteu yakin kumaha program Pro Mini anjeun, mangga parios tutorial kami di dieu.

Ngagunakeun Arduino Pro Mini 3.3V

• Tutorial ieu mangrupikeun pituduh anjeun pikeun sagala hal Arduino Pro Mini. Éta ngajelaskeun naon éta, naon anu henteu, sareng kumaha cara ngamimitian ngagunakeunana.
• Sakali anjeun geus diprogram Pro Mini Anjeun, Anjeun bisa nyabut dewan FTDI jeung ngaganti eta jeung OpenLog. Pastikeun nyambungkeun pin anu dilabélan BLK dina Pro Mini sareng OpenLog (pin anu dilabélan GRN dina duanana ogé bakal cocog upami dilakukeun leres).
• Upami anjeun henteu tiasa nyolok OpenLog langsung kana Pro Mini (kusabab header anu teu cocog atanapi papan anu sanés), anjeun tiasa nganggo kabel jumper sareng ngadamel sambungan di handap ieu.

OpenLog → Arduino Pro / Arduino Pro Mini

• GND → GND
• GND → GND
• VCC → VCC
• TXO → RXI
• RXI → TXO
• DTR → DTR

Saatos réngsé, sambungan anjeun kedah sapertos kieu sareng Arduino Pro Mini sareng Arduino Pro. Diagram Fritzing nembongkeun OpenLogs kalawan headers mirrored. Lamun flip stop kontak microSD relatif ka luhur Arduino urang view, aranjeunna kedah cocog lulugu programming kawas hiji FTDI.

Catet yén sambungan téh makéna lempeng jeung OpenLog "tibalik-handap" (jeung microSD nyanghareup ka luhur).

Catetan: Kusabab Vcc sareng GND antara OpenLog sareng Arduino dijajah ku header, anjeun kedah nyambungkeun kakuatan ka pin sanés anu aya dina Arduino. Upami teu kitu, anjeun tiasa solder kawat ka pin kakuatan kakeunaan dina boh dewan.

Dayakeun sistem anjeun, sareng anjeun siap ngamimitian log!

Arduino Sketsa

Aya genep ex bédaample sketsa kaasup nu bisa Anjeun pake dina Arduino nalika disambungkeun ka OpenLog.

• OpenLog_Benchmarking - Ieu example dipaké pikeun nguji OpenLog. Ieu ngirimkeun jumlahna ageung pisan data dina 115200bps leuwih sababaraha files.
• OpenLog_CommandTest - Ieu example nembongkeun kumaha carana nyieun sarta append a file via kontrol garis paréntah ngaliwatan Arduino.
• OpenLog_ReadExample - ex ieuample ngalir ngaliwatan cara ngadalikeun OpenLog via garis paréntah.
• OpenLog_ReadExample_GedéFile — Misalample tina cara muka badag disimpen file dina OpenLog sareng laporkeun kana sambungan Bluetooth lokal.
• OpenLog_Test_Sketch - Dipaké pikeun nguji OpenLog kalayan seueur data séri.
• OpenLog_Test_Sketch_Binary - Dipaké pikeun nguji OpenLog ku data binér sareng karakter kabur.

Firmware

OpenLog ngagaduhan dua perangkat lunak utama dina kapal: bootloader sareng firmware.

Arduino Bootloader

Catetan: Upami anjeun nganggo OpenLog anu dibeuli sateuacan Maret 2012, bootloader onboard cocog sareng "Arduino Pro atanapi Pro Mini 5V / 16MHz w / ATmega328" dina Arduino IDE.

• Sakumaha anu disebatkeun sateuacana, OpenLog ngagaduhan bootloader serial Optiboot. Anjeun tiasa ngarawat OpenLog sapertos Arduino Uno nalika unggah exampkode le atanapi firmware anyar pikeun dewan.
• Upami anjeun ngabatalkeun OpenLog anjeun sareng kedah pasang deui bootloader, anjeun ogé hoyong unggah Optiboot kana papan. Mangga parios tutorial kami ngeunaan masang Arduino Bootloader kanggo inpormasi anu langkung lengkep.

Nyusun sareng Ngamuat Firmware kana OpenLog

Catetan: Upami ieu pertama kalina anjeun nganggo Arduino, punten ulangview tutorial urang dina masang Arduino IDE. Upami anjeun teu acan kantos masang perpustakaan Arduino, mangga parios pituduh instalasi kami pikeun masang perpustakaan sacara manual.

• Upami alesan naon waé anjeun kedah ngapdet atanapi pasang deui firmware dina OpenLog anjeun, prosés di handap ieu bakal ngajantenkeun papan anjeun sareng jalan.
• Kahiji, mangga undeur Arduino IDE v1.6.5. Vérsi séjén IDE bisa dianggo pikeun compile firmware OpenLog, tapi kami geus diverifikasi ieu salaku versi alus dipikawanoh.
• Salajengna, unduh firmware OpenLog sareng bungkusan perpustakaan anu diperyogikeun.

UNDUH OPENLOG FIRMWARE BUNDLE (ZIP)

• Sakali anjeun gaduh perpustakaan sareng firmware diunduh, pasang perpustakaan kana Arduino. Upami anjeun teu yakin kumaha cara masang perpustakaan sacara manual dina IDE, mangga parios tutorial kami: Masang Perpustakaan Arduino: Masang Perpustakaan sacara manual.

Catetan:

• Kami nganggo vérsi anu dirobih tina perpustakaan SdFat sareng SerialPort supados sacara wenang nyatakeun sabaraha ageung panyangga TX sareng RX. OpenLog merlukeun panyangga TX leutik pisan (0), jeung panyangga RX kudu saloba mungkin.
• Ngagunakeun dua perpustakaan dirobah ieu babarengan ngamungkinkeun ngaronjat kinerja OpenLog.

Pilari versi panganyarna?
Upami anjeun langkung resep vérsi perpustakaan sareng firmware anu paling énggal, anjeun tiasa ngaunduhana langsung tina gudang GitHub anu aya di handap. Perpustakaan SdFatLib sareng Serial Port henteu katingali dina manajer dewan Arduino janten anjeun kedah masang perpustakaan sacara manual.

• GitHub: OpenLog> Firmware> OpenLog_Firmware
• Perpustakaan Arduino Bill Greiman
  • SdFatLib-béta
  • SerialPort
• Salajengna, nyandak advantage tina perpustakaan dirobah, ngaropéa SerialPort.hh file kapanggih dina \ Arduino \ Perpustakaan \ SerialPort diréktori. Robah BUFFERED_TX jadi 0 jeung ENABLE_RX_ERROR_CHECKING jadi 0. Simpen file, sareng buka Arduino IDE.
• Upami anjeun henteu acan, sambungkeun OpenLog anjeun ka komputer liwat papan FTDI. Mangga parios deui mantanample circuit lamun anjeun teu yakin kana kumaha carana ngalakukeun ieu leres.
• Buka sketsa OpenLog anu anjeun hoyong unggah dina Alat> ménu Dewan, pilih "Arduino / Genuino Uno", sareng pilih port COM anu pas pikeun papan FTDI anjeun dina Alat> Port.
• Unggah kodeu.
• Éta pisan! OpenLog anjeun ayeuna diprogram ku firmware anyar. Anjeun ayeuna tiasa muka monitor séri sareng berinteraksi sareng OpenLog. Dina kakuatan up, anjeun bakal nempo boh 12> atawa 12<. 1 nunjukkeun sambungan serial geus ngadegkeun, 2 nunjukkeun kartu SD geus hasil initialized, <nunjukkeun OpenLog siap log sagala narima data serial, jeung> nunjukkeun OpenLog siap pikeun nampa paréntah.

OpenLog Firmware Sketsa
Aya tilu sketsa anu anjeun tiasa dianggo dina OpenLog, gumantung kana aplikasi khusus anjeun.

• OpenLog - Firmware ieu dikirimkeun sacara standar dina OpenLog. Ngirimkeun? Paréntah bakal nunjukkeun versi firmware anu dimuat kana unit.
• OpenLog_Light - Vérsi sketsa ieu ngaleungitkeun ménu sareng mode paréntah, ngamungkinkeun panyangga nampi ningkat. Ieu mangrupikeun pilihan anu saé pikeun logging gancang-gancang.
• OpenLog_Minimal - Laju baud kedah disetél dina kode sareng diunggah. sketsa ieu dianjurkeun pikeun pamaké ngalaman tapi oge pilihan pangalusna pikeun speed logging pangluhurna.

Komando Set

Anjeun tiasa panganteur sareng OpenLog via terminal serial. Paréntah di handap ieu bakal ngabantosan anjeun maca, nyerat, sareng ngahapus files, kitu ogé ngarobah setelan tina OpenLog. Anjeun kedah aya dina Modeu Komando pikeun nganggo setélan ieu.

Nalika OpenLog aya dina Modeu Komando, STAT1 bakal nganonaktipkeun / mareuman unggal karakter anu ditampi. LED bakal tetep hurung dugi ka karakter salajengna ditampi.

• Anyar File - Nyiptakeun énggal file ngaranna File dina diréktori ayeuna. Baku 8.3 filengaran dirojong. Pikeun example, "87654321.123" ditarima, bari "987654321.123" henteu.
  • Example: anyar file1.txt
• Nambihan File - Nambihkeun téks kana tungtung tulisan File. Data serial ieu lajeng maca ti UART dina aliran sarta ditambahkeun kana file. Ieu teu echoed leuwih terminal serial. Lamun éta File teu aya nalika fungsi ieu disebut, éta file bakal dijieun.
  • Example: nambahkeun anyarfile.csv
• Tulis File OFFSET - Tulis téks kana File ti lokasi OFFSET dina file. Téks dibaca tina UART, baris demi baris, sarta diguar deui. Pikeun kaluar tina kaayaan ieu, ngirim hiji garis kosong.
  • Example: nulis logs.txt 516
• rm File - Ngahapus File ti diréktori ayeuna. Wildcards dirojong.
  • Example: rm README.txt
• ukuran File - Ukuran kaluaran tina File dina bait.
  • Example: ukuran Log112.csv
  • Kaluaran: 11
• Maca File + START + JENIS PANJANG - Kaluaran eusi File dimimitian ti MULAI sareng nuju LENGTH. Upami START dileungitkeun, sadayana file dilaporkeun. Upami LENGTH dileungitkeun, sadaya eusi ti titik awal dilaporkeun. Upami TYPE dileungitkeun, OpenLog bakal standar pikeun ngalaporkeun dina ASCII. Aya tilu TYPEs kaluaran:
  • ASCII = 1
  • HEX = 2
  • RAW = 3
• Anjeun bisa ninggalkeun kaluar sababaraha argumen labuh. Pariksa ex handapamples.
• Bacaan dasar + bandéra dileungitkeun:
  • Example: maca LOG00004.txt
  • Kaluaran: Akselerometer X=12 Y=215 Z=317
• Baca ti mimiti 0 kalayan panjang 5:
  • Example: baca LOG00004.txt 0 5
  • Kaluaran: Accel
• Baca ti posisi 1 kalayan panjang 5 dina HEX:
  • Example: baca LOG00004.txt 1 5 2
  • Kaluaran: 63 63 65 6C
• Baca tina posisi 0 kalayan panjang 50 dina RAW:
  • Example: baca LOG00137.txt 0 50 3
  • Kaluaran: André– -þ Ngalegaan Uji Karakter
• Ucing File – Tulis eusi a file di hex ka monitor serial pikeun viewing. Ieu kadang mantuan ningali yén a file keur ngarekam bener tanpa kudu narik kartu SD na view éta file dina komputer.
  • Example: ucing LOG00004.txt
  • Kaluaran: 00000000: 41 63 65 6c 3a 20 31

Manipulasi diréktori

• ls - Daptar sadaya eusi diréktori ayeuna. Wildcards dirojong.
  • Example: ls
  • Kaluaran: \src
• md Subdirektori - Jieun Subdirektori dina diréktori ayeuna.
  • Example: md Example_Sketsa
• cd Subdirektori - Robah ka Subdirektori.
  • Example: cd Hello_World
• cd .. – Robah ka diréktori handap dina tangkal. Catet yén aya spasi antara 'cd' jeung '..'. Hal ieu ngamungkinkeun string parser ningali paréntah CD.
  • Example: cd..
• rm Subdirektori - Ngahapus Subdirektori. Diréktori kudu kosong pikeun paréntah ieu jalan.
  • Example: rm temps
• Diréktori rm -rf - Ngahapus Diréktori sareng naon waé files dikandung dina eta.
  • Example: rm -rf Perpustakaan

Low-Level Fungsi Paréntah

• ? - Paréntah ieu bakal narik daptar paréntah anu sayogi dina OpenLog.
• Disk - Tampilkeun ID produsén kartu, nomer séri, tanggal pabrik, sareng ukuran kartu. Misalampkaluaran nyaéta:
  • Jenis kartu: SD2 ID Produsén: 3
  • OEM ID: SD
  • Produk: SU01G
  • Vérsi: 8.0
  • Nomer séri: 39723042 Tanggal produksi: 1/2010 Ukuran Kartu: 965120 KB
• init - Reinitialize sistem sareng buka deui kartu SD. Ieu mantuan lamun kartu SD eureun ngarespon.
• Singkronisasi - Nyingkronkeun eusi panyangga anu ayeuna ka kartu SD. Paréntah ieu mangpaat upami anjeun gaduh kirang ti 512 karakter dina panyangga sareng hoyong ngarékam dina kartu SD.
• Reset - Luncat OpenLog ka lokasi enol, ngajalankeun deui bootloader, teras kode init. Paréntah ieu ngabantosan upami anjeun kedah ngédit config file, reset OpenLog, tur mimitian nganggo konfigurasi anyar. Ngabuburit kakuatan masih metoda pikaresep pikeun ngareset dewan, tapi pilihan ieu sadia.

Setélan Sistim

Setelan ieu bisa diropéa sacara manual atawa diédit dina config.txt file.

• Echo STATE - Ngarobih kaayaan sistem, sareng disimpen dina mémori sistem. STATE tiasa hurung atanapi pareum. Sedengkeun dina OpenLog bakal gema narima data serial dina ajakan paréntah. Nalika pareum, sistem henteu maca deui karakter anu ditampi.

Catetan: Salila logging normal, gema bakal dipareuman. Tuntutan sumber daya sistem pikeun nyuarkeun data anu ditampi teuing tinggi nalika logging.

• Verbose STATE - Ngarobih kaayaan ngalaporkeun kasalahan verbose. STATE tiasa hurung atanapi mareuman Paréntah ieu disimpen dina mémori. Ku mareuman kasalahan verbose, OpenLog bakal ngabales ukur! lamun aya kasalahan, tinimbang hiji paréntah kanyahoan: C OMMAND.D..Thecharacterss leuwih gampang pikeun sistem embedded parse ti kasalahan pinuh. Upami Anjeun keur make terminal a, ninggalkeun verbose on bakal ngidinan Anjeun pikeun nempo talatah kasalahan pinuh.
• baud - Paréntah ieu bakal muka ménu sistem anu ngamungkinkeun pamaké pikeun ngasupkeun laju baud. Sakur laju baud antara 300bps sareng 1Mbps dirojong. Pilihan laju baud langsung, sarta OpenLog merlukeun siklus kakuatan pikeun setelan mawa pangaruh. Laju baud disimpen ka EEPROM sareng dimuat unggal waktos OpenLog ngawasa. Standarna nyaéta 9600 8N1.

Inget: Lamun meunang dewan nyangkut dina laju baud kanyahoan, anjeun tiasa dasi RX mun GND jeung kakuatan up OpenLog. LED bakal kedip-kedip mudik salami 2 detik teras bakal kedip-kedip sakaligus. Turunkeun OpenLog, sareng cabut jumper. OpenLog ayeuna ngareset ka 9600bps kalayan karakter kabur `CTRL-Z` dipencet tilu kali berturut-turut. fitur ieu bisa overridden ku nyetel Darurat Override bit 1. Tempo config.txt pikeun info leuwih lengkep.

• Set - Paréntah ieu muka ménu sistem pikeun milih modeu bootup. Setelan ieu bakal lumangsung dina kakuatan-on salajengna jeung disimpen dina EEPROM non-volatile.
  • Anyar File Logging - Modeu ieu nyiptakeun énggal file unggal waktos OpenLog kakuatan up. OpenLog bakal ngirimkeun 1 (UART hirup), 2 (kartu SD diinisialisasi), teras < (OpenLog siap nampi data). Sadaya data bakal dirékam kana LOG#####.txt. Jumlah ##### naek unggal waktos OpenLog kakuatan up (max 65533 log). Jumlahna disimpen dina EEPROM sareng tiasa direset tina menu set. Henteu sadayana karakter anu ditampi digema. Anjeun tiasa kaluar tina mode ieu sarta asupkeun mode paréntah ku ngirim CTRL + z (ASCII 26). Kabéh data buffered bakal disimpen.
• Catetan: Lamun loba teuing log geus dijieun, OpenLog bakal kaluaran kasalahan ** Loba teuing log **, kaluar mode ieu, tur teundeun kana Command Prompt. Kaluaran serial bakal kasampak kawas `12!Loba teuing log!
  • Nambihan File Logging - Ogé katelah mode sequential, mode ieu nyiptakeun a file disebut SEQLOG.txt lamun éta teu acan aya, sarta appends sagala data narima kana file. OpenLog bakal ngirimkeun 12< dina waktos OpenLog siap nampi data. Tokoh-tokohna teu diguar. Anjeun tiasa kaluar tina mode ieu sarta asupkeun mode paréntah ku ngirim CTRL + z (ASCII 26). Kabéh data buffered bakal disimpen.
  • Command Prompt - OpenLog bakal ngirimkeun 12> dina waktos éta sistem parantos siap nampi paréntah. Catet yén tanda > nunjukkeun OpenLog siap nampi paréntah, sanés data. Anjeun tiasa nyiptakeun files sarta append data ka files, tapi ieu merlukeun sababaraha parsing serial (pikeun mariksa kasalahan), sangkan teu diatur mode ieu sacara standar.
  • Reset Anyar File Nomer - Modeu ieu bakal ngareset log file nomer ka LOG000.txt . Ieu mangpaat upami anjeun nembé ngahapus kartu microSD sareng hoyong log file angka pikeun ngamimitian deui.
  • Karakter Escape Anyar - Pilihan ieu ngamungkinkeun pamaké pikeun nuliskeun karakter, kayaning CTRL + z atawa $, tur nyetel ieu salaku karakter ngewa anyar. Setelan ieu direset ka CTRL+z salila reset darurat.
  • Jumlah Karakter ngewa - Pilihan ieu ngamungkinkeun pamaké pikeun nuliskeun karakter (sapertos 1, 3, atawa 17), ngamutahirkeun jumlah anyar karakter ngewa diperlukeun pikeun turun ka mode paréntah. Pikeun exampLebetkeun 8 bakal meryogikeun pangguna pencét CTRL + z dalapan kali dugi ka modeu paréntah. Setelan ieu direset ka 3 salila reset darurat.
• Kabur Karakter Penjelasan: Alesan OpenLog merlukeun `CTRL + z` pencét 3 kali asup kana modeu paréntah nyaéta pikeun nyegah dewan teu ngahaja keur reset salila unggah kodeu anyar ti Arduino IDE. Aya kamungkinan yén dewan bakal ningali karakter `CTRL + z` nalika bootloading (masalah anu urang tingali dina versi awal firmware OpenLog), ku kituna ieu tujuanana pikeun nyegah éta. Upami anjeun kantos nyangka papan anjeun parantos batal kusabab ieu, anjeun salawasna tiasa ngalakukeun reset darurat ku cara nahan pin RX ka taneuh nalika kakuatan.

Konfigurasi File

Upami anjeun langkung resep henteu nganggo terminal séri pikeun ngarobih setélan dina OpenLog anjeun, anjeun ogé tiasa ngapdet setélan ku ngarobih CONFIG.TXT. file.

Catetan: Fitur ieu ngan ukur dianggo dina versi firmware 1.6 atanapi langkung énggal. Upami anjeun parantos ngagaleuh OpenLog saatos 2012, anjeun bakal ngajalankeun versi firmware 1.6+

• Jang ngalampahkeun ieu, anjeun peryogi pamaca kartu microSD sareng pangropéa téksu. Buka config.txt nu file (kapitalisasi tina file ngaran henteu masalah), sarta ngonpigurasikeun jauh! Upami anjeun teu acan kantos ngadamel OpenLog anjeun nganggo kartu SD sateuacanna, anjeun ogé tiasa sacara manual nyiptakeun file file. Lamun geus Powered up OpenLog jeung kartu microSD diselapkeun saméméhna, Anjeun kudu ningali hal kawas kieu mun anjeun maca kartu microSD.OpenLog nyiptakeun config.txt sareng LOG0000.txt file dina mimiti kakuatan up.
• Konfigurasi standar file boga hiji garis setelan jeung hiji garis definisi.Konfigurasi standar file ieu ditulis ku OpenLog.
• Catet yén ieu mangrupikeun karakter anu katingali biasa (teu aya nilai anu teu katingali atanapi binér), sareng unggal nilai dipisahkeun ku koma.

Setélan didefinisikeun kieu:

• baud : Laju baud komunikasi. 9600 bps nyaéta standar. nilai ditarima anu cocog sareng Arduino IDE 2400, 4800, 9600, 19200, 38400, 57600, jeung 115200. Anjeun tiasa make ongkos baud séjén, tapi maneh bakal teu bisa komunikasi sareng OpenLog ngaliwatan Arduino IDE serial monitor.
• Escap:e Nilai ASCII (dina format decimal) tina karakter ngewa. 26 nyaéta CTRL + z sareng mangrupikeun standar. 36 mangrupa $ sarta mangrupakeun karakter ngewa ilahar dipake.
• Esc #: Jumlah karakter ngewa diperlukeun. Sacara standar, éta tilu, jadi Anjeun kudu pencét karakter ngewa tilu kali pikeun turun ka modeu paréntah. Nilai ditarima tina 0 nepi ka 254. Nyetél nilai ieu 0 bakal nganonaktipkeun ngewa karakter mariksa lengkep.
• Modeu Sistim modeu. OpenLog dimimitian dina modeu Log Anyar ( 0 ) sacara standar. Nilai ditarima nyaéta 0 = Log Anyar, 1 = Log Sequential, 2 = Mode Komando.
• Kecap pagawéan: mode verbose. Pesen kasalahan anu diperpanjang (verbose) dihurungkeun sacara standar. Nyetél ieu ka 1 ngahurungkeun pesen kasalahan verbose (sapertos paréntah anu teu dipikanyaho: hapus! ). Nyetel ieu kana 0 mareuman kasalahan verbose, tapi bakal ngabales ku ! lamun aya kasalahan. Pareuman mode verbose tiasa dianggo upami anjeun nyobian ngadamel kasalahan tina sistem anu dipasang.
• Gema: Modeu gema. Bari dina modeu paréntah, karakter anu echoed sacara standar. Nyetel ieu ka 0 mareuman gema karakter. Pareuman ieu tiasa dianggo upami nanganan kasalahan, sareng anjeun henteu hoyong paréntah dikirimkeun deui ka OpenLog.II.
• iignoreRXEmergency Override. Biasana, OpenLog bakal ngareset darurat nalika pin RX ditarik ka handap nalika kakuatan up. Nyetél ieu ka 1 bakal nganonaktipkeun pamariksaan pin RX salami kakuatan. Ieu tiasa mantuan pikeun sistem anu bakal nahan garis RX low pikeun sagala rupa alesan. Upami Override Darurat ditumpurkeun, anjeun moal tiasa maksa unit deui ka 9600bps, sareng konfigurasi file bakal hijina cara pikeun ngaropea laju baud.

Kumaha OpenLog Ngarobih Konfigurasi File
Aya lima kaayaan béda pikeun OpenLog ngaropea config.txt file.

• Konfigurasi file kapanggih: Salila kakuatan up, OpenLog bakal néangan config.txt a file. Lamun éta file kapendak, OpenLog bakal nganggo setélan anu kalebet sareng nimpa setélan sistem anu disimpen sateuacana.
• Taya config file kapanggih: Mun OpenLog teu bisa manggihan config.txt file teras OpenLog bakal nyiptakeun config.txt sareng ngarékam setélan sistem anu ayeuna disimpen ka dinya. Ieu hartosna upami anjeun nyelapkeun kartu microSD anu nembé diformat, sistem anjeun bakal ngajaga setélan ayeuna.
• Konfigurasi korup file kapanggih: OpenLog bakal mupus config.txt ruksak file, sarta bakal nulis balik duanana setelan EEPROM internal tur setélan config.txt file ka kaayaan dipikawanoh-alus 9600,26,3,0,1,1,0.
• Nilai ilegal dina config file: Upami OpenLog mendakan setélan anu ngandung nilai-nilai haram, OpenLog bakal nimpa nilai-nilai anu rusak dina config.txt file kalawan setelan sistem EEPROM ayeuna disimpen.
• Parobahan ngaliwatan ajakan paréntah: Lamun setélan sistem dirobah ngaliwatan ajakan paréntah (boh ngaliwatan sambungan serial atawa via paréntah serial mikrokontroler) parobahan ieu bakal dirékam duanana kana sistem EEPROM jeung config.txt. file.
• Reset Darurat: Upami OpenLog didaurkeun kakuatan sareng jumper antara RX sareng GND, sareng bit Darurat Override disetel ka 0 (ngamungkinkeun reset darurat), OpenLog bakal nyerat deui boh setélan EEPROM internal sareng setélan config.txt. file ka kaayaan dipikawanoh-alus 9600,26,3,0,1,1,0.

Pamérésan masalah

Aya sababaraha pilihan anu béda pikeun mariksa upami anjeun gaduh masalah nyambungkeun kana monitor séri, gaduh masalah sareng karakter turun dina log, atanapi ngalawan OpenLog anu batal.

Pariksa STAT1 LED Paripolah
STAT1 LED nembongkeun kabiasaan béda pikeun dua kasalahan umum béda.

• 3 Blinks: Kartu microSD gagal pikeun initialize. Anjeun panginten kedah pormat kartu sareng FAT / FAT16 dina komputer.
• 5 Blinks: OpenLog geus robah jadi laju baud anyar jeung kudu daya cycled.

Ganda Cék Struktur Subdirektori

• Upami anjeun nganggo standar OpenLog.ino example, OpenLog ngan bakal ngarojong dua subdirectories. Anjeun kedah ngarobih FOLDER_TRACK_DEPTH tina 2 kana jumlah subdirektori anu anjeun peryogikeun. Sakali anjeun tos rengse ieu, recompile kode nepi, sarta unggah firmware dirobah.
• Pariksa Jumlah Files dina Diréktori Akar
• OpenLog ngan bakal ngadukung dugi ka 65,534 log files dina diréktori root. Kami ngarékoméndasikeun pormat ulang kartu microSD anjeun pikeun ningkatkeun laju log.
• Pariksa Ukuran Firmware Anjeun Dirobih
• Upami anjeun nyerat sketsa khusus pikeun OpenLog, pariksa yén sketsa anjeun henteu langkung ageung tibatan 32,256. Upami kitu, éta bakal motong kana 500 bait luhur mémori Flash, anu dianggo ku bootloader serial Optiboot.
• Ganda Cék File Ngaran
• Sadayana file ngaran kudu alpha-numeric. MyLOG1.txt ok, tapi Hai !e _ .txtt bisa jadi teu jalan.
• Paké 9600 baud
• OpenLog ngajalankeun kaluar ATmega328 sarta ngabogaan jumlah kawates RAM (2048 bait). Lamun anjeun ngirim karakter serial ka OpenLog, karakter ieu meunang buffered. SD Grup spésifikasi basajan ngamungkinkeun hiji kartu SD nyandak nepi ka 250ms (bagian 4.6.2.2 Tulis) pikeun ngarekam blok data ka flash memori.
• Dina 9600bps, éta 960 bait (10 bit per bait) per detik. Éta 1.04ms per bait. OpenLog ayeuna ngagunakeun 512 bait nampi panyangga sahingga tiasa panyangga sakitar 50ms karakter. Hal ieu ngamungkinkeun OpenLog pikeun suksés nampi sadaya karakter dina 9600bps. Anjeun ningkatkeun laju baud, panyangga bakal lepas pikeun kirang waktos.

OpenLog panyangga Overrun Time

Seueur kartu SD gaduh waktos catetan anu langkung gancang tibatan 250ms. Ieu bisa kapangaruhan ku 'kelas' kartu na sabaraha data geus disimpen dina kartu. Solusina nyaéta nganggo tingkat baud anu langkung handap atanapi ningkatkeun jumlah waktos antara karakter anu dikirim dina tingkat baud anu langkung luhur.

Patarosan anu sering ditaroskeun