Speċifikazzjonijiet

• Isem tal-Prodott: Reġistratur tad-Data OpenLog
• Mudell: DEV-13712
• Dħul tal-Enerġija: 3.3V-12V (Rakkomandat 3.3V-5V)
• Volum tad-Dħul RXItage: 2.0V-3.8V
• Volum tal-Ħruġ TXOtage: 3.3V
• Ġbid tal-Kurrent Inattiv: ~2mA-5mA (mingħajr karta microSD), ~5mA-6mA (bil-karta microSD)
• Kurrent tal-Kitba Attiva: ~20-23mA (b'karta microSD)

Istruzzjonijiet għall-Użu tal-Prodott

Materjali Meħtieġa:

• Arduino Pro Mini 328 – 3.3V/8MHz
• SparkFun FTDI Bażiku Breakout – 3.3V
• Kejbil USB SparkFun Cerberus – 6 piedi
• Karta microSD b'Adapter – 16GB (Klassi 10)
• Qarrej tal-USB microSD
• Headers Femminili
• Wajers tal-Jumper Premium 6 M/M Pakkett ta' 10
• Intestaturi Maskili Break Away – Angolu Rett

Qari Rakkomandat:

• Kif Tissaldja: Saldjar minn Toqba 'l Quddiem
• Bażiċi tal-Komunikazzjoni Serjali
• Interface Periferali Serjali (SPI)
• Bażiku tat-Terminal Serjali

Hardware Overview:
L-OpenLog jaħdem bis-settings li ġejjin:

Introduzzjoni

Avviżi! Dan it-tutorjal huwa għall-Open Log għal serial UART [DEV-13712]. Jekk qed tuża l-Qwiic OpenLog għal IC [DEV-15164], jekk jogħġbok irreferi għall-Gwida tal-Konnessjoni tal-Qwiic OpenLog.

L-OpenLog Data Logger hija soluzzjoni sempliċi biex tużaha u open-source għar-reġistrazzjoni ta' dejta serjali mill-proġetti tiegħek. L-OpenLog jipprovdi interface serjali sempliċi biex tirreġistra dejta minn proġett għal kard microSD.

SparkFun OpenLog
DEV-13712

SparkFun OpenLog bil-Headers
DEV-13955

Ma nstab l-ebda prodott

Materjali Meħtieġa
Sabiex taħdem bis-sħiħ permezz ta' dan it-tutorja, ser ikollok bżonn il-partijiet li ġejjin. Madankollu, jista' jkun li ma jkollokx bżonn kollox skont dak li għandek. Żidu mal-karrettun tiegħek, aqra l-gwida, u aġġusta l-karrettun kif meħtieġ.

Gwida għall-Konnessjoni OpenLog

Lista tax-Xewqat ta' SparkFun

Qari Rakkomandat
Jekk m'intix familjari jew komdu mal-kunċetti li ġejjin, nirrakkomandaw li taqrahom qabel ma tkompli bil-Gwida tal-Konnessjoni OpenLog.

• Kif Tissaldja: Saldjar minn Toqba Għaddejja. Dan it-tutorja jkopri dak kollu li għandek bżonn tkun taf dwar l-issaldjar minn toqba ġo fiha.
• Komunikazzjoni Serjali Kunċetti ta' komunikazzjoni serjali asinkronika: pakketti, livelli ta' sinjali, rati ta' baud, UARTs, u aktar!
• Interface Periferali Serjali (SPI) L-SPI jintuża komunement biex jgħaqqad mikrokontrolluri ma' periferali bħal sensuri, reġistri ta' shift, u karti SD.
• Bażiku tat-Terminal Serjali Dan it-tutorja ser jurik kif tikkomunika mat-tagħmir serjali tiegħek billi tuża varjetà ta' applikazzjonijiet ta' emulazzjoni tat-terminal.

Hardware Overview

Qawwa
L-OpenLog jaħdem bis-settings li ġejjin:

Klassifikazzjonijiet tal-Qawwa OpenLog

Il-konsum tal-kurrent tal-OpenLog huwa ta' madwar 20mA sa 23mA meta jikteb fuq microSD. Skont id-daqs tal-kard tal-microSD u l-manifattur tagħha, il-konsum tal-kurrent attiv jista' jvarja meta l-OpenLog ikun qed jikteb fuq il-kard tal-memorja. Iż-żieda tar-rata tal-baud tiġbed ukoll aktar kurrent.

Mikrokontrollur
L-OpenLog jaħdem permezz ta' ATmega328 abbord, li jaħdem b'16MHz, grazzi għall-kristall abbord. L-ATmega328 għandu l-bootloader Optiboot mgħobbi fuqu, li jippermetti li l-OpenLog ikun kompatibbli mal-
Is-settings tal-bord “Arduino Uno” fl-Arduino IDE.

Interface

UART tas-serje
L-interfaċċja primarja mal-OpenLog hija l-header FTDI fuq it-tarf tal-bord. Dan il-header huwa ddisinjat biex jitwaħħal direttament ma' Arduino Pro jew Pro Mini, li jippermetti lill-mikrokontrollur jibgħat id-dejta permezz ta' konnessjoni serjali lill-OpenLog.

Twissija! Minħabba l-ordni tal-pinnijiet li tagħmilha kompatibbli mal-Arduinos, ma tistax tipplaggja direttament ma' breakout board FTDI.

Għal aktar informazzjoni, kun żgur li tiċċekkja t-taqsima li jmiss dwar il-Konnessjoni tal-Hardware.

SPI

Hemm ukoll erba' punti tat-test SPI mqassma fuq in-naħa l-oħra tal-bord. Tista' tuża dawn biex tipprogramma mill-ġdid il-bootloader fuq l-ATmega328.

• L-aħħar OpenLog (DEV-13712) juża dawn il-pinnijiet fuq toqob iżgħar miksija. Jekk teħtieġ li tuża ISP biex tipprogramma mill-ġdid jew ittella' bootloader ġdid fuq l-OpenLog, tista' tuża pinnijiet pogo biex tikkonnettja ma' dawn il-punti tat-test.
• L-interfaċċja finali għall-komunikazzjoni mal-OpenLog hija l-kard microSD innifisha. Biex tikkomunika, il-kard microSD teħtieġ pins SPI. Mhux biss huwa hawnhekk fejn id-dejta tinħażen mill-OpenLog, iżda tista' wkoll taġġorna l-konfigurazzjoni tal-OpenLog permezz tal-config.txt. file fuq il-karta microSD.
  Karta microSD

Id-dejta kollha rreġistrata mill-OpenLog tinħażen fuq il-kard tal-microSD. L-OpenLog jaħdem ma' kards tal-microSD li għandhom il-karatteristiċi li ġejjin:

• 64MB sa 32GB
• FAT16 jew FAT32

Hemm żewġ LEDs tal-istatus fuq l-OpenLog biex jgħinuk issolvi l-problemi.

• STAT1 – Dan l-LED indikatur blu huwa mwaħħal ma' Arduino D5 (ATmega328 PD5) u jinxtegħel/jitfi meta jiġi riċevut karattru ġdid. Dan l-LED jteptep meta l-komunikazzjoni serjali tkun qed tiffunzjona.
• STAT2 – Dan l-LED aħdar huwa konness mal-Arduino D13 (SPI Serial Clock Line/ ATmega328 PB5). Dan l-LED jteptep biss meta l-interfaċċja tal-SPI tkun attiva. Se tarah jteptep meta l-OpenLog jirreġistra 512 bytes fuq il-kard microSD.

Ħardwer Hookup

Hemm żewġ metodi ewlenin biex tqabbad l-OpenLog tiegħek ma' ċirkwit. Ikollok bżonn xi headers jew wajers biex tikkonnettja. Kun żgur li ssaldja mal-bord għal konnessjoni sigura.

Konnessjoni Serjali Bażika

TipJekk għandek header femminili fuq l-OpenLog u header femminili fuq l-FTDI, ser ikollok bżonn wajers jumper M/F biex tikkonnettja.

Din il-konnessjoni tal-ħardwer hija ddisinjata biex tinteraġixxi ma' OpenLog jekk teħtieġ li tipprogramma mill-ġdid il-bord jew tirreġistra d-dejta fuq konnessjoni serjali bażika.

Agħmel il-konnessjonijiet li ġejjin:
OpenLog → Breakout Bażiku FTDI ta' 3.3V

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

Innota li mhijiex konnessjoni diretta bejn l-FTDI u l-OpenLog – trid taqleb il-konnessjonijiet tal-pin TXO u RXI.

Il-konnessjonijiet tiegħek għandhom jidhru bħal dawn li ġejjin:

Ladarba tkun għamilt il-konnessjonijiet bejn l-OpenLog u l-FTDI Basic, daħħal il-bord FTDI tiegħek f'kejbil USB u fil-kompjuter tiegħek. Iftaħ serial terminal, qabbad mal-port COM tal-FTDI Basic tiegħek, u ibda!

Konnessjoni tal-Ħardwer tal-Proġett

Tip: Jekk għandek il-headers femminili ssaldjati fuq l-OpenLog, tista' ssaldja headers maskili mal-Arduino Pro Mini biex tgħaqqad il-bordijiet flimkien mingħajr il-ħtieġa ta' wajers.

Filwaqt li l-interazzjoni mal-OpenLog permezz ta' konnessjoni serjali hija importanti għall-ipprogrammar mill-ġdid jew id-debugging, il-post fejn OpenLog jiddi huwa fi proġett inkorporat. Dan iċ-ċirkwit ġenerali huwa kif nirrakkomandaw li tqabbad l-OpenLog tiegħek ma' mikrokontrollur (f'dan il-każ, Arduino Pro Mini) li se jikteb dejta serjali fl-OpenLog.

L-ewwel, ser ikollok bżonn ittella' l-kodiċi fuq il-Pro Mini tiegħek li biħsiebek tħaddem. Jekk jogħġbok ara l-Arduino Sketches għal xi eżempji.ampil-kodiċi li tista' tuża.

Nota: Jekk m'intix ċert kif tipprogramma l-Pro Mini tiegħek, jekk jogħġbok ara t-tutorja tagħna hawn.

L-użu tal-Arduino Pro Mini 3.3V

• Dan it-tutorjal huwa l-gwida tiegħek għal kollox relatat mal-Arduino Pro Mini. Jispjega x'inhu, x'mhux, u kif tibda tużah.
• Ladarba tkun ipprogrammajt il-Pro Mini tiegħek, tista' tneħħi l-bord FTDI u tissostitwixxih bl-OpenLog. Kun żgur li tqabbad il-pins immarkati BLK kemm fuq il-Pro Mini kif ukoll fuq l-OpenLog (il-pins immarkati GRN fuq it-tnejn jaqblu wkoll jekk isir b'mod korrett).
• Jekk ma tistax tqabbad l-OpenLog direttament mal-Pro Mini (minħabba headers li ma jaqblux jew bordijiet oħra fit-triq), tista' tuża jumper wires u tagħmel il-konnessjonijiet li ġejjin.

OpenLog → Arduino Pro/Arduino Pro Mini

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

Ladarba tkun lest, il-konnessjonijiet tiegħek għandhom jidhru bħal dawn li ġejjin bl-Arduino Pro Mini u l-Arduino Pro. Id-dijagramma ta' Fritzing turi l-OpenLogs bil-headers imdawwrin. Jekk taqleb is-sokit tal-microSD relattivament għall-parti ta' fuq tal-Arduino view, għandhom jaqblu mal-intestatura tal-ipprogrammar bħal FTDI.

Innota li l-konnessjoni hija straight shot bl-OpenLog "ta' taħt fuq" (bil-microSD iħares 'il fuq).

Nota: Peress li l-Vcc u l-GND bejn l-OpenLog u l-Arduino qed jiġu okkupati mill-headers, ikollok bżonn tikkonnettja mal-enerġija l-pins l-oħra disponibbli fuq l-Arduino. Inkella, tista' ssaldja wajers mal-pins tal-enerġija esposti fuq kwalunkwe bord.

Ixgħel is-sistema tiegħek, u int lest biex tibda tirreġistra!

Skeċċi tal-Arduino

Hemm sitt eż differentiampl-iskeċċi inklużi li tista' tuża fuq l-Arduino meta tkun imqabbad ma' OpenLog.

• OpenLog_Benchmarking — Dan l-eż.ample jintuża biex jiġi ttestjat OpenLog. Dan jibgħat ammonti kbar ħafna ta' dejta b'115200bps fuq diversi files.
• OpenLog_CommandTest — Dan l-eż.ample juri kif toħloq u żżid file permezz ta' kontroll tal-linja tal-kmand permezz tal-Arduino.
• OpenLog_ReadExample — Dan l-eżample jispjega kif tikkontrolla l-OpenLog permezz tal-linja tal-kmand.
• OpenLog_ReadExample_LargeFile — Eżample ta' kif tiftaħ maħżun kbir file fuq OpenLog u rrapportah permezz ta' konnessjoni Bluetooth lokali.
• OpenLog_Test_Sketch — Użat biex jiġi ttestjat OpenLog b'ħafna dejta serjali.
• OpenLog_Test_Sketch_Binary — Użat biex jittestja OpenLog b'dejta binarja u karattri tal-ħarba.

Firmware

L-OpenLog għandu żewġ softwer primarji abbord: il-bootloader u l-firmware.

Bootloader tal-Arduino

Nota: Jekk qed tuża OpenLog li nxtara qabel Marzu 2012, il-bootloader onboard huwa kompatibbli mas-setting “Arduino Pro jew Pro Mini 5V/16MHz w/ ATmega328” fl-Arduino IDE.

• Kif imsemmi qabel, l-OpenLog għandu l-Optiboot serial bootloader abbord. Tista' tittratta l-OpenLog eżatt bħal Arduino Uno meta ttella' exampkodiċi jew firmware ġdid mal-bord.
• Jekk tispiċċa tagħmel bricking tal-OpenLog tiegħek u jkollok bżonn terġa' tinstalla l-bootloader, tkun trid ukoll ittella' Optiboot fuq il-bord. Jekk jogħġbok ara t-tutorja tagħna dwar l-installazzjoni ta' Arduino Bootloader għal aktar informazzjoni.

Kompilazzjoni u Tagħbija tal-Firmware fuq l-OpenLog

Nota: Jekk din hija l-ewwel darba li qed tuża Arduino, jekk jogħġbok erġa' għidview it-tutorja tagħna dwar l-installazzjoni tal-Arduino IDE. Jekk qatt ma installajt librerija Arduino qabel, jekk jogħġbok ara l-gwida tal-installazzjoni tagħna biex tinstalla l-libreriji manwalment.

• Jekk għal xi raġuni teħtieġ taġġorna jew terġa' tinstalla l-firmware fuq l-OpenLog tiegħek, il-proċess li ġej se jġiegħel il-bord tiegħek jibda jaħdem.
• L-ewwel, jekk jogħġbok niżżel l-Arduino IDE v1.6.5. Verżjonijiet oħra tal-IDE jistgħu jaħdmu biex jikkompilaw il-firmware tal-OpenLog, iżda aħna vverifikajna dan bħala verżjoni magħrufa bħala tajba.
• Imbagħad, niżżel il-firmware tal-OpenLog u l-pakkett tal-libreriji meħtieġa.

NIŻŻEL IL-PAKKETT TAL-FIRMWARE TAL-OPENLOG (ZIP)

• Ladarba tkun niżżilt il-libreriji u l-firmware, installa l-libreriji fl-Arduino. Jekk m'intix ċert kif tinstalla l-libreriji manwalment fl-IDE, jekk jogħġbok ara t-tutorja tagħna: Installazzjoni ta' Librerija Arduino: Installazzjoni Manwali ta' Librerija.

Nota:

• Qed nużaw verżjonijiet modifikati tal-libreriji SdFat u SerialPort sabiex niddikjaraw arbitrarjament kemm għandhom ikunu kbar il-buffers TX u RX. L-OpenLog jirrikjedi li l-buffer TX ikun żgħir ħafna (0), u l-buffer RX jeħtieġ li jkun kbir kemm jista' jkun.
• L-użu ta' dawn iż-żewġ libreriji modifikati flimkien jippermetti prestazzjoni akbar tal-OpenLog.

Qed tfittex l-Aħħar Verżjonijiet?
Jekk tippreferi l-aktar verżjonijiet aġġornati tal-libreriji u l-firmware, tista' tniżżilhom direttament mir-repożitorji tal-GitHub li huma marbuta hawn taħt. Il-libreriji SdFatLib u Serial Port mhumiex viżibbli fil-maniġer tal-bord Arduino għalhekk ikollok bżonn tinstalla l-librerija manwalment.

• GitHub: OpenLog > Firmware > OpenLog_Firmware
• Il-Libreriji Arduino ta' Bill Greiman
  • SdFatLib-beta
  • SerialPort
• Li jmiss, biex tieħu vantaġġtage tal-libreriji modifikati, immodifika s-SerialPort.hh file misjuba fid-direttorju \Arduino\Libraries\SerialPort. Ibdel BUFFERED_TX għal 0 u ENABLE_RX_ERROR_CHECKING għal 0. Issejvja l- file, u iftaħ l-Arduino IDE.
• Jekk għadek ma għamiltux hekk, qabbad l-OpenLog tiegħek mal-kompjuter permezz ta' bord FTDI. Jekk jogħġbok iċċekkja mill-ġdid l-exampiċ-ċirkwit jekk m'intix ċert kif tagħmel dan sew.
• Iftaħ l-iskeċċ tal-OpenLog li tixtieq ittella' taħt il-menu Tools>Board, agħżel "Arduino/Genuino Uno", u agħżel il-port COM xieraq għall-bord FTDI tiegħek taħt Tools>Port.
• Tella' l-kodiċi.
• Dak hu! L-OpenLog tiegħek issa huwa pprogrammat b'firmware ġdid. Issa tista' tiftaħ monitor tas-serje u tinteraġixxi mal-OpenLog. Malli tixgħel l-apparat, se tara jew 12> jew 12<. 1 jindika li l-konnessjoni tas-serje hija stabbilita, 2 jindika li l-karta SD ġiet inizjalizzata b'suċċess, < jindika li l-OpenLog huwa lest biex jirreġistra kwalunkwe dejta tas-serje li tirċievi, u > jindika li l-OpenLog huwa lest biex jirċievi kmandi.

Skeċċi tal-Firmware tal-OpenLog
Hemm tliet skeċċijiet inklużi li tista' tuża fuq l-OpenLog, skont l-applikazzjoni partikolari tiegħek.

• OpenLog – Dan il-firmware jiġi awtomatikament fuq l-OpenLog. Jekk tibgħat il-kmand ?, il-verżjoni tal-firmware tkun ġiet mgħobbija fuq unità tintwera.
• OpenLog_Light – Din il-verżjoni tal-iskeċċ tneħħi l-menu u l-modalità tal-kmand, u b'hekk tippermetti li jiżdied il-buffer tar-riċeviment. Din hija għażla tajba għal-logging b'veloċità għolja.
• OpenLog_Minimal – Ir-rata tal-baud trid tiġi ssettjata fil-kodiċi u tittella’. Dan l-iskeċċ huwa rakkomandat għal utenti b’esperjenza iżda huwa wkoll l-aħjar għażla għall-ogħla veloċità ta’ logging.

Sett ta' Kmand

Tista' tinteraġixxi mal-OpenLog permezz ta' terminal serjali. Il-kmandi li ġejjin jgħinuk taqra, tikteb, u tħassar files, kif ukoll tibdel is-settings tal-OpenLog. Ikollok bżonn tkun fil-Modalità Kmand biex tuża s-settings li ġejjin.

Waqt li l-OpenLog ikun fil-Modalità Kmand, STAT1 se jixgħel/jitfi għal kull karattru li jirċievi. L-LED jibqa' mixgħul sakemm jasal il-karattru li jmiss.

• Ġdid File – Joħloq waħda ġdida file jismu File fid-direttorju kurrenti. Standard 8.3 fileL-ismijiet huma appoġġjati. Pereżempjuampjiġifieri, “87654321.123” huwa aċċettabbli, filwaqt li “987654321.123” mhuwiex.
  • Example: ġdid file1.txt
• Appendi File – Żid test fl-aħħar tal- FileImbagħad id-dejta serjali tinqara mill-UART fi stream u tiżdied mal- fileMa jiġix ripetut fuq it-terminal serjali. Jekk il- File ma teżistix meta din il-funzjoni tiġi msejħa, il- file se jinħolqu.
  • Example: żid ġdidfile.csv
• Ikteb File OFFSET – Ikteb test lill- File mill-post OFFSET fi ħdan il- fileIt-test jinqara mill-UART, linja b'linja, u jiġi ripetut lura. Biex toħroġ minn dan l-istat, ibgħat linja vojta.
  • Example: ikteb logs.txt 516
• rm File – Iħassar il- File mid-direttorju attwali. Il-wildcards huma appoġġjati.
  • Example: rm README.txt
• daqs File – Daqs tal-ħruġ ta' File f'bytes.
  • Example: daqs Log112.csv
  • Output: 11
• Aqra File + BIDU+ TIP TA' TUL – Oħroġ il-kontenut ta' File tibda minn START u tmur għal LENGTH. Jekk START jitħalla barra, it-tul kollu file jiġi rrappurtat. Jekk LENGTH jitħalla barra, il-kontenut kollu mill-punt tat-tluq jiġi rrappurtat. Jekk TYPE jitħalla barra, l-OpenLog awtomatikament jirrapporta f'ASCII. Hemm tliet TIPI ta' output:
  • ASCII = 1
  • EŻAKO = 2
  • MHUX MAĦDUM = 3
• Tista' tħalli barra xi argumenti wara. Iċċekkja l-eżempji li ġejjinamples.
• Qari bażiku + bnadar imħollija barra:
  • Example: aqra LOG00004.txt
  • Ħruġ: Aċċellerometru X=12 Y=215 Z=317
• Aqra mill-bidu 0 b'tul ta' 5:
  • Example: aqra LOG00004.txt 0 5
  • Output: Aċċelerazzjoni
• Aqra mill-pożizzjoni 1 b'tul ta' 5 f'HEX:
  • Example: aqra LOG00004.txt 1 5 2
  • Ħruġ: 63 63 65 6C
• Aqra mill-pożizzjoni 0 b'tul ta' 50 f'RAW:
  • Example: aqra LOG00137.txt 0 50 3
  • Riżultat: André– -tch Test Estiż tal-Karattri
• Cat File – Ikteb il-kontenut ta’ file f'eżagonali għall-monitor tas-serje għal viewing. Dan xi kultant ikun ta’ għajnuna biex tara li a file qed tirrekordja b'mod korrett mingħajr ma jkollok għalfejn tiġbed il-kard SD u view il file fuq kompjuter.
  • Example: cat LOG00004.txt
  • Riżultat: 00000000: 41 63 65 6c 3a 20 31

Manipulazzjoni tad-Direttorju

• ls – Jelenka l-kontenut kollu tad-direttorju kurrenti. Il-wildcards huma appoġġjati.
  • Example: ls
  • Riżultat: \src
• Sottodirettorju md – Oħloq Sottodirettorju fid-direttorju kurrenti.
  • Example: md Example_Sketches
• cd Subdirectory – Ibdel għas-Subdirectory.
  • Example: cd Hello_World
• cd .. – Ibdel għal direttorju aktar baxx fis-siġra. Innota li hemm spazju bejn 'cd' u '..'. Dan jippermetti lill-parser tal-istring jara l-kmand CD.
  • Example: cd ..
• rm Subdirectory – Iħassar is-Subdirectory. Id-direttorju jrid ikun vojt biex dan il-kmand jaħdem.
  • Example: temperaturi rm
• rm -rf Direttorju – Iħassar id-Direttorju u kwalunkwe files li jinsab fih.
  • Example: rm -rf Libreriji

Kmandi ta' Funzjoni ta' Livell Baxx

• ? – Dan il-kmand se juri lista ta' kmandi disponibbli fuq l-OpenLog.
• Diska – Uri l-ID tal-manifattur tal-kard, in-numru tas-serje, id-data tal-manifattura, u d-daqs tal-kard. Eż.ampL-output huwa:
  • Tip ta' karta: SD2 ID tal-manifattur: 3
  • ID tal-OEM: SD
  • Prodott: SU01G
  • Verżjoni: 8.0
  • Numru tas-serje: 39723042 Data tal-manifattura: 1/2010 Daqs tal-karta: 965120 KB
• init – Erġa’ inizjalizza s-sistema u erġa’ iftaħ il-kard SD. Dan huwa ta’ għajnuna jekk il-kard SD tieqaf tirrispondi.
• Sinkronizzazzjoni – Jissinkronizza l-kontenut attwali tal-buffer mal-karta SD. Dan il-kmand huwa utli jekk għandek inqas minn 512-il karattru fil-buffer u trid tirrekordjahom fuq il-karta SD.
• Irrisettja – Jaqbeż OpenLog għall-post żero, jerġa' jħaddem il-bootloader, u mbagħad il-kodiċi tal-inizjazzjoni. Dan il-kmand huwa utli jekk teħtieġ teditja l-konfigurazzjoni file, irrisettja l-OpenLog, u ibda uża l-konfigurazzjoni l-ġdida. Iċ-ċiklu tal-enerġija għadu l-metodu preferut biex tirrisettja l-bord, iżda din l-għażla hija disponibbli.

Issettjar tas-Sistema

Dawn is-settings jistgħu jiġu aġġornati jew editjati manwalment fil-config.txt file.

• Echo STATE – Jibdel l-istat tas-sistema, u jinħażen fil-memorja tas-sistema. STATE jista’ jkun mixgħul jew mitfi. Waqt li jkun mixgħul, l-OpenLog se juri d-dejta serjali riċevuta fuq il-prompt tal-kmand. Waqt li jkun mitfi, is-sistema ma taqrax lura l-karattri riċevuti.

Nota: Waqt il-logging normali, l-eku se jintefa. Id-domanda għar-riżorsi tas-sistema għall-eku tad-dejta riċevuta hija għolja wisq waqt il-logging.

• Verbose STATE – Jibdel l-istat tar-rappurtar ta' żbalji verbose. STATE jista' jkun mixgħul jew mitfi. Dan il-kmand jinħażen fil-memorja. Billi titfi l-iżbalji verbose, OpenLog jirrispondi b'! biss jekk ikun hemm żball, aktar milli kmand mhux magħruf: C OMMAND.D..T Il-karattri huma aktar faċli biex jiġu analizzati mis-sistemi integrati milli l-iżball sħiħ. Jekk qed tuża terminal, jekk tħalli verbose mixgħul, tara l-messaġġi ta' żball sħaħ.
• baud – Dan il-kmand jiftaħ menu tas-sistema li jippermetti lill-utent idaħħal rata ta' baud. Kwalunkwe rata ta' baud bejn 300bps u 1Mbps hija appoġġjata. L-għażla tar-rata ta' baud hija immedjata, u l-OpenLog jeħtieġ ċiklu ta' enerġija biex is-settings jidħlu fis-seħħ. Ir-rata ta' baud tinħażen fl-EEPROM u titgħabba kull darba li OpenLog jinxtegħel. Id-default hija 9600 8N1.

Ftakar: Jekk il-bord jeħel f'rata ta' baud mhux magħrufa, tista' tqabbad RX ma' GND u tixgħel OpenLog. L-LEDs se jteptep 'il quddiem u lura għal 2 sekondi u mbagħad se jteptep flimkien. Itfi l-OpenLog, u neħħi l-jumper. OpenLog issa huwa rrisettjat għal 9600bps bil-karattru tal-ħruġ ta' `CTRL-Z` ippressat tliet darbiet konsekuttivi. Din il-karatteristika tista' tiġi megħluba billi tissettja l-bit ta' Override ta' Emerġenza għal 1. Ara config.txt għal aktar tagħrif.

• Issettja – Dan il-kmand jiftaħ menu tas-sistema biex tagħżel il-modalità tal-istartjar. Dawn is-settings iseħħu meta l-apparat jinxtegħel li jmiss u jinħażnu f'EEPROM mhux volatili.
  • Ġdid File Reġistrazzjoni – Din il-modalità toħloq verżjoni ġdida file kull darba li OpenLog jinxtegħel. OpenLog se jittrażmetti 1 (UART ikun ħaj), 2 (il-karta SD tkun inizjalizzata), imbagħad < (OpenLog ikun lest biex jirċievi d-dejta). Id-dejta kollha tiġi rreġistrata f'LOG#####.txt. In-numru ##### jiżdied kull darba li OpenLog jinxtegħel (il-massimu huwa 65533 log). In-numru jinħażen fl-EEPROM u jista' jiġi rrisettjat mill-menu tas-set. Mhux il-karattri riċevuti kollha jiġu ripetuti. Tista' toħroġ minn din il-modalità u tidħol fil-modalità tal-kmand billi tibgħat CTRL+z (ASCII 26). Id-dejta kollha bbaferjata tinħażen.
• Nota: Jekk ikunu nħolqu wisq logs, OpenLog se juri l-iżball **Wisq logs**, oħroġ minn din il-modalità, u mur fil-Command Prompt. L-output tas-serjali se jidher bħal `12!Wisq logs!
  • Appendi File Reġistrazzjoni – Magħrufa wkoll bħala modalità sekwenzjali, din il-modalità toħloq file imsejjaħ SEQLOG.txt jekk ma jkunx diġà hemm, u jżid kwalunkwe dejta riċevuta mal- fileOpenLog se jittrażmetti 12< f'liema ħin OpenLog ikun lest biex jirċievi d-dejta. Il-karattri ma jiġux ripetuti. Tista' toħroġ minn din il-modalità u tidħol fil-modalità tal-kmand billi tibgħat CTRL+z (ASCII 26). Id-dejta kollha bbaferjata se tinħażen.
  • Prompt tal-Kmand – OpenLog se jittrażmetti 12> f'liema ħin is-sistema tkun lesta biex tirċievi kmandi. Innota li s-sinjal > jindika li OpenLog hija lesta biex tirċievi kmandi, mhux dejta. Tista' toħloq files u żid id-dejta ma' files, iżda dan jeħtieġ xi parsing tas-serje (għall-iċċekkjar tal-iżbalji), għalhekk ma nissettjawx din il-modalità awtomatikament.
  • Irrisettja Ġdid File Numru – Din il-modalità se tirrisettja l-log file numru għal LOG000.txt. Dan huwa utli jekk dan l-aħħar neħħietlek il-karta microSD u trid li l-log file numri biex jerġgħu jibdew mill-ġdid.
  • Karattru Ġdid tal-Ħarba – Din l-għażla tippermetti lill-utent idaħħal karattru, bħal CTRL+z jew $, u jissettjah bħala l-karattru l-ġdid tal-ħarba. Din l-issettjar tiġi rrisettjata għal CTRL+z waqt reset ta' emerġenza.
  • Numru ta' Karattri tal-Ħarba – Din l-għażla tippermetti lill-utent idaħħal karattru (bħal 1, 3, jew 17), u jaġġorna n-numru l-ġdid ta' karattri tal-ħarba meħtieġa biex jinżel għall-modalità tal-kmand. PereżempjuampPereżempju, jekk tidħol 8, l-utent ikollu jagħfas CTRL+z tmien darbiet biex jidħol fil-modalità tal-kmand. Din l-issettjar tiġi rrisettjata għal 3 waqt reset ta' emerġenza.
• Spjegazzjoni tal-Karattri tal-Ħarba: Ir-raġuni għaliex OpenLog jeħtieġ li tagħfas `CTRL+z` 3 darbiet biex tidħol fil-modalità tal-kmand hija biex tevita li l-bord jiġi resetjat aċċidentalment waqt it-tlugħ ta' kodiċi ġdid mill-Arduino IDE. Hemm ċans li l-bord jara l-karattru `CTRL+z` jidher waqt il-bootloading (kwistjoni li rajna fil-verżjonijiet bikrija tal-firmware OpenLog), għalhekk dan għandu l-għan li jipprevjeni dan. Jekk qatt tissuspetta li l-bord tiegħek ġie brickjat minħabba dan, dejjem tista' tagħmel reset ta' emerġenza billi żżomm il-pin RX mal-art waqt li tkun qed tixgħel il-kompjuter.

Konfigurazzjoni File

Jekk tippreferi ma tużax it-terminal tas-serje biex timmodifika s-settings fuq l-OpenLog tiegħek, tista' wkoll taġġorna s-settings billi timmodifika l-CONFIG.TXT file.

Nota: Din il-karatteristika taħdem biss fuq il-verżjoni tal-firmware 1.6 jew aktar ġdida. Jekk xtrajt OpenLog wara l-2012, se tkun qed tħaddem il-verżjoni tal-firmware 1.6+

• Biex tagħmel dan, ser ikollok bżonn qarrej tal-kards microSD u editur tat-test. Iftaħ il-config.txt file (il-kapitalizzazzjoni tal- file l-isem ma jimpurtax), u kkonfigura 'l bogħod! Jekk qatt ma xgħelt l-OpenLog tiegħek bil-kard SD qabel, tista' wkoll toħloq manwalment il- fileJekk xgħelt l-OpenLog bil-kard tal-microSD imdaħħla qabel, għandek tara xi ħaġa bħal din li ġejja meta taqra l-kard tal-microSD.L-OpenLog joħloq config.txt u LOG0000.txt file mal-ewwel tixgħel.
• Il-konfigurazzjoni default file għandu linja waħda ta' settings u linja waħda ta' definizzjonijiet.Il-konfigurazzjoni default file inkiteb mill-OpenLog.
• Innota li dawn huma karattri viżibbli regolari (m'hemm l-ebda valuri mhux viżibbli jew binarji), u kull valur huwa separat b'virgola.

Is-settings huma definiti kif ġej:

• baud: Ir-rata tal-baud tal-komunikazzjoni. 9600 bps hija l-għażla awtomatika. Valuri aċċettabbli li huma kompatibbli mal-Arduino IDE huma 2400, 4800, 9600, 19200, 38400, 57600, u 115200. Tista' tuża rati oħra ta' baud, iżda ma tkunx tista' tikkomunika mal-OpenLog permezz tal-monitor tas-serje tal-Arduino IDE.
• Escap:e Il-valur ASCII (f'format deċimali) tal-karattru tal-ħarba. 26 huwa CTRL+z u huwa l-inadempjent. 36 huwa $ u huwa karattru tal-ħarba użat komunement.
• Esc #: In-numru ta' karattri tal-ħruġ meħtieġa. B'mod awtomatiku, huwa tlieta, għalhekk trid tagħfas il-karattru tal-ħruġ tliet darbiet biex tidħol fil-modalità tal-kmand. Il-valuri aċċettabbli huma minn 0 sa 254. Jekk tissettja dan il-valur għal 0, il-verifika tal-karattri tal-ħruġ tiġi diżattivata kompletament.
• Modalità Modalità tas-Sistema. OpenLog jibda fil-modalità Log Ġdid (0) awtomatikament. Valuri aċċettabbli huma 0 = Log Ġdid, 1 = Log Sekwenzjali, 2 = Modalità tal-Kmand.
• Verb: Modalità verbose. Messaġġi ta' żball estiżi (verbose) huma mixgħula awtomatikament. Jekk tissettja dan għal 1, jinxtegħlu messaġġi ta' żball verbose (bħal kmand mhux magħruf: neħħi !). Jekk tissettja dan għal 0, l-iżbalji verbose jitfihom, iżda jirrispondi b' ! jekk ikun hemm żball. It-tifi tal-modalità verbose huwa utli jekk qed tipprova timmaniġġja żbalji minn sistema integrata.
• Eku: Modalità Eku. Waqt li tkun fil-modalità tal-kmand, il-karattri jiġu ripetuti awtomatikament. Jekk tissettja dan għal 0, l-eku tal-karattri jitfi. Huwa utli jekk timmaniġġja żbalji, u ma tridx li l-kmandi mibgħuta jiġu ripetuti lura lill-OpenLog.II
• iignoreRXEmergency Override. Normalment, OpenLog jagħmel reset ta' emerġenza meta l-pin RX jinġibed baxx waqt li tkun qed tixgħel il-qawwa. Jekk dan jiġi ssettjat għal 1, il-verifika tal-pin RX waqt li tkun qed tixgħel il-qawwa tiddiżattiva. Dan jista' jkun ta' għajnuna għal sistemi li jżommu l-linja RX baxxa għal diversi raġunijiet. Jekk Emergency Override ikun diżattivat, ma tkunx tista' tisforza l-unità lura għal 9600bps, u l-konfigurazzjoni file se jkun l-uniku mod biex timmodifika r-rata tal-baud.

Kif OpenLog Jimmodifika l-Konfigurazzjoni File
Hemm ħames sitwazzjonijiet differenti biex l-OpenLog jimmodifika l-config.txt file.

• Konfigurazzjoni file misjub: Waqt li jinxtegħel, OpenLog se jfittex għal config.txt file. Jekk il- file jinstab, OpenLog se juża s-settings inklużi u jissostitwixxi kwalunkwe settings tas-sistema maħżuna qabel.
• L-ebda konfigurazzjoni file misjub: Jekk OpenLog ma jistax isib il-config.txt file imbagħad OpenLog se joħloq config.txt u jirreġistra s-settings tas-sistema maħżuna bħalissa fih. Dan ifisser li jekk iddaħħal kard microSD ifformattjata ġdida, is-sistema tiegħek se żżomm is-settings attwali tagħha.
• Konfigurazzjoni korrotta file misjub: OpenLog se jħassar il-config.txt korrott file, u se jerġa' jikteb kemm is-settings interni tal-EEPROM kif ukoll is-settings tal-config.txt file għall-istat magħruf tajjeb ta' 9600,26,3,0,1,1,0.
• Valuri illegali fil-konfigurazzjoni fileJekk l-OpenLog jiskopri xi settings li fihom valuri illegali, OpenLog se jissostitwixxi l-valuri korrotti fil-config.txt file bis-settings tas-sistema EEPROM maħżuna bħalissa.
• Tibdil permezz tal-pront tal-kmand: Jekk is-settings tas-sistema jinbidlu permezz tal-pront tal-kmand (jew permezz ta' konnessjoni serjali jew permezz ta' kmandi serjali tal-mikrokontrollur) dawk il-bidliet jiġu rreġistrati kemm fl-EEPROM tas-sistema kif ukoll fil-config.txt file.
• Reset ta' Emerġenza: Jekk l-OpenLog jiġi ċċaqlaq mill-ġdid b'jumper bejn RX u GND, u l-bit ta' Override ta' Emerġenza jkun issettjat għal 0 (li jippermetti reset ta' emerġenza), OpenLog jerġa' jikteb kemm is-settings interni tal-EEPROM kif ukoll is-settings tal-config.txt file għall-istat magħruf tajjeb ta' 9600,26,3,0,1,1,0.

Issolvi l-problemi

Hemm diversi għażliet differenti biex tiċċekkja jekk għandekx problemi biex tikkonnettja fuq il-monitor tas-serjali, problemi b'karattri mitlufa fil-logs, jew tiġġieled OpenLog brickjat.

Iċċekkja l-Imġieba tal-LED STAT1
L-LED STAT1 juri mġiba differenti għal żewġ żbalji komuni differenti.

• 3 Teptip: Il-kard tal-microSD ma rnexxilhiex tiġi inizjalizzata. Jista' jkollok bżonn tifformattja l-kard b'FAT/FAT16 fuq kompjuter.
• 5 Teptip: OpenLog inbidel għal rata ta' baud ġdida u jeħtieġ li jitfi u jerġa' jinxtegħel.

Iċċekkja l-Istruttura tas-Subdirettorju Doppjament

• Jekk qed tuża l-OpenLog.ino ex defaultampPereżempju, OpenLog jappoġġja biss żewġ sottodirettorji. Ikollok bżonn tibdel FOLDER_TRACK_DEPTH minn 2 għan-numru ta' sottodirettorji li għandek bżonn tappoġġja. Ladarba tkun għamilt dan, ikkumpila mill-ġdid il-kodiċi, u tella' l-firmware modifikat.
• Ivverifika n-Numru ta' Files fid-Direttorju Prinċipali
• OpenLog se jappoġġja biss sa 65,534 log files fid-direttorju ewlieni. Nirrakkomandaw li tifformattja mill-ġdid il-kard microSD tiegħek biex ittejjeb il-veloċità tal-logging.
• Ivverifika d-Daqs tal-Firmware Modifikat tiegħek
• Jekk qed tikteb skeċċ apposta għall-OpenLog, ivverifika li l-iskeċċ tiegħek mhuwiex akbar minn 32,256. Jekk iva, se jaqta' l-ewwel 500 byte tal-memorja Flash, li tintuża mill-bootloader tas-serje Optiboot.
• Iċċekkja Doppjament File Ismijiet
• Kollha file L-ismijiet għandhom ikunu alfanumeriċi. MyLOG1.txt huwa tajjeb, imma Hi !e _ .txtt jista' ma jaħdimx.
• Uża 9600 Baud
• OpenLog jaħdem bl-ATmega328 u għandu ammont limitat ta' RAM (2048 bytes). Meta tibgħat karattri serjali lil OpenLog, dawn il-karattri jiġu bbaferjati. L-Ispeċifikazzjoni Simplifikata tal-Grupp SD tippermetti li SD card tieħu sa 250ms (taqsima 4.6.2.2 Kitba) biex tirrekordja blokka tad-dejta fil-memorja flash.
• B'9600bps, dan ifisser 960 byte (10 bits kull byte) kull sekonda. Dan ifisser 1.04ms kull byte. OpenLog bħalissa juża buffer ta' riċeviment ta' 512 byte sabiex ikun jista' jaħżen madwar 50ms ta' karattri. Dan jippermetti lil OpenLog jirċievi b'suċċess il-karattri kollha li jaslu b'9600bps. Hekk kif iżżid ir-rata tal-baud, il-buffer idum inqas.

Ħin ta' Qbiż tal-Buffer tal-OpenLog

Ħafna SD cards għandhom ħin ta' reġistrazzjoni aktar mgħaġġel minn 250ms. Dan jista' jiġi affettwat mill-'klassi' tal-card u kemm dejta diġà tkun maħżuna fuq il-card. Is-soluzzjoni hija li tintuża rata ta' baud aktar baxxa jew li jiżdied l-ammont ta' ħin bejn il-karattri mibgħuta bir-rata ta' baud ogħla.

Mistoqsijiet Frekwenti