DEV-13712 SparkFun Development Boards Giya sa Gumagamit

Taas ang ulo! Kini nga panudlo alang sa Open Log para sa serial UART [DEV-13712]. Kung ikaw naggamit sa Qwiic OpenLog para sa IC [DEV-15164], palihog tan-awa ang Qwiic OpenLog Hookup Guide.
Ang OpenLog Data Logger usa ka yano nga gamiton, open-source nga solusyon alang sa pag-log sa serial data gikan sa imong mga proyekto. Ang OpenLog naghatag og usa ka yano nga serial interface sa pag-log data gikan sa usa ka proyekto ngadto sa usa ka microSD card.SparkFun OpenLog
• DEV-13712SparkFun OpenLog uban sa mga ulohan
• DEV-13955

walay produkto nga nakit-an
Mga Materyal nga Gikinahanglan
Aron sa hingpit nga pagtrabaho pinaagi niini nga panudlo, kinahanglan nimo ang mosunod nga mga bahin. Mahimong dili nimo kinahanglan ang tanan bisan pa depende sa kung unsa ang naa nimo. Idugang kini sa imong cart, basaha ang giya, ug i-adjust ang cart kung gikinahanglan.
Giya sa OpenLog Hookup SparkFun Wish List

	Arduino Pro Mini 328 – 3.3V/8MHz DEV-11114 Kini asul! Nipis na! Kini ang Arduino Pro Mini! Ang gamay nga pamaagi sa disenyo sa SparkFun sa Arduino. Kini usa ka 3.3V Arduino…
	SparkFun FTDI Basic Breakout - 3.3V DEV-09873 Kini ang pinakabag-o nga rebisyon sa among [FTDI Basic](http://www.sparkfun.com/commerce/product_info.php?products_id=…
	SparkFun Cerberus USB Cable – 6ft CAB-12016 Naa kay sayop nga USB cable. Dili igsapayan kung kinsa ang naa nimo, kini ang sayup. Apan unsa kaha kung mahimo nimo…
	SparkFun OpenLog DEV-13712 Ang SparkFun OpenLog usa ka open source data logger nga naglihok sa usa ka yano nga serial connection ug nagsuporta sa mi…
	microSD Card nga adunay Adapter - 16GB (Klase 10) COM-13833 Kini usa ka klase nga 10 16GB microSD memory card, perpekto alang sa mga operating system sa pabalay alang sa usa ka board nga kompyuter usa ka…
	microSD USB Reader COM-13004 Kini usa ka katingad-an nga gamay nga microSD USB reader. I-slide lang ang imong microSD card sa sulod sa USB connector, t…
	Babaye nga mga Ulo PRT-00115 Usa ka laray sa 40 ka buho, babaye nga ulohan. Mahimong putlon sa gidak-on gamit ang usa ka parisan sa wire-cutter. Standard .1″ gilay-on. Atong gamiton…
	Ang Jumper Wires Premium 6″ M/M Pack sa 10 PRT-08431 Kini usa ka eksklusibo sa SparkFun! Kini ang 155mm nga taas nga mga jumper nga adunay mga konektor sa lalaki sa duha ka tumoy. Gamita kini aron…
	Pagbulag sa Laki nga Mga Ulo – Tuo nga Anggulo PRT-00553 Usa ka laray sa tuo nga anggulo nga mga header sa lalaki - bali aron mohaum. 40 ka mga pin nga mahimong putlon sa bisan unsang gidak-on. Gigamit sa naandan nga mga PCB o gen…

Girekomenda nga Pagbasa
Kung dili ka pamilyar o komportable sa mosunod nga mga konsepto, among girekomendar ang pagbasa niini sa dili pa magpadayon sa OpenLog Hookup Guide.
Unsaon Pagsolder: Pinaagi sa-Hole Soldering
Gisakup niini nga panudlo ang tanan nga kinahanglan nimong mahibal-an bahin sa through-hole soldering.
Serial Peripheral Interface (SPI)
Ang SPI kasagarang gigamit sa pagkonektar sa mga microcontroller sa mga peripheral sama sa mga sensor, shift register, ug SD card.
Serial nga Komunikasyon
Asynchronous nga serial communication concepts: packets, signal level, baud rates, UARTs ug uban pa!
Mga sukaranan sa Serial Terminal
Kini nga panudlo magpakita kanimo kung giunsa ang pagpakigsulti sa imong mga serial device gamit ang lainlaing mga aplikasyon sa terminal emulator.

Nahuman ang Hardwareview

Gahum
Ang OpenLog midagan sa mosunod nga mga setting:
OpenLog Power Ratings

VCC Input	3.3V-12V (Girekomenda nga 3.3V-5V)
RXI Input	2.0V-3.8V
TXO Output	3.3V
Idle Current Draw	~2mA-5mA (w/out microSD card), ~5mA-6mA (w/ microSD card)
Aktibo nga Pagsulat Current Draw	~20-23mA (w/ microSD card)

Ang karon nga draw sa OpenLog mga 20mA hangtod 23mA kung nagsulat sa usa ka microSD. Depende sa gidak-on sa microSD card ug sa tiggama niini, ang aktibo nga kasamtangan nga draw mahimong magkalahi kung ang OpenLog nagsulat sa memory card. Ang pagdugang sa baud rate mobira usab sa dugang nga kasamtangan.
Microcontroller
Ang OpenLog nagdagan sa usa ka onboard nga ATmega328, nga nagdagan sa 16MHz salamat sa onboard nga kristal. Ang ATmega328 adunay Optiboot bootloader nga gikarga niini, nga nagtugot sa OpenLog nga mahimong compatible sa "Arduino Uno" board setting sa Arduino IDE.Interface
Serial nga UART
Ang nag-unang interface sa OpenLog mao ang FTDI header sa kilid sa board. Kini nga header gidesinyo aron direkta nga ibutang sa usa ka Arduino Pro o Pro Mini, nga nagtugot sa microcontroller nga ipadala ang data sa usa ka serial nga koneksyon sa OpenLog.

Pasidaan! Tungod sa pag-order sa pin nga naghimo niini nga compatible sa Arduinos, dili kini direkta nga ibutang sa usa ka FTDI breakout board. Alang sa dugang nga impormasyon, siguroha nga susihon ang sunod nga seksyon sa Hardware Hookup.
SPI
Adunay usab upat ka mga punto sa pagsulay sa SPI nga gibuak sa pikas tumoy sa board. Mahimo nimong gamiton kini aron ma-reprogram ang bootloader sa ATmega328.Ang pinakabag-o nga OpenLog (DEV-13712) nagbuak niini nga mga lagdok sa mas gamay nga plated pinaagi sa mga lungag. Kung kinahanglan nimo nga mogamit usa ka ISP aron ma-reprogram o mag-upload og bag-ong bootloader sa OpenLog, mahimo nimong gamiton ang mga pogo pin aron makonektar sa kini nga mga punto sa pagsulay.
Ang katapusang interface alang sa pagpakigsulti sa OpenLog mao ang microSD card mismo. Aron makigkomunikar, ang microSD card nanginahanglan mga SPI pin. Dili lamang kini diin ang datos gitipigan sa OpenLog, apan mahimo usab nimo nga i-update ang configuration sa OpenLog pinaagi sa config.txt file sa microSD card.
MicroSD Card
Ang tanan nga datos nga gi-log sa OpenLog gitipigan sa microSD card. Ang OpenLog nagtrabaho uban sa mga microSD card nga naglakip sa mosunod nga mga bahin:

64MB hangtod sa 32GB
FAT16 o FAT32

Ang kahimtang sa LED
Adunay duha ka status LED sa OpenLog aron matabangan ka sa pag-troubleshoot.

STAT1 - Kini nga asul nga indikasyon nga LED gilakip sa Arduino D5 (ATmega328 PD5) ug i-on/off kung adunay bag-ong karakter nga nadawat. Kini nga LED mokidlap kung ang Serial nga komunikasyon naglihok.
STAT2 - Kini nga berde nga LED konektado sa Arduino D13 (SPI Serial Clock Line / ATmega328 PB5). Kini nga LED mokidlap lang kung aktibo ang interface sa SPI. Imong makita kini nga flash kung ang OpenLog nagrekord sa 512 bytes sa microSD card.

Pagdugtong sa Hardware

Adunay duha ka nag-unang pamaagi sa pagkonektar sa imong OpenLog sa usa ka sirkito. Kinahanglan nimo ang pipila ka mga header o wire aron makonektar. Siguroha nga magsolder ka sa board para sa luwas nga koneksyon.
Batakang Serial nga Koneksyon
Tip: Kung ikaw adunay usa ka babaye nga header ang OpenLog ug babaye nga header sa FTDI kinahanglan nimo ang M/F jumper wires aron makonektar.

Kini nga koneksyon sa hardware gidisenyo alang sa interfacing sa usa ka OpenLog kung kinahanglan nimo nga i-reprogram ang board, o pag-log data sa usa ka sukaranan nga serial connection.
Himoa ang mosunod nga mga koneksyon:
OpenLog → 3.3V FTDI Basic Breakout

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

Matikdi nga dili kini direkta nga koneksyon tali sa FTDI ug OpenLog - kinahanglan nimo nga ibalhin ang mga koneksyon sa TXO ug RXI pin.
Ang imong mga koneksyon kinahanglan nga tan-awon sama sa mosunod: Kung naa na nimo ang mga koneksyon tali sa OpenLog ug sa FTDI Basic, i-plug ang imong FTDI board sa USB cable ug sa imong computer.
Ablihi ang usa ka serial terminal, sumpay sa COM port sa imong FTDI Basic, ug adto sa lungsod!

Koneksyon sa Proyekto sa Hardware

Tip: Kung ikaw adunay mga babaye nga mga header nga gibaligya sa OpenLog, mahimo nimong ibaligya ang mga lalaki nga header sa Arduino Pro Mini aron madugtong ang mga tabla nga dili kinahanglan ang mga wire.Samtang ang interfacing sa OpenLog sa usa ka serial connection importante alang sa reprogramming o debugging, ang dapit diin ang OpenLog nagsidlak anaa sa usa ka embedded project. Kini nga kinatibuk-ang sirkito mao ang paagi nga among girekomendar nga imong i-hook ang imong OpenLog sa usa ka microcontroller (sa kini nga kaso, usa ka Arduino Pro Mini) nga mosulat sa serial data ngadto sa OpenLog.
Una kinahanglan nimo nga i-upload ang code sa imong Pro Mini nga gusto nimo nga padaganon. Palihug tan-awa ang Arduino Sketches alang sa pipila ka mga example code nga imong magamit.
Mubo nga sulat: Kung dili ka sigurado kung giunsa ang pagprograma sa imong Pro Mini, palihug tan-awa ang among panudlo dinhi.
Gamit ang Arduino Pro Mini 3.3V
Kini nga panudlo mao ang imong giya sa tanan nga mga butang Arduino Pro Mini. Gipatin-aw niini kung unsa kini, kung unsa ang dili, ug kung giunsa pagsugod ang paggamit niini.
Kung naprogram na nimo ang imong Pro Mini, mahimo nimong tangtangon ang FTDI board, ug pulihan kini sa OpenLog.
Siguruha nga ikonektar ang mga pin nga adunay label nga BLK sa parehas nga Pro Mini ug OpenLog (ang mga pin nga gimarkahan nga GRN sa duha magkatugma usab kung gibuhat sa husto).
Kung dili nimo ma-plug ang OpenLog direkta sa Pro Mini (tungod sa dili managsama nga mga header o uban pang mga tabla sa agianan), mahimo nimong gamiton ang mga jumper wire ug himuon ang mga mosunod nga koneksyon.
OpenLog → Arduino Pro/Arduino Pro Mini

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

Kung nahuman na ka, ang imong mga koneksyon kinahanglan nga tan-awon sama sa mosunod sa Arduino Pro Mini ug Arduino Pro.
Ang Fritzing diagram nagpakita sa OpenLogs nga ang mga header gisalamin. Kung imong i-flip ang microSD socket nga may kalabotan sa tumoy sa Arduino view, sila kinahanglan nga motakdo sa programming header sama sa usa ka FTDI.

Nota nga ang koneksyon usa ka tul-id nga shot sa OpenLog nga "upside-down" (nga ang microSD nag-atubang sa taas).
⚡Pahinumdom: Tungod kay ang Vcc ug GND sa taliwala sa OpenLog ug Arduino giokupahan sa mga ulohan, kinahanglan nimo nga magkonektar sa gahum sa ubang mga pin nga magamit sa Arduino. Kung dili, mahimo nimong ibaligya ang mga wire sa nahayag nga mga pin sa kuryente sa bisan asa nga tabla.
Pakusog ang imong sistema, ug andam ka na nga magsugod sa pag-log!

Mga Sketch sa Arduino

Adunay unom ka lainlain nga examples sketches naglakip nga imong magamit sa Arduino kon konektado sa usa ka OpenLog.

OpenLog_Benchmarking - Kini nga example gigamit sa pagsulay sa OpenLog. Nagpadala kini og daghan kaayong datos sa 115200bps sa daghang files.

OpenLog_CommandTest - Kini nga example nagpakita kon sa unsang paagi sa paghimo ug pagdugang a file pinaagi sa command line control pinaagi sa Arduino.
OpenLog_ReadExample — Kini nga example midagan sa paagi sa pagkontrolar sa OpenLog pinaagi sa command line.

OpenLog_ReadExample_DagkoFile — Example sa kon sa unsang paagi sa pag-abli sa usa ka dako nga gitipigan file sa OpenLog ug i-report kini sa usa ka lokal nga koneksyon sa bluetooth.
OpenLog_Test_Sketch - Gigamit sa pagsulay sa OpenLog nga adunay daghang serial data.

OpenLog_Test_Sketch_Binary — Gigamit sa pagsulay sa OpenLog gamit ang binary data ug mga karakter sa pag-eskapo.

Firmware

Ang OpenLog adunay duha ka nag-unang piraso sa software sa board: ang bootloader ug ang firmware.
Arduino Bootloader
Mubo nga sulat: Kon ikaw naggamit ug OpenLog nga gipalit sa wala pa ang Marso 2012, ang onboard bootloader kay compatible sa “Arduino Pro o Pro Mini 5V/16MHz w/ ATmega328” setting sa Arduino IDE.
Sama sa gihisgutan kaniadto, ang OpenLog adunay Optiboot serial bootloader nga sakay. Mahimo nimong trataron ang OpenLog sama sa Arduino Uno kung mag-upload sa example code o bag-ong firmware sa board.
Kung mahuman nimo ang pag-brick sa imong OpenLog ug kinahanglan nga i-install pag-usab ang bootloader, gusto nimo usab nga i-upload ang Optiboot sa board. Palihug tan-awa ang among tutorial sa pag-instalar sa Arduino Bootloader alang sa dugang nga impormasyon.
Pag-compile ug Pag-load sa Firmware sa OpenLog
Mubo nga sulat: Kung kini ang imong unang higayon nga naggamit sa Arduino, palihug pag-usabview among tutorial sa pag-instalar sa Arduino IDE. Kung wala ka pa naka-install sa library sa Arduino, palihug tan-awa ang among giya sa pag-install aron mano-mano nga i-install ang mga librarya.
Kung alang sa bisan unsang hinungdan kinahanglan nimo nga i-update o i-install pag-usab ang firmware sa imong OpenLog, ang mosunud nga proseso makapaandar ug makaandar ang imong board.
Una, palihug i-download ang Arduino IDE v1.6.5. Ang uban nga mga bersyon sa IDE mahimong molihok aron makolekta ang OpenLog firmware, apan among gipamatud-an kini ingon usa ka nahibal-an nga maayong bersyon.
Sunod, i-download ang OpenLog firmware ug gikinahanglan nga libraries bundle.

DOWNLOAD OPENLOG FIRMWARE BUNDLE (ZIP)
Kung na-download na nimo ang mga librarya ug firmware, i-install ang mga librarya sa Arduino. Kung dili ka sigurado unsaon pag-install sa mano-mano ang mga librarya sa IDE, palihug tan-awa ang among tutorial: Pag-instalar sa Arduino Library: Manwal nga Pag-install sa Library.
Mubo nga sulat: Gigamit namo ang giusab nga mga bersyon sa SdFat ug SerialPort nga mga librarya aron arbitraryong ideklarar kung unsa ka dako ang TX ug RX buffers. Ang OpenLog nagkinahanglan sa TX buffer nga gamay kaayo (0) ug ang RX buffer kinahanglan nga dako kutob sa mahimo. Ang paggamit niining duha ka giusab nga mga librarya nga magkauban nagtugot sa dugang nga performance sa OpenLog.
Nangita alang sa Pinakabag-ong Bersyon? Kung gusto nimo ang pinakabag-o nga mga bersyon sa mga librarya ug firmware, mahimo nimo kining i-download direkta gikan sa GitHub repository nga nalambigit sa ubos. Ang SdFatLib ug Serial Port nga mga librarya dili makita sa Arduino board manager busa kinahanglan nimo nga mano-mano nga i-install ang librarya.

GitHub: OpenLog > Firmware > OpenLog_Firmware
Ang Arduino Libraries ni Bill Greiman
SdFatLib-beta
SerialPort

Sunod, sa pagkuha sa advantage sa giusab nga mga librarya, usba ang SerialPort.h file makita sa \ Arduino \ Libraries \ SerialPort direktoryo. Usba ang BUFFERED_TX ngadto sa 0 ug ENABLE_RX_ERROR_CHECKING ngadto sa 0 . I-save ang file, ug ablihi ang Arduino IDE.
Kung wala ka pa, ikonektar ang imong OpenLog sa kompyuter pinaagi sa FTDI board. Palihug i-double check ang example circuit kung dili ka sigurado kung giunsa kini buhaton sa husto.
Ablihi ang OpenLog sketch nga gusto nimong i-upload ubos sa Tools> Board menu, pilia ang "Arduino/Genuino Uno", ug pilia ang tukma nga COM port para sa imong FTDI board ubos sa Tools> Port.
I-upload ang code.
Mao na! Ang imong OpenLog giprograma na karon sa bag-ong firmware. Mahimo nimong ablihan ang usa ka serial monitor ug makig-uban sa OpenLog. Sa power up, imong makita ang 12> o 12< . Ang 1 nagpaila nga ang serial connection natukod, 2 nagpaila nga ang SD card malampuson nga nasugdan, <nagpaila nga ang OpenLog andam na sa pag-log sa bisan unsang nadawat nga serial data ug> nagpakita nga ang OpenLog andam na sa pagdawat sa mga sugo.
OpenLog Firmware Sketches
Adunay tulo ka gilakip nga mga sketch nga imong magamit sa OpenLog, depende sa imong partikular nga aplikasyon.

OpenLog - Kini nga firmware gipadala pinaagi sa default sa OpenLog. Nagpadala sa? Ang command magpakita sa bersyon sa firmware nga gikarga sa usa ka yunit.
OpenLog_Light - Kini nga bersyon sa sketch nagtangtang sa menu ug command mode, nga nagtugot sa makadawat nga buffer nga madugangan. Kini usa ka maayong kapilian alang sa high-speed nga pag-log.

OpenLog_Minimal - Ang baud rate kinahanglan ibutang sa code ug i-upload. Kini nga sketch girekomenda alang sa mga eksperyensiyado nga tiggamit apan kini usab ang labing kaayo nga kapilian alang sa labing taas nga tulin nga pag-log.

Set sa Sugo

Mahimo kang mag-interface sa OpenLog pinaagi sa serial terminal. Ang mosunod nga mga sugo makatabang kanimo sa pagbasa, pagsulat, ug pagtangtang files, ingon man usab sa pagbag-o sa mga setting sa OpenLog. Kinahanglan nga anaa ka sa Command Mode aron magamit ang mosunod nga mga setting.
Samtang ang OpenLog naa sa Command Mode, ang STAT1 mag-on/off sa matag karakter nga nadawat. Ang LED magpabilin hangtod madawat ang sunod nga karakter.

File Manipulasyon

bag-o File - Naghimo usa ka bag-o file ginganlan File sa kasamtangan nga direktoryo. Sumbanan 8.3 filegisuportahan ang mga ngalan.
Kay example, "87654321.123" madawat, samtang "987654321.123" dili.
• Example: bag-o file1.txt
idugang File - Idugang ang teksto sa katapusan sa File. Ang serial data dayon basahon gikan sa UART sa usa ka sapa ug idugang kini sa file. Wala kini gipalanog sa serial terminal. Kung File wala maglungtad kung kini nga function gitawag, ang file pagabuhaton.
• Example: idugang ang bag-ofile.csv

pagsulat File OFFSET – Pagsulat og teksto sa File gikan sa lokasyon OFFSET sulod sa file. Ang teksto gibasa gikan sa UART, linya sa linya ug gipalanog balik. Aron makagawas niini nga estado, ipadala ang walay sulod nga linya.
• Example: isulat ang logs.txt 516
rm File – Pagtangtang File gikan sa kasamtangan nga direktoryo. Gisuportahan ang mga wildcard.
• Example: rm README.txt
gidak-on File – Output gidak-on sa File sa bytes.
• Example: gidak-on Log112.csv
• Output: 11
basaha File + SUGOD+ NGA TYPE - Output ang sulod sa File sugod sa SUGOD ug magpadayon sa DUGAY.
Kung ang START dili iapil, ang tibuok file gitaho. Kung ang LENGTH wala iapil, ang tibuuk nga sulud gikan sa sinugdanan nga punto gitaho. Kung ang TYPE wala iapil, ang OpenLog mahimong default sa pagreport sa ASCII. Adunay tulo ka mga TYPE sa output:
• ASCII = 1
• HEX = 2
• RAW = 3
Mahimo nimong biyaan ang pipila ka nagsunod nga mga argumento. Susiha ang mosunod nga examples.
Panguna nga pagbasa + wala iapil nga mga bandila:
• Example: basaha ang LOG00004.txt
• Output: Accelerometer X=12 Y=215 Z=317
Basaha gikan sa pagsugod 0 nga adunay gitas-on nga 5:
• Example: basaha ang LOG00004.txt 0 5
• Output: Accel
Basaha gikan sa posisyon 1 nga adunay gitas-on nga 5 sa HEX:
• Example: basaha ang LOG00004.txt 1 5 2
• Output: 63 63 65 6C
Basaha gikan sa posisyon 0 nga adunay gitas-on nga 50 sa RAW:
• Example: basaha ang LOG00137.txt 0 50 3
• Output: André– -þ Extended Character Test
iring File – Isulat ang sulod sa a file sa hex sa serial monitor alang sa viewing. Kini usahay makatabang sa pagtan-aw nga a file husto ang pagrekord nga dili kinahanglan nga ibira ang SD card ug view ang file sa usa ka kompyuter.
• Example: iring LOG00004.txt
• Output: 00000000: 41 63 65 6c 3a 20 31

Manipulasyon sa Direktoryo

ls – Naglista sa tanang sulod sa kasamtangang direktoryo. Gisuportahan ang mga wildcard.
• Example: ls
• Output: \src
md Subdirectory - Paghimo Subdirectory sa kasamtangan nga direktoryo.
• Example: md Example_Sketches
cd Subdirectory - Pag-ilis sa Subdirectory.
• Example: cd Hello_World
cd .. – Pag-ilis sa ubos nga direktoryo sa kahoy. Timan-i nga adunay luna tali sa 'cd' ug '..'. Gitugotan niini ang string parser nga makita ang cd command.
• Exampug: cd..
rm Subdirectory - Pagtangtang sa Subdirectory. Ang direktoryo kinahanglan nga walay sulod aron kini nga sugo molihok.
• Example: rm temps
rm -rf Direktoryo - Pagtangtang sa Direktoryo ug bisan unsa files anaa sa sulod niini.
• Example: rm -rf Mga librarya

Ubos nga Level Function Commands

? – Kini nga sugo mokuha sa usa ka lista sa anaa nga mga sugo sa OpenLog.
disk – Ipakita ang card manufacturer ID, serial number, petsa sa paghimo ug gidak-on sa card. Exampang output mao ang:
Matang sa kard: SD2
Manufacturer ID: 3
OEM ID: SD
Produkto: SU01G
Bersyon: 8.0
Serial nga Numero: 39723042
Petsa sa paghimo: 1/2010
Gidak-on sa Card: 965120 KB
init - I-reinitialize ang sistema ug ablihan pag-usab ang SD card. Makatabang kini kung ang SD card mohunong sa pagtubag.
sync - I-synchronize ang kasamtangan nga mga sulod sa buffer sa SD card. Kini nga sugo mapuslanon kon ikaw adunay ubos pa sa 512 nga mga karakter sa buffer ug gusto nga irekord ang mga anaa sa SD card.
pag-reset - Paglukso sa OpenLog sa lokasyon nga zero, pag-rerun sa bootloader ug dayon init nga code. Kini nga sugo makatabang kung kinahanglan nimo nga usbon ang config file, i-reset ang OpenLog ug sugdi gamit ang bag-ong configuration. Ang pagbisikleta sa kuryente mao gihapon ang gipalabi nga pamaagi sa pag-reset sa board, apan kini nga kapilian magamit.

Mga Setting sa Sistema

Kini nga mga setting mahimong manual nga ma-update, o i-edit sa config.txt file.

echo STATE - Gibag-o ang kahimtang sa sistema nga echo, ug gitipigan sa memorya sa sistema. STATE mahimong on o off . Samtang on , ang OpenLog mopalanog sa nadawat nga serial data sa command prompt. Samtang wala, ang sistema wala magbasa og balik sa nadawat nga mga karakter.
Mubo nga sulat: Atol sa normal nga pag-log, ang echo mapalong. Ang gikinahanglan nga kahinguhaan sa sistema alang sa pagpalanog sa nadawat nga datos taas kaayo sa panahon sa pag-log.
verbose STATE - Gibag-o ang kahimtang sa verbose nga pagreport sa sayup. STATE mahimong on o off . Kini nga sugo gitipigan sa memorya. Pinaagi sa pagpalong sa verbose nga mga sayop, ang OpenLog motubag lamang sa usa ka ! kon adunay sayop kay sa wala mailhi nga sugo: COMMAND . Ang ! Ang karakter mas sayon alang sa mga naka-embed nga sistema sa pag-parse kaysa sa bug-os nga sayup. Kung naggamit ka usa ka terminal, ang pagbilin sa verbose sa magtugot kanimo nga makita ang tibuuk nga mga mensahe sa sayup.

baud - Kini nga sugo mag-abli sa usa ka menu sa sistema nga nagtugot sa user sa pagsulod sa usa ka baud rate. Ang bisan unsang baud rate tali sa 300bps ug 1Mbps gisuportahan. Ang pagpili sa baud rate diha-diha dayon, ug ang OpenLog nanginahanglan usa ka siklo sa kuryente aron ma-epekto ang mga setting. Ang baud rate gitipigan sa EEPROM ug gikarga sa matag higayon nga moandar ang OpenLog. Ang default mao ang 9600 8N1.

Hinumdumi: Kung ma-stuck nimo ang board sa wala mahibal-an nga baud rate, mahimo nimong ihigot ang RX sa GND ug i-power up ang OpenLog. Ang mga LED mokidlap balik-balik sulod sa 2 segundos ug dayon mokidlap nga magdungan. Ipaubos ang OpenLog, ug kuhaa ang jumper. Ang OpenLog karon gi-reset sa 9600bps nga adunay escape character nga `CTRL-Z` nga gipugos sa tulo ka sunod-sunod nga higayon. Kini nga bahin mahimong ma-override pinaagi sa pagbutang sa Emergency Override bit sa 1.
Tan-awa ang config.txt para sa dugang nga impormasyon.

set - Kini nga sugo nagbukas sa usa ka menu sa sistema aron mapili ang boot up mode. Kini nga mga setting mahitabo sa
• sunod nga gahum-on ug gitipigan sa non-volatile EEPROM. Bag-o File Pag-log - Kini nga mode nagmugna og bag-o file sa matag higayon nga ang OpenLog modagan. Ang OpenLog magpadala sa 1 (Buhi ang UART), 2 (gi-initialize ang SD card), dayon < (Andam na ang OpenLog sa pagdawat sa datos). Ang tanan nga datos irekord sa usa ka LOG#####.txt . Ang ##### nga numero modaghan matag higayon nga ang OpenLog mogahom (ang labing taas kay 65533 ka log). Ang numero gitipigan sa EEPROM ug mahimong i-reset gikan sa set menu.
Ang tanan nga nadawat nga mga karakter wala gipalanog. Mahimo kang mogawas niini nga mode ug mosulod sa command mode pinaagi sa pagpadala sa CTRL+z (ASCII 26). Ang tanan nga buffered data itago.

Mubo nga sulat: Kon daghan kaayong mga troso ang nabuhat, ang OpenLog magpagawas ug sayop **Daghan kaayong mga troso**, mogawas niini nga mode, ug ihulog ngadto sa Command Prompt. Ang serial output morag `12! Daghan kaayong mga troso!`.

Idugang File Pag-log - Nailhan usab nga sequential mode, kini nga mode nagmugna usa ka file gitawag nga SEQLOG.txt kung wala pa kini, ug idugang ang bisan unsang nadawat nga datos sa file. Ang OpenLog mopadala sa 12< diin ang OpenLog andam na sa pagdawat sa datos. Ang mga karakter wala gipalanog. Mahimo kang mogawas niini nga mode ug mosulod sa command mode pinaagi sa pagpadala sa CTRL+z (ASCII 26). Ang tanan nga buffered data itago.
Command Prompt - Ang OpenLog magpadala sa 12> diin ang sistema andam na sa pagdawat sa mga sugo. Timan-i nga ang > ilhanan nagpakita nga ang OpenLog andam na sa pagdawat sa mga sugo, dili data. Makahimo ka files ug idugang ang datos sa files, apan nagkinahanglan kini og pipila ka serial parsing (alang sa pagsusi sa sayop), mao nga dili namo ibutang kini nga mode pinaagi sa default.

I-reset ang Bag-o File Numero - Kini nga mode mag-reset sa log file numero sa LOG000.txt . Makatabang kini kung bag-o lang nimo natangtang ang usa ka microSD card ug gusto ang log file mga numero aron magsugod pag-usab.
Bag-ong Escape Character – Kini nga opsyon nagtugot sa user sa pagsulod sa usa ka karakter sama sa CTRL+z o $ , ug ibutang kini isip bag-ong escape character. Kini nga setting gi-reset sa CTRL+z atol sa emergency reset.
Gidaghanon sa Escape Characters - Kini nga opsyon nagtugot sa user sa pagsulod sa usa ka karakter (sama sa 1, 3, o 17), pag-update sa bag-ong gidaghanon sa mga karakter sa pag-ikyas nga gikinahanglan aron ihulog sa command mode. Kay exampSa pagkakaron, ang pagsulod sa 8 magkinahanglan nga ang user moigo sa CTRL+z walo ka beses aron makaadto sa command mode. Kini nga setting gi-reset ngadto sa 3 atol sa emergency reset.

Escape Characters Explanation: Ang rason nga ang OpenLog nagkinahanglan og `CTRL+z` hit 3 ka beses aron makasulod sa command mode mao ang pagpugong sa board nga aksidenteng ma-reset atol sa pag-upload sa bag-ong code gikan sa Arduino IDE. Adunay higayon nga ang board makakita sa `CTRL + z` nga karakter nga moabut sa panahon sa bootloading (usa ka isyu nga among nakita sa unang mga bersyon sa OpenLog firmware), mao nga kini nagtumong sa pagpugong niana. Kung nagduda ka nga ang imong board na-brick tungod niini, mahimo nimo kanunay ang usa ka emergency reset pinaagi sa pagpugong sa RX pin sa yuta sa panahon sa power up.

Pag-configure File

Kung dili nimo gusto nga gamiton ang serial terminal alang sa pag-usab sa mga setting sa imong OpenLog, mahimo usab nimo nga i-update ang mga setting pinaagi sa pag-usab sa CONFIG.TXT. file.
Mubo nga sulat: Kini nga bahin naglihok lamang sa firmware nga bersyon 1.6 o mas bag-o. Kung nakapalit ka ug OpenLog pagkahuman sa 2012, magpadagan ka sa bersyon sa firmware nga 1.6+
Aron mahimo kini, kinahanglan nimo ang usa ka microSD card reader ug usa ka text editor. Ablihi ang config.txt file (ang capitalization sa file dili igsapayan ang ngalan), ug i-configure ang layo! Kung wala pa nimo gipaandar ang imong OpenLog gamit ang SD card kaniadto, mahimo ka usab nga mano-mano ang paghimo sa file. Kung gipakusog nimo ang OpenLog gamit ang microSD card nga gisal-ot kaniadto, kinahanglan nimo nga makita ang usa ka butang sama sa mosunod kung imong basahon ang microSD card.Ang OpenLog nagmugna og config.txt ug LOG0000.txt file sa unang power up.
Ang default nga configuration file adunay usa ka linya sa mga setting ug usa ka linya sa mga kahulugan.Default nga configuration file gisulat sa OpenLog.
Timan-i nga kini mga regular nga makita nga mga karakter (walay dili makita o binary nga mga kantidad), ug ang matag bili gibulag sa usa ka comma.
Ang mga setting gihubit sama sa mosunod:

baud : Ang baud rate sa komunikasyon. Ang 9600bps maoy default. Ang madawat nga mga bili nga nahiuyon sa Arduino IDE mao ang 2400, 4800, 9600, 19200, 38400, 57600, ug 115200. Mahimo nimong gamiton ang ubang baud rates, apan dili ka makakomunikar sa OpenLog pinaagi sa Arduino IDE serial monitor.

pag-ikyas : Ang kantidad sa ASCII (sa desimal nga pormat) sa karakter sa pag-ikyas. 26 mao ang CTRL+z ug maoy default. Ang 36 mao ang $ ug usa ka kasagarang gigamit nga karakter sa pag-ikyas.
esc# : Ang gidaghanon sa mga karakter sa pag-ikyas gikinahanglan. Sa kasagaran, tulo kini, mao nga kinahanglan nimo nga maigo ang karakter sa pag-ikyas sa tulo ka beses aron ihulog sa command mode. Ang madawat nga mga bili gikan sa 0 ngadto sa 254. Ang pagtakda niini nga bili ngadto sa 0 makapawala sa hingpit nga pagsusi sa karakter sa pag-ikyas.
mode : System mode. Ang OpenLog magsugod sa New Log mode( 0 ) nga default. Ang madawat nga mga kantidad mao ang 0 = Bag-ong Log, 1 = Sequential Log, 2 = Command Mode.

berbo : Verbose mode. Ang gipalapdan (verbose) nga mga mensahe sa sayup gi-on pinaagi sa default. Ang pag-set niini sa 1 mopabalik sa verbose error messages (sama sa wala mailhi nga sugo: kuhaa ! ). Ang pagbutang niini sa 0 makapalong sa verbose nga mga sayop apan motubag sa usa ka ! kung naay sayop. Ang pag-off sa verbose mode magamit kung imong gisulayan ang pagdumala sa mga sayup gikan sa usa ka naka-embed nga sistema.
echo : Echo mode. Samtang sa command mode, ang mga karakter gipalanog pinaagi sa default. Ang pag-set niini sa 0 makapalong sa character echo. Ang pagpalong niini magamit kung magdumala sa mga sayup ug dili nimo gusto nga ipadala ang mga mando nga ibalik sa OpenLog.
ignoreRX : Emergency Override. Kasagaran, ang OpenLog mag-reset sa emerhensya kung ang RX pin gibira sa ubos sa panahon sa power up. Ang pag-set niini sa 1 mag-disable sa pagsusi sa RX pin atol sa power up. Makatabang kini alang sa mga sistema nga maghupot sa linya sa RX nga ubos sa lainlaing mga hinungdan. Kung ang Emergency Override ma-disable, dili nimo mapugos ang unit balik sa 9600bps, ug ang configuration file mao lamang ang paagi sa pag-usab sa baud rate.

Giunsa Pagbag-o sa OpenLog ang Config File
Adunay lima ka lain-laing mga sitwasyon alang sa OpenLog sa pag-usab sa config.txt file.

Config file nakit-an: Atol sa power up, ang OpenLog mangita og config.txt file. Kung ang file nakit-an, gamiton sa OpenLog ang gilakip nga mga setting ug i-overwrite ang bisan unsang gitipigan kaniadto nga mga setting sa sistema.
Walay config file nakit-an: Kung dili makit-an sa OpenLog ang config.txt file unya ang OpenLog maghimo og config.txt ug irekord ang kasamtangan nga gitipigan nga mga setting sa sistema niini. Kini nagpasabot nga kon magsal-ot ka og bag-ong gi-format nga microSD card, ang imong sistema magmintinar sa kasamtangang mga setting niini.

Corrupt nga config file nakit-an: Ang OpenLog mopapas sa dunot nga config.txt file, ug isulat pag-usab ang internal nga mga setting sa EEPROM ug ang mga setting sa config.txt file ngadto sa nailhan-maayong kahimtang sa 9600,26,3,0,1,1,0 .
Ilegal nga kantidad sa config file: Kung madiskubre sa OpenLog ang bisan unsang mga setting nga adunay mga ilegal nga kantidad, ang OpenLog mag-overwrite sa mga dunot nga kantidad sa config.txt file uban sa kasamtangan nga gitipigan nga mga setting sa sistema sa EEPROM.
Mga pagbag-o pinaagi sa command prompt: Kung ang mga setting sa sistema giusab pinaagi sa command prompt (bisan sa usa ka serial connection o pinaagi sa microcontroller serial commands) kadtong mga pagbag-o irekord sa EEPROM system ug sa config.txt file.

Emergency Reset: Kung ang OpenLog kay power cycled nga adunay jumper tali sa RX ug GND, ug ang Emergency Override bit gibutang sa 0 (nagtugot sa emergency reset), ang OpenLog mag-rewrite sa internal EEPROM settings ug sa config.txt settings file ngadto sa nailhan-maayong kahimtang sa 9600,26,3,0,1,1,0 .

Pag-troubleshoot

Adunay ubay-ubay nga lainlain nga mga kapilian aron masusi kung adunay mga isyu sa pagkonekta sa serial monitor, adunay mga isyu sa nahulog nga mga karakter sa mga troso, o nakig-away sa usa ka bricked nga OpenLog.
Susiha ang STAT1 LED Behavior
STAT1 LED nagpakita sa lain-laing mga kinaiya alang sa duha ka lain-laing mga komon nga mga sayop.

3 Blinks: Ang microSD card napakyas sa pagsugod. Tingali kinahanglan nimo nga i-format ang kard gamit ang FAT/FAT16 sa usa ka kompyuter.

5 Blinks: Ang OpenLog nausab ngadto sa bag-ong baud rate ug kinahanglan nga power cycled.

Dobleng Pagsusi sa Istruktura sa Subdirectory
Kung gigamit nimo ang default nga OpenLog.ino example, OpenLog mosuporta lamang sa duha ka mga subdirektoryo. Kinahanglan nimong usbon ang FOLDER_TRACK_DEPTH gikan sa 2 ngadto sa gidaghanon sa mga subdirectory nga kinahanglan nimong suportahan. Kung nahuman na nimo kini, i-compile pag-usab ang code, ug i-upload ang giusab nga firmware.
Tinoa ang Numero sa Files sa Root Directory
Ang OpenLog mosuporta lamang hangtod sa 65,534 ka log files sa root directory. Among girekomendar nga i-reformat ang imong microSD card aron mapausbaw ang logging speed.
Tinoa ang Gidak-on sa imong Modified Firmware
Kung nagsulat ka ug custom sketch para sa OpenLog, pamatud-i nga ang imong sketch dili mas dako sa 32,256. Kung mao, kini maputol sa taas nga 500 bytes sa Flash memory, nga gigamit sa Optiboot serial bootloader.
Doble nga Check File Mga ngalan
Tanan file ang mga ngalan kinahanglan alpha-numeric. Ok ra ang MyLOG1.txt, pero Hi !e _.txt basin dili mugana.
Gamita ang 9600 Baud
Ang OpenLog nagdagan gikan sa ATmega328 ug adunay limitado nga kantidad sa RAM (2048 bytes). Kung magpadala ka ug mga serial character sa OpenLog, kini nga mga karakter ma-buffer. Gitugotan sa SD Group Simplified Specification ang usa ka SD card nga moabot hangtod sa 250ms (seksyon 4.6.2.2 Isulat) aron marekord ang usa ka bloke sa datos sa flash memory.
Sa 9600bps, kana 960 bytes (10 bits kada byte) kada segundo. Kana mao ang 1.04ms matag byte. Ang OpenLog sa pagkakaron naggamit sa usa ka 512 byte nga makadawat buffer aron kini maka-buffer sa mga 50ms nga mga karakter. Gitugotan niini ang OpenLog nga malampuson nga makadawat sa tanan nga mga karakter nga moabut sa 9600bps. Samtang imong gipataas ang baud rate, ang buffer molungtad og gamay nga oras.
OpenLog Buffer Overrun Time

Baud Rate	Oras kada byte	Oras Hangtud Ma-overrun ang Buffer
9600bps	1.04ms	532ms
57600bps	0.174ms	88ms
115200bps	0.087ms	44ms

Daghang mga SD card ang adunay mas paspas nga oras sa pagrekord kaysa 250ms. Mahimong maapektuhan kini sa 'klase' sa kard ug kung pila na ang datos nga gitipigan sa kard. Ang solusyon mao ang paggamit sa mas ubos nga baud rate o pagdugang sa gidugayon sa oras tali sa mga karakter nga gipadala sa mas taas nga baud rate.
I-format ang imong MicroSD Card
Hinumdumi ang paggamit sa usa ka kard nga adunay gamay o wala files sa ibabaw niini. Usa ka microSD card nga adunay 3.1GB nga kantidad sa ZIP files o mga MP3 adunay mas hinay nga oras sa pagtubag kaysa usa ka walay sulod nga kard.
Kung wala nimo ma-format ang imong microSD card sa Windows OS, i-reformat ang microSD card ug paghimo og DOS filesistema sa SD card.
Ibaylo ang mga MicroSD Card
Adunay daghang lain-laing mga matang sa mga tiggama og kard, gi-relabel nga mga kard, mga gidak-on sa kard, ug mga klase sa kard, ug tingali dili kini tanan nagtrabaho sa hustong paagi. Kasagaran naggamit kami usa ka 8GB nga klase nga 4 nga microSD card, nga maayo ang pagtrabaho sa 9600bps. Kung kinahanglan nimo ang mas taas nga baud rate, o mas dako nga storage space, mahimo nimong sulayan ang class 6 o labaw pa nga mga card.
Idugang ang mga Paglangay Tali sa mga Pagsulat sa Karakter
Pinaagi sa pagdugang og gamay nga paglangan tali sa Serial.print() nga mga pahayag, mahimo nimong hatagan ang OpenLog og higayon sa pagrekord sa kasamtangan niini.
buffer.
Kay example:
Serial.begin(115200);
kay(int i = 1 ; i < 10 ; i++) {
Serial.print(i, DEC);
Serial.println(“:abcdefghijklmnopqrstuvwxyz-!#”);
}

Mahimong dili maayo ang pag-log, tungod kay adunay daghang mga karakter nga gipadala sa tupad sa usag usa. Ang pagsal-ot og gamay nga paglangan sa 15ms tali sa dagkong mga sinulat nga karakter makatabang sa OpenLog nga rekord nga walay paghulog sa mga karakter.
Serial.begin(115200);
kay(int i = 1 ; i < 10 ; i++) {
Serial.print(i, DEC);
Serial.println(“:abcdefghijklmnopqrstuvwxyz-!#”);
paglangan(15);
}

Idugang ang Arduino Serial Monitor Compatibility
Kung mosulay ka sa paggamit sa OpenLog sa built-in nga serial library o sa SoftwareSerial library, mahimo nimong mamatikdan ang mga isyu sa command mode. Ang Serial.println() nagpadala sa bag-ong linya UG pagbalik sa karwahe. Adunay duha ka alternatibong mga sugo aron mabuntog kini.
Ang una mao ang paggamit sa \r command (ASCII carriage return):
Serial.print("TEXT\r");
Sa laing paagi, mahimo nimong ipadala ang kantidad nga 13 (decimal carriage return):
Serial.print("TEXT");
Serial.write(13);

Emergency Reset
Hinumdumi, kung kinahanglan nimo nga i-reset ang OpenLog sa usa ka default nga estado, mahimo nimong i-reset ang board pinaagi sa paghigot sa RX pin sa GND, pagpaandar sa OpenLog, paghulat hangtod nga ang mga LED magsugod sa pagkidlap sa dungan, ug dayon ipaubos ang OpenLog ug tangtangon ang jumper.
Kung imong giusab ang Emergency Override bit ngadto sa 1, kinahanglan nimo nga usbon ang configuration file, tungod kay ang Emergency Reset dili molihok.
Susiha uban sa Komunidad
Kung naa ka pa sa mga isyu sa imong OpenLog, palihug tan-awa ang karon ug sirado nga mga isyu sa among GitHub repository dinhi. Adunay usa ka dako nga komunidad nga nagtrabaho kauban ang OpenLog, mao nga adunay posibilidad nga adunay usa nga nakit-an nga solusyon sa problema nga imong nakita.

Mga Kapanguhaan ug Pagpadayon

Karon nga malampuson ka nga naka-log data gamit ang imong OpenLog, mahimo nimong i-set up ang mga remote nga proyekto ug mamonitor ang tanang posibleng data nga moabot. Ikonsiderar ang paghimo sa imong kaugalingon nga proyekto sa Citizen Science, o bisan usa ka pet tracker aron makita kung unsa ang gibuhat ni Fluffy kung naa sa gawas!
Tan-awa kining dugang nga mga kapanguhaan alang sa pag-troubleshoot, tabang, o inspirasyon alang sa imong sunod nga proyekto.

OpenLog GitHub
Illumitune Project
LilyPad Light Sensor Hookup
BadgerHack: Soil Sensor Add-On
Pagsugod sa OBD-II
Vernier Photogate

Nagkinahanglan ug dugang inspirasyon? Tan-awa ang pipila niining mga may kalabutan nga mga panudlo:
Photon Remote Water Level Sensor
Hibal-i kung giunsa paghimo ang usa ka hilit nga sensor sa lebel sa tubig alang sa usa ka tangke sa pagtipig sa tubig ug kung giunsa ang pag-automate sa usa ka bomba base sa mga pagbasa!
Photon Remote Water Level Sensor
Hibal-i kung giunsa paghimo ang usa ka hilit nga sensor sa lebel sa tubig alang sa usa ka tangke sa pagtipig sa tubig ug kung giunsa ang pag-automate sa usa ka bomba base sa mga pagbasa!
Pag-log Data sa Google Sheets gamit ang Tessel 2
Kini nga proyekto naglangkob kung unsaon pag-log data sa Google Sheets sa duha ka paagi: gamit ang IFTTT nga adunay a web koneksyon o usa ka USB pen drive ug "sneakernet" nga wala.
Graph Sensor Data nga adunay Python ug Matplotlib
Gamita ang matplotlib para maghimo ug real-time nga plot sa temperatura nga datos nga nakolekta gikan sa TMP102 sensor nga konektado sa Raspberry Pi.
Kung naa kay bisan unsang feedback sa tutorial, palihug bisitaha ang mga komento o kontaka ang among technical support team sa TechSupport@sparkfun.com.

Mga Dokumento / Mga Kapanguhaan

SparkFun DEV-13712 SparkFun Development Boards [pdf] Giya sa Gumagamit
DEV-13712, DEV-11114, DEV-09873, CAB-12016, COM-13833, COM-13004, PRT-00115, PRT-08431, DEV-13712 SparkFun Development Boards, DEV-13712 Development Boards, SparkFun Development Boards, DEV-XNUMX Boards

Mga pakisayran

Manwal sa Gumagamit

Pasiuna