OpenLog-kytkentäopas

Johdanto

Huomio! Tämä tutoriaali on sarja-UART:n Open Logille [DEV-13712]. Jos käytät Qwiic OpenLogia IC:lle [DEV-15164], katso Qwiic OpenLogin liitäntäopasta.
OpenLog-tiedonkeruulaite on helppokäyttöinen, avoimen lähdekoodin ratkaisu projektiesi sarjadatan kirjaamiseen. OpenLog tarjoaa yksinkertaisen sarjaliitännän projektin datan kirjaamiseen microSD-kortille.SparkFun OpenLog
• DEV-13712SparkFun OpenLog otsikoilla
• DEV-13955

tuotetta ei löytynyt
Tarvittavat materiaalit
Jotta voit suorittaa tämän tutoriaalin kokonaan, tarvitset seuraavat osat. Et ehkä tarvitse kaikkea riippuen siitä, mitä sinulla on. Lisää se ostoskoriisi, lue opas ja säädä ostoskoria tarvittaessa.
OpenLog-asento-opas SparkFunin toivelista

	Arduino Pro Mini 328 – 3.3V/8MHz DEV-11114 Se on sininen! Se on ohut! Se on Arduino Pro Mini! SparkFunin minimalistinen lähestymistapa Arduinoon. Tämä on 3.3 V:n Arduino …
	SparkFun FTDI peruskytkentä – 3.3 V DEV-09873 Tämä on [FTDI Basic] -dokumentin uusin versio.http://www.sparkfun.com/commerce/product_info.php?products_id=…
	SparkFun Cerberus USB-kaapeli – 6 m CAB-12016 Sinulla on väärä USB-kaapeli. Ei sillä ole väliä kumpi sinulla on, väärä kaapeli on oikea. Mutta entä jos sinulla olisi ollut…
	SparkFun OpenLog DEV-13712 SparkFun OpenLog on avoimen lähdekoodin dataloggeri, joka toimii yksinkertaisen sarjaliitännän kautta ja tukee mi…
	microSD-kortti sovittimella – 16 Gt (luokka 10) COM-13833 Tämä on luokan 10 16 Gt:n microSD-muistikortti, joka sopii täydellisesti yhden piirilevyn tietokoneiden käyttöjärjestelmiin…
	microSD-USB-lukija COM-13004 Tämä on mahtava pieni microSD-USB-lukija. Liu'uta microSD-kortti USB-liittimen sisäpuolelle, niin…
	Naisotsikot PRT-00115 Yksi rivi, 40 reikää, naarasliitin. Voidaan leikata kokoon lankaleikkureilla. Vakioväli 1 cm. Käytämme …
	Apukäynnistyslangat Premium 6″ M/M, 10 kpl pakkaus PRT-08431 Tämä on SparkFunin yksinoikeus! Nämä ovat 155 mm pitkiä hyppyjohtimia, joissa on urosliittimet molemmissa päissä. Käytä näitä hyppyjohtimien…
	Irrotettavat miespuoliset otsikot – suorakulmainen PRT-00553 Rivi suorakulmaisia ​​urosliittimiä – katkaistaan ​​sopivaksi. 40 nastaa, jotka voidaan leikata mihin tahansa kokoon. Käytetään räätälöityjen piirilevyjen tai yleisten…

Suositeltavaa luettavaa
Jos et tunne seuraavia käsitteitä tai et ole niiden kanssa tyytyväinen, suosittelemme lukemaan ne läpi ennen kuin jatkat OpenLog Hookup -oppaan parissa.
Juottaminen: Läpijuottaminen
Tämä opetusohjelma kattaa kaiken, mitä sinun tarvitsee tietää läpireikäjuottamisesta.
SPI (Serial Peripheral Interface)
SPI:tä käytetään yleisesti mikrokontrollerien kytkemiseen oheislaitteisiin, kuten antureihin, siirtorekistereihin ja SD-kortteihin.
Sarjaliikenne
Asynkronisen sarjaliikenteen käsitteet: paketit, signaalitasot, baudinopeudet, UARTit ja paljon muuta!
Sarjapäätteen perusteet
Tässä opetusohjelmassa näytetään, miten voit kommunikoida sarjaporttilaitteidesi kanssa käyttämällä erilaisia ​​pääteemulaattorisovelluksia.

Laitteisto ohiview

Tehoa
OpenLog toimii seuraavilla asetuksilla:
OpenLog-teholuokitukset

VCC-tulo	3.3–12 V (suositus 3.3–5 V)
RXI-tulo	2.0V-3.8V
TXO-lähtö	3.3V
Lepotilan virrankulutus	~2mA–5mA (ilman microSD-korttia), ~5mA–6mA (microSD-kortilla)
Aktiivinen kirjoitusvirrankulutus	~20–23 mA (microSD-kortilla)

OpenLogin virrankulutus on noin 20–23 mA microSD-kortille kirjoitettaessa. Aktiivinen virrankulutus voi vaihdella microSD-kortin koosta ja valmistajasta riippuen, kun OpenLog kirjoittaa muistikortille. Tiedonsiirtonopeuden kasvattaminen kuluttaa myös enemmän virtaa.
mikro
OpenLog toimii sisäänrakennetulla ATmega328-piirillä, joka toimii 16 MHz:n kellotaajuudella sisäänrakennetun kiteen ansiosta. ATmega328:ssa on Optiboot-käynnistyslataaja, jonka ansiosta OpenLog on yhteensopiva Arduino IDE:n "Arduino Uno" -korttiasetuksen kanssa.Käyttöliittymä
Sarja UART
OpenLogin ensisijainen rajapinta on levyn reunassa oleva FTDI-liitin. Tämä liitin on suunniteltu liitettäväksi suoraan Arduino Prohon tai Pro Miniin, minkä ansiosta mikrokontrolleri voi lähettää dataa sarjaportin kautta OpenLogiin.

Varoitus! Koska nastajärjestys tekee siitä yhteensopivan Arduinojen kanssa, sitä ei voi kytkeä suoraan FTDI-breakout-korttiin. Lisätietoja on seuraavassa osiossa, joka käsittelee laitteiston kytkemistä.
SPI
Levyn vastakkaisessa päässä on myös neljä SPI-testipistettä. Voit käyttää näitä ATmega328:n käynnistyslataimen uudelleenohjelmointiin.Uusin OpenLog (DEV-13712) jakaa nämä nastat pienempiin pinnoitettuihin läpireikiin. Jos sinun on käytettävä internet-palveluntarjoajaa uudelleenohjelmointiin tai uuden käynnistyslataimen lataamiseen OpenLogiin, voit käyttää pogo-nastoja näihin testipisteisiin kytkemiseen.
Viimeinen rajapinta OpenLogin kanssa kommunikointiin on itse microSD-kortti. Kommunikointiin microSD-kortti vaatii SPI-nastat. OpenLog ei ainoastaan ​​tallenna tietoja tähän, vaan voit myös päivittää OpenLogin kokoonpanoa config.txt-tiedoston kautta. file microSD -kortilla.
microSD-kortti
Kaikki OpenLogin tallentamat tiedot tallennetaan microSD-kortille. OpenLog toimii microSD-korttien kanssa, joissa on seuraavat ominaisuudet:

• 64MB - 32GB
• FAT16 tai FAT32

LED-tila
OpenLogissa on kaksi tilan merkkivaloa, jotka auttavat vianmäärityksessä.

• STAT1 – Tämä sininen merkkivalo on liitetty Arduino D5:een (ATmega328 PD5) ja se syttyy/sammuu, kun uusi merkki vastaanotetaan. Tämä LED vilkkuu, kun sarjaliikenne toimii.
• STAT2 – Tämä vihreä LED on kytketty Arduino D13:een (SPI Serial Clock Line/ATmega328 PB5). Tämä LED vilkkuu vain, kun SPI-liitäntä on aktiivinen. Näet sen vilkkuvan, kun OpenLog tallentaa 512 tavua microSD-kortille.

Laitteiston kytkentä

OpenLog voidaan kytkeä piiriin kahdella päätavalla. Tarvitset liittämistä varten liittimiä tai johtoja. Varmista, että juotat piirilevyyn turvallisen kytkennän varmistamiseksi.
Perussarjaliitäntä
Kärki: Jos sinulla on naarasliitin OpenLog- ja FTDI-liitännän naarasliittimissä, tarvitset M/F-hyppyjohtimet kytkemistä varten.

Tämä laitteistoliitäntä on suunniteltu OpenLogin kanssa käytettäväksi, jos kortti on ohjelmoitava uudelleen tai tietoja on kirjattava perussarjaliitännän kautta.
Tee seuraavat liitännät:
OpenLog → 3.3 V:n FTDI-peruskytkentä

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

Huomaa, että FTDI:n ja OpenLogin välillä ei ole suoraa yhteyttä – TXO- ja RXI-pinniliitännät on vaihdettava.
Yhteyksiesi pitäisi näyttää seuraavanlaisilta: Kun olet kytkenyt OpenLogin ja FTDI Basicin toisiinsa, kytke FTDI-kortti USB-kaapelilla tietokoneeseen.
Avaa sarjaportti, kytke se FTDI Basic -laitteen COM-porttiin ja aloita!

Projektin laitteistoyhteys

Kärki: Jos naarasliittimet on juotettu OpenLogiin, voit juottaa urosliittimet Arduino Pro Miniin kytkeäksesi piirilevyt yhteen ilman johtoja.Vaikka OpenLogin sarjaliikenneliitäntä on tärkeää uudelleenohjelmoinnin tai virheenkorjauksen kannalta, OpenLogin vahvuus piilee sulautetuissa projekteissa. Suosittelemme OpenLogin kytkemistä mikrokontrolleriin (tässä tapauksessa Arduino Pro Miniin) tällä yleisellä kytkentäkaaviolla. Tämä on se, miten OpenLogiin voi kytkeä sarjadatan kirjoittamisen OpenLogiin.
Ensin sinun on ladattava koodi Pro Miniisi, jota haluat käyttää. Katso esimerkkejä Arduino-sketcheistä.ampkoodi, jota voit käyttää.
Huomautus: Jos et ole varma, miten Pro Mini ohjelmoidaan, tutustu opetusohjelmaamme täällä.
Arduino Pro Mini 3.3V:n käyttö
Tämä tutoriaali on oppaasi kaikkeen Arduino Pro Miniin liittyvään. Se selittää, mitä se on, mitä se ei ole ja miten sen käyttö aloitetaan.
Kun olet ohjelmoinut Pro Minin, voit irrottaa FTDI-kortin ja korvata sen OpenLogilla.
Varmista, että yhdistät sekä Pro Minin että OpenLogin BLK-merkityt nastat (myös molempien GRN-merkityt nastat sopivat yhteen, jos teet sen oikein).
Jos et voi kytkeä OpenLogia suoraan Pro Miniin (johtuen yhteensopimattomista liitännöistä tai muista tiellä olevista piirilevyistä), voit käyttää hyppyjohtimia ja tehdä seuraavat liitännät.
OpenLog → Arduino Pro/Arduino Pro Mini

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

Kun olet valmis, liitäntöjesi pitäisi näyttää seuraavalta Arduino Pro Minin ja Arduino Pron kanssa.
Fritzing-kaavio näyttää OpenLogit, joiden otsikot ovat peilattuina. Jos käännät microSD-liitännän Arduinon yläosaan nähden view, niiden tulisi vastata ohjelmoinnin otsikkoa kuten FTDI:ssä.

Huom että yhteys on suora OpenLog-laitteen ollessa "ylösalaisin" (microSD-kortti ylöspäin).
⚡Huom: Koska OpenLogin ja Arduinon väliset Vcc- ja GND-nastat ovat varattuja liitäntöjen vuoksi, sinun on kytkettävä virta Arduinon muihin käytettävissä oleviin nastoihin. Muussa tapauksessa voit juottaa johdot kumman tahansa piirilevyn näkyviin jääviin virtanastoihin.
Käynnistä järjestelmäsi, niin olet valmis aloittamaan kirjaamisen!

Arduino-luonnokset

On kuusi erilaista ex-versiotaampMukana on luonnoksia, joita voit käyttää Arduinossa, kun se on kytketty OpenLogiin.

• OpenLog_Benchmarking — Tämä esimerkkiamptiedostoa käytetään OpenLogin testaamiseen. Se lähettää erittäin suuria määriä dataa nopeudella 115200 XNUMX bps useiden eri kanavien kautta. files.
• OpenLog_CommandTest — Tämä esimerkkiample näyttää, miten luodaan ja lisätään file komentoriviohjauksen kautta Arduinon kautta.
• OpenLog_ReadExample — Tämä entinenample käy läpi, miten OpenLogia hallitaan komentorivin kautta.
• OpenLog_ReadExample_LargeFile – Esimampkuinka avata suuri varasto file OpenLogissa ja raportoi se paikallisen Bluetooth-yhteyden kautta.
• OpenLog_Test_Sketch — Käytetään OpenLogin testaamiseen suurella määrällä sarjadataa.
• OpenLog_Test_Sketch_Binary — Käytetään OpenLogin testaamiseen binääridatalla ja koodinvaihtomerkeillä.

Laiteohjelmisto

OpenLogissa on kaksi pääasiallista ohjelmistoa: käynnistyslatain ja laiteohjelmisto.
Arduino Bootloader
Huomautus: Jos käytät ennen maaliskuuta 2012 ostettua OpenLogia, sisäänrakennettu käynnistyslataaja on yhteensopiva Arduino IDE:n ”Arduino Pro tai Pro Mini 5V/16MHz w/ ATmega328” -asetuksen kanssa.
Kuten aiemmin mainittiin, OpenLogissa on Optiboot-sarjaportin käynnistyslatain. Voit käsitellä OpenLogia aivan kuten Arduino Unoa, kun lataat ex-tiedostoja.amptiedostokoodi tai uusi laiteohjelmisto kortille.
Jos päädyt tiiliin OpenLogin ja joudut asentamaan käynnistyslataimen uudelleen, sinun kannattaa myös ladata Optiboot kortille. Katso lisätietoja Arduino-käynnistyslataimen asentamista käsittelevästä tutoriaalistamme.
Laiteohjelmiston kääntäminen ja lataaminen OpenLogiin
Huomautus: Jos tämä on ensimmäinen kertasi, kun käytät Arduinoa, ole hyvä jaview opastusohjelmamme Arduino IDE:n asentamiseen. Jos et ole aiemmin asentanut Arduino-kirjastoa, tutustu asennusoppaaseemme kirjastojen manuaalista asentamista varten.
Jos sinun on jostain syystä päivitettävä tai asennettava uudelleen OpenLog-laitteesi laiteohjelmisto, seuraava prosessi saa korttisi toimintakuntoon.
Lataa ensin Arduino IDE v1.6.5. Muut IDE-versiot saattavat toimia OpenLog-laiteohjelmiston kääntämisessä, mutta olemme vahvistaneet tämän tunnetuksi toimivaksi versioksi.
Lataa seuraavaksi OpenLog-laiteohjelmisto ja tarvittavat kirjastot.

LATAA OPENLOG-LAITEOHJELMISTOPAKETTI (ZIP)
Kun olet ladannut kirjastot ja laiteohjelmiston, asenna kirjastot Arduinoon. Jos et ole varma, miten kirjastot asennetaan manuaalisesti IDE:hen, tutustu tutoriaaliimme: Arduino-kirjaston asentaminen manuaalisesti.
Huomautus: Käytämme SdFat- ja SerialPort-kirjastojen muunneltuja versioita voidaksemme mielivaltaisesti määrittää, kuinka suuria TX- ja RX-puskurien tulisi olla. OpenLog vaatii, että TX-puskuri on hyvin pieni (0) ja RX-puskuri mahdollisimman suuri. Näiden kahden muunnellun kirjaston käyttö yhdessä parantaa OpenLogin suorituskykyä.
Etsitkö uusimpia versioita? Jos haluat mieluummin kirjastojen ja laiteohjelmiston uusimmat versiot, voit ladata ne suoraan alla olevista GitHub-arkistoista. SdFatLib- ja Serial Port -kirjastot eivät näy Arduino-levynhallinnassa, joten sinun on asennettava kirjasto manuaalisesti.

• GitHub: OpenLog > Firmware > OpenLog_Firmware
• Bill Greimanin Arduino-kirjastot
  SdFatLib-beta
  Sarjaportti

Seuraavaksi, ottaakseen etulyöntiasemantagMuokatuista kirjastoista muokkaa SerialPort.h-tiedostoa file löytyy hakemistosta \Arduino\Libraries\SerialPort. Muuta BUFFERED_TX arvoksi 0 ja ENABLE_RX_ERROR_CHECKING arvoksi 0. Tallenna fileja avaa Arduino IDE.
Jos et ole vielä tehnyt niin, liitä OpenLog tietokoneeseen FTDI-kortin kautta. Tarkista vielä kerran example-piiri, jos et ole varma, miten tämä tehdään oikein.
Avaa ladattava OpenLog-luonnos kohdasta Työkalut>Levy-valikko, valitse ”Arduino/Genuino Uno” ja valitse FTDI-levyllesi sopiva COM-portti kohdasta Työkalut>Portti.
Lataa koodi.
Siinä kaikki! OpenLog on nyt ohjelmoitu uudella laiteohjelmistolla. Voit nyt avata sarjamonitorin ja olla vuorovaikutuksessa OpenLogin kanssa. Käynnistyksen yhteydessä näet joko 12> tai 12<. 1 osoittaa, että sarjayhteys on muodostettu, 2 osoittaa, että SD-kortti on alustettu onnistuneesti, < osoittaa, että OpenLog on valmis kirjaamaan vastaanotetun sarjadatan ja > osoittaa, että OpenLog on valmis vastaanottamaan komentoja.
OpenLog-laiteohjelmiston luonnokset
OpenLogissa on kolme mukana tulevaa luonnosta, joita voit käyttää sovelluksestasi riippuen.

• OpenLog – Tämä laiteohjelmisto toimitetaan oletuksena OpenLogissa. Lähettämällä ?-komennon näet laitteeseen ladatun laiteohjelmistoversion.
• OpenLog_Light – Tässä luonnoksen versiossa valikko ja komentotila poistetaan, mikä mahdollistaa vastaanottopuskurin kasvattamisen. Tämä on hyvä vaihtoehto nopeaan lokitietojen kirjaamiseen.
• OpenLog_Minimal – Tiedonsiirtonopeus on asetettava koodissa ja ladattava. Tätä luonnosta suositellaan kokeneille käyttäjille, mutta se on myös paras vaihtoehto nopeimpaan lokitietojen tallentamiseen.

Komentosarja

Voit olla yhteydessä OpenLogiin sarjapäätteen kautta. Seuraavat komennot auttavat sinua lukemaan, kirjoittamaan ja poistamaan files, sekä muuttaa OpenLogin asetuksia. Sinun on oltava komentotilassa voidaksesi käyttää seuraavia asetuksia.
Kun OpenLog on komentotilassa, STAT1 kytkeytyy päälle/pois jokaisen vastaanotetun merkin kohdalla. LED palaa, kunnes seuraava merkki vastaanotetaan.

File Manipulointi

• uusi File – Luo uuden file nimetty File nykyisessä hakemistossa. Standardi 8.3 filenimiä tuetaan.
  esimampEsimerkiksi ”87654321.123” on hyväksyttävä, kun taas ”987654321.123” ei ole.
  • Esimample: uusi file1.txt
• liittää File – Lisää tekstiä loppuun FileSarjadata luetaan sitten UART-liitännästä virrassa ja lisätään siihen. fileSe ei kaikua sarjapäätteen kautta. Jos File ei ole olemassa, kun tätä funktiota kutsutaan, file luodaan.
  • Esimample: liitä uusifile.csv
• kirjoittaa File SIIRTO – Kirjoita teksti kohteeseen File sijainnista OFFSET sisällä fileTeksti luetaan UART-liittimestä rivi riviltä ja toistetaan takaisin. Poistu tästä tilasta lähettämällä tyhjä rivi.
  • Esimample: kirjoita lokit.txt 516
• rm File – Poistaa File nykyisestä hakemistosta. Jokerimerkkejä tuetaan.
  • Esimamptiedosto: rm README.txt
• koko File – Tulosteen koko File tavuina.
  • Esimamptiedosto: koko Log112.csv
  • Lähtö: 11
• lukea File + ALKU+ PITUUSTYYPPI – Tulostaa sisällön File alkaen kohdasta START ja jatkaen PITUUTEEN.
  Jos START jätetään pois, koko file raportoidaan. Jos LENGTH jätetään pois, koko sisältö aloituspisteestä raportoidaan. Jos TYPE jätetään pois, OpenLog raportoi oletusarvoisesti ASCII-muodossa. Tulostetyyppejä on kolme:
  • ASCII = 1
  • HEX = 2
  • RAAKAA = 3
  Voit jättää pois joitakin loppuargumentteja. Tarkista seuraava esimerkkiamples.
  Perusluku- ja poisjättämisliput:
  • Esimample: lue LOG00004.txt
  • Lähtö: Kiihtyvyysanturi X=12 Y=215 Z=317
  Lue alusta 0 pituudella 5:
  • Esimample: lue LOG00004.txt 0 5
  • Lähtö: Kiihtyvyys
  Lue kohdasta 1 alkaen heksadesimaalilukuna 5:n pituinen luku:
  • Esimample: lue LOG00004.txt 1 5 2
  • Lähtöteho: 63 63 65 6C
• Lue RAW-tiedostosta kohdasta 0, jonka pituus on 50:
• • Esimample: lue LOG00137.txt 0 50 3
• • Tuloste: André– -þ Laajennettu luonnetesti
• kissa File – Kirjoita sisältö file sarjamonitoriin heksadesimaalisesti viewTämä on joskus hyödyllistä sen näkemiseksi, että file tallentaa oikein ilman, että SD-korttia tarvitsee irrottaa ja view the file tietokoneella.
  • Esimamptiedosto: cat LOG00004.txt
  • Lähtö: 00000000: 41 63 65 6c 3a 20 31

Hakemiston manipulointi

• ls – Listaa nykyisen hakemiston kaiken sisällön. Jokerimerkkejä tuetaan.
  • Esimamptiedosto: ls
  • Tuloste: \src
• md-alihakemisto – Luo alihakemisto nykyiseen hakemistoon.
  • Esimample: md Example_Sketches
• cd-alihakemisto – Vaihda alihakemistoon.
  • Esimamptiedosto: cd Hello_World
• cd .. – Siirry alempaan hakemistoon puussa. Huomaa, että 'cd':n ja '..':n välissä on välilyönti. Tämä sallii merkkijonojen jäsentimen nähdä cd-komennon.
  • Esimample: cd ..
• rm Alihakemisto – Poistaa alihakemiston. Hakemiston on oltava tyhjä, jotta tämä komento toimii.
  • Esimample: rm-lämpötilat
• rm -rf Hakemisto – Poistaa hakemiston ja kaikki filesen sisällä.
  • Esimamptiedosto: rm -rf Kirjastot

Matalan tason funktiokomennot

• ? – Tämä komento tuo esiin luettelon käytettävissä olevista komennoista OpenLogissa.
• levy – Näytä kortin valmistajan tunnus, sarjanumero, valmistuspäivämäärä ja kortin koko. Esim.amptuloste on:
  Kortin tyyppi: SD2
  Valmistajan tunnus: 3
  OEM-tunnus: SD
  Tuote: SU01G
  Versio: 8.0
  Sarjanumero: 39723042
  Valmistuspäivä: 1/2010
  Kortin koko: 965120 kt
• init – Alusta järjestelmä uudelleen ja avaa SD-kortti uudelleen. Tästä on hyötyä, jos SD-kortti lakkaa vastaamasta.
• sync – Synkronoi puskurin nykyisen sisällön SD-kortille. Tämä komento on hyödyllinen, jos puskurissa on alle 512 merkkiä ja haluat tallentaa ne SD-kortille.
• reset – Hyppää OpenLogin sijaintiin nolla, suorittaa käynnistyslataimen uudelleen ja sitten init-koodin. Tästä komennosta on hyötyä, jos sinun on muokattava kokoonpanoa. file, nollaa OpenLog ja aloita uuden kokoonpanon käyttö. Virran katkaiseminen ja pysäyttäminen on edelleen suositeltava tapa kortin nollaamiseen, mutta tämä vaihtoehto on käytettävissä.

Järjestelmäasetukset

Näitä asetuksia voidaan päivittää manuaalisesti tai muokata config.txt-tiedostossa. file.

• echo STATE – Muuttaa järjestelmän echo-ominaisuuden tilaa ja tallennetaan järjestelmämuistiin. STATE voi olla joko päällä tai pois päältä. Kun se on päällä, OpenLog toistaa vastaanotetun sarjadatan komentokehotteessa. Kun se on pois päältä, järjestelmä ei lue vastaanotettuja merkkejä takaisin.
  Huomautus: Normaalin lokikirjauksen aikana kaiutus on pois päältä. Järjestelmän resurssivaatimukset vastaanotetun datan kaiuttamiseen ovat liian korkeat lokikirjauksen aikana.
• verbose STATE – Muuttaa yksityiskohtaisen virheraportoinnin tilaa. STATE voi olla joko päällä tai pois päältä. Tämä komento tallennetaan muistiin. Kun poistat yksityiskohtaiset virheet käytöstä, OpenLog vastaa virheen sattuessa pelkällä !-merkillä tuntemattoman komennon sijaan: COMMAND. !-merkkiä on sulautettujen järjestelmien helpompi jäsentää kuin koko virhettä. Jos käytät terminaalia, verbose-asetuksen pitäminen päällä antaa sinun nähdä täydelliset virheilmoitukset.
• baud – Tämä komento avaa järjestelmävalikon, jossa käyttäjä voi syöttää baudinopeuden. Kaikkia baudinopeuksia 300 bps ja 1 Mbps välillä tuetaan. Baud-nopeuden valinta on välitön, ja asetusten voimaantulo edellyttää OpenLog-laitteen virrankatkaisua. Baud-nopeus tallennetaan EEPROM-muistiin ja ladataan aina, kun OpenLog käynnistyy. Oletusarvo on 9600 8N1.

Muista: Jos kortti jumiutuu tuntemattomaan baudinopeusluokkaan, voit kytkeä RX:n maahan (GND) ja käynnistää OpenLogin. LEDit vilkkuvat edestakaisin kahden sekunnin ajan ja sitten yhdessä. Sammuta OpenLog ja poista hyppyjohdin. OpenLog on nyt nollattu arvoon 2 bps, kun pakomerkkiä `CTRL-Z` painetaan kolme kertaa peräkkäin. Tämä ominaisuus voidaan ohittaa asettamalla hätätilan ohitusbitti arvoon 9600.
Lisätietoja on tiedostossa config.txt.

• set – Tämä komento avaa järjestelmävalikon käynnistystilan valitsemiseksi. Nämä asetukset tulevat voimaan
  • seuraavan käynnistyksen yhteydessä ja ne tallennetaan pysyvään EEPROM-muistiin. Uusi File Lokikirjaus – Tämä tila luo uuden file Aina kun OpenLog käynnistyy. OpenLog lähettää 1 (UART on aktiivinen), 2 (SD-kortti on alustettu) ja sitten < (OpenLog on valmis vastaanottamaan dataa). Kaikki data tallennetaan LOG#####.txt-tiedostoon. #####-luku kasvaa joka kerta, kun OpenLog käynnistyy (enintään 65533 lokia). Luku tallennetaan EEPROM-muistiin ja se voidaan nollata asetusvalikosta.
  Kaikkia vastaanotettuja merkkejä ei toisteta uudelleen. Voit poistua tästä tilasta ja siirtyä komentotilaan lähettämällä CTRL+z (ASCII 26). Kaikki puskuroitu data tallennetaan.

Huomautus: Jos lokeja on luotu liikaa, OpenLog antaa virheilmoituksen **Liikaa lokeja**, poistuu tilasta ja palaa komentokehotteeseen. Sarjamuotoinen tuloste näyttää tältä: `12!Liikaa lokeja!`.

• Liitä File Lokikirjaus – Tunnetaan myös peräkkäisenä tilana, tämä tila luo file kutsutaan nimellä SEQLOG.txt, jos sitä ei jo ole, ja liittää vastaanotetut tiedot tiedostoon fileOpenLog lähettää 12<, jolloin OpenLog on valmis vastaanottamaan dataa. Merkkejä ei toisteta. Voit poistua tästä tilasta ja siirtyä komentotilaan lähettämällä CTRL+z (ASCII 26). Kaikki puskuroitu data tallennetaan.
• Komentokehote – OpenLog lähettää 12>-merkin, jolloin järjestelmä on valmis vastaanottamaan komentoja. Huomaa, että >-merkki osoittaa, että OpenLog on valmis vastaanottamaan komentoja, ei dataa. Voit luoda files ja liitä tiedot files, mutta tämä vaatii jonkin verran sarjajäsennystä (virheentarkistusta varten), joten emme aseta tätä tilaa oletusarvoisesti.
• Palauta uusi File Numero – Tämä tila nollaa lokin file numero LOG000.txt-tiedostoon. Tästä on hyötyä, jos olet äskettäin tyhjentänyt microSD-kortin ja haluat lokin file numerot aloittaa alusta.
• Uusi koodinvaihtomerkki – Tämän asetuksen avulla käyttäjä voi syöttää merkin, kuten CTRL+z tai $, ja asettaa sen uudeksi koodinvaihtomerkiksi. Hätänollauksen aikana tämä asetus palautuu arvoon CTRL+z.
• Komentomerkkien määrä – Tämän asetuksen avulla käyttäjä voi syöttää merkin (kuten 1, 3 tai 17), mikä päivittää komentotilaan siirtymiseen tarvittavien koodinvaihtomerkkien määrän. EsimerkiksiampEsimerkiksi luvun 8 syöttäminen edellyttää, että käyttäjä painaa CTRL+z-näppäinyhdistelmää kahdeksan kertaa päästäkseen komentotilaan. Tämä asetus palautuu arvoon 3 hätänollauksen aikana.

Escape-merkkien selitys: OpenLog vaatii `CTRL+z`-näppäinyhdistelmän painalluksen kolme kertaa komentotilaan siirtymiseksi, jotta estetään kortin vahingossa tapahtuva nollautuminen uuden koodin lataamisen aikana Arduino IDE:stä. On mahdollista, että kortti näkee `CTRL+z`-merkin käynnistyksen aikana (ongelma, jonka havaitsimme OpenLog-laiteohjelmiston varhaisissa versioissa), joten tämän tarkoituksena on estää se. Jos epäilet, että korttisi on jumiutunut tästä syystä, voit aina tehdä hätänollauksen pitämällä RX-nastaa maassa käynnistyksen aikana.

Kokoonpano File

Jos et halua käyttää sarjapäätettä OpenLog-asetusten muokkaamiseen, voit päivittää asetukset myös muokkaamalla CONFIG.TXT-tiedostoa. file.
Huomautus: Tämä ominaisuus toimii vain laiteohjelmistoversiossa 1.6 tai uudemmissa. Jos olet ostanut OpenLogin vuoden 2012 jälkeen, käytät laiteohjelmistoversiota 1.6+.
Tätä varten tarvitset microSD-kortinlukijan ja tekstieditorin. Avaa config.txt-tiedosto. file (alkukirjainten isot kirjaimet) file nimellä ei ole väliä), ja konfiguroi! Jos et ole koskaan aiemmin käynnistänyt OpenLogia SD-kortilla, voit myös luoda sen manuaalisesti fileJos olet käynnistänyt OpenLogin microSD-kortti aiemmin asetettuna, sinun pitäisi nähdä jotain seuraavanlaista, kun luet microSD-korttia.OpenLog luo config.txt- ja LOG0000.txt-tiedostot. file ensimmäisen käynnistyksen yhteydessä.
Oletuskokoonpano file sisältää yhden rivin asetuksia ja yhden rivin määritelmiä.Oletusmääritys file OpenLogin kirjoittama.
Huomaa, että nämä ovat tavallisia näkyviä merkkejä (ei ole piilotettuja tai binäärisiä arvoja), ja jokainen arvo on erotettu toisistaan ​​pilkulla.
Asetukset määritellään seuraavasti:

• baud: Tiedonsiirron baudinopeus. Oletusarvo on 9600 bps. Arduino IDE:n kanssa yhteensopivia arvoja ovat 2400, 4800, 9600, 19200, 38400, 57600 ja 115200. Voit käyttää muita baudinopeuksia, mutta et voi kommunikoida OpenLogin kanssa Arduino IDE:n sarjaportin monitorin kautta.
• escape: Ohjausmerkin ASCII-arvo (desimaalimuodossa). 26 on CTRL+z ja on oletusarvo. 36 on $ ja se on yleisesti käytetty ohjausmerkki.
• esc# : Vaadittavien koodinvaihtomerkkien määrä. Oletusarvoisesti se on kolme, joten sinun on painettava koodinvaihtomerkkiä kolme kertaa palataksesi komentotilaan. Hyväksyttävät arvot ovat 0 - 254. Arvon asettaminen arvoon 0 poistaa koodinvaihtomerkkien tarkistuksen kokonaan käytöstä.
• tila: Järjestelmätila. OpenLog käynnistyy oletusarvoisesti uuden lokin tilassa (0). Hyväksyttävät arvot ovat 0 = Uusi loki, 1 = Peräkkäinen loki, 2 = Komentotila.
• verb: Yksityiskohtainen tila. Laajennetut (yksiselitteiset) virheilmoitukset ovat oletusarvoisesti käytössä. Arvon 1 asettaminen ottaa käyttöön yksityiskohtaisia ​​virheilmoituksia (kuten tuntematon komento: poista ! ). Arvon 0 asettaminen poistaa käytöstä yksityiskohtaisia ​​virheilmoituksia, mutta vastaa aakkosella !, jos virhe tapahtuu. Yksityiskohtaisen tilan poistaminen käytöstä on kätevää, jos yrität käsitellä sulautetun järjestelmän virheitä.
• echo : Kaiutustila. Komentotilassa merkit toistetaan oletusarvoisesti. Arvon 0 asettaminen poistaa merkkien kaiutuksen käytöstä. Tämän poistaminen käytöstä on kätevää, jos käsitellään virheitä etkä halua lähetettyjen komentojen toistuvan takaisin OpenLogiin.
• ignoreRX: Hätätilan ohitus. Normaalisti OpenLog tekee hätänollauksen, kun RX-nasta vedetään alas käynnistyksen aikana. Arvon 1 asettaminen poistaa käytöstä RX-nastan tarkistuksen käynnistyksen aikana. Tästä voi olla hyötyä järjestelmissä, jotka pitävät RX-linjan alhaalla useista syistä. Jos hätätilan ohitus on poistettu käytöstä, et voi pakottaa laitetta takaisin 9600 bps:ään, ja kokoonpano file on ainoa tapa muuttaa baudinopeutta.

Kuinka OpenLog muokkaa konfiguraatiota File
OpenLog voi muokata config.txt-tiedostoa viidessä eri tilanteessa file.

• Konfig file löytyi: Käynnistyksen aikana OpenLog etsii config.txt-tiedostoa file. Jos file Jos toiminto löytyy, OpenLog käyttää mukana toimitettuja asetuksia ja korvaa kaikki aiemmin tallennetut järjestelmäasetukset.
• Ei konfiguraatiota file löytyi: Jos OpenLog ei löydä config.txt-tiedostoa file Tämän jälkeen OpenLog luo config.txt-tiedoston ja tallentaa siihen tallennetut järjestelmäasetukset. Tämä tarkoittaa, että jos asetat järjestelmään juuri alustetun microSD-kortin, järjestelmä säilyttää nykyiset asetuksensa.
• Vioittunut kokoonpano file löytyi: OpenLog poistaa vioittuneen config.txt-tiedoston file, ja kirjoittaa uudelleen sekä sisäiset EEPROM-asetukset että config.txt-tiedoston asetukset file tunnetusti hyvään tilaan 9600,26,3,0,1,1,0 .
• Virheelliset arvot määrityksessä fileJos OpenLog havaitsee asetuksia, jotka sisältävät laittomia arvoja, OpenLog korvaa vioittuneet arvot config.txt-tiedostossa. file tallennettujen EEPROM-järjestelmäasetusten kanssa.
• Muutokset komentokehotteen kautta: Jos järjestelmän asetuksia muutetaan komentokehotteen kautta (joko sarjaportin kautta tai mikrokontrollerin sarjakomennoilla), muutokset tallennetaan sekä järjestelmän EEPROM-muistiin että config.txt-tiedostoon. file.
• Hätänollaus: Jos OpenLog kytketään päälle ja pois päältä kytkemällä hyppyjohdin RX:n ja GND:n välillä ja hätätilan ohitusbitti on asetettu arvoon 0 (mahdollistaa hätänollauksen), OpenLog kirjoittaa uudelleen sekä sisäiset EEPROM-asetukset että config.txt-tiedoston asetukset. file tunnetusti hyvään tilaan 9600,26,3,0,1,1,0 .

Vianetsintä

On olemassa useita eri vaihtoehtoja tarkistaa, onko sinulla ongelmia sarjaportin kautta tapahtuvassa yhteyden muodostamisessa, lokien puuttuvien merkkien kanssa tai tiilissä olevan OpenLogin kanssa.
Tarkista STAT1-merkkivalon toiminta
STAT1-merkkivalo toimii eri tavalla kahdessa yleisessä virheessä.

• 3 välähdystä: microSD-kortin alustus epäonnistui. Sinun on ehkä alustettava kortti FAT/FAT16-muotoon tietokoneella.
• 5 välähdystä: OpenLog on vaihtunut uuteen baudinopeudeon ja se on käynnistettävä uudelleen.

Tarkista alihakemiston rakenne kahdesti
Jos käytät oletusarvoista OpenLog.ino-tiedostoaampEsimerkiksi OpenLog tukee vain kahta alihakemistoa. Sinun on muutettava FOLDER_TRACK_DEPTH-arvo 2:sta tuettavien alihakemistojen määrään. Kun olet tehnyt tämän, käännä koodi uudelleen ja lataa muokattu laiteohjelmisto.
Tarkista lukumäärä Files juurihakemistossa
OpenLog tukee vain enintään 65,534 XNUMX lokia files juurihakemistossa. Suosittelemme microSD-kortin uudelleenalustamista lokitietojen tallentamisen nopeuden parantamiseksi.
Tarkista muokatun laiteohjelmiston koko
Jos kirjoitat mukautettua luonnosta OpenLog-muistiin, varmista, että luonnoksesi ei ole suurempi kuin 32,256 500 tavua. Jos näin on, se leikkaa flash-muistin ylimmät XNUMX tavua, joita Optiboot-sarjaportin käynnistyslataaja käyttää.
Double Check File Nimet
Kaikki file Nimien tulisi olla aakkosnumeerisia. MyLOG1.txt on ok, mutta Hi !e _.txt ei välttämättä toimi.
Käytä 9600 baudia
OpenLog toimii ATmega328-piirillä ja siinä on rajallinen määrä RAM-muistia (2048 tavua). Kun lähetät sarjamuotoisia merkkejä OpenLogiin, ne puskuroidaan. SD Group Simplified Specification -standardin mukaan SD-kortti voi käyttää jopa 250 ms (kohta 4.6.2.2 Kirjoitus) datalohkon tallentamiseen flash-muistiin.
9600 bps:n nopeudella se on 960 tavua (10 bittiä tavua kohden) sekunnissa. Se on 1.04 ms tavua kohden. OpenLog käyttää tällä hetkellä 512 tavun vastaanottopuskuria, joten se voi puskuroida noin 50 ms merkkejä. Tämän ansiosta OpenLog voi vastaanottaa onnistuneesti kaikki 9600 bps:n nopeudella tulevat merkit. Mitä enemmän baudinopeutta nostat, sitä lyhyemmäksi ajaksi puskuri kestää.
OpenLog-puskurin ylitysaika

Tiedonsiirtonopeus	Aika tavua kohden	Aika puskurin täyttymiseen
9600bps	1.04 ms	532 ms
57600bps	0.174 ms	88 ms
115200bps	0.087 ms	44 ms

Monilla SD-korteilla on nopeampi tallennusaika kuin 250 ms. Tähän voivat vaikuttaa kortin "luokka" ja kortille jo tallennetun tiedon määrä. Ratkaisu on käyttää alhaisempaa tiedonsiirtonopeutta tai lisätä viivettä lähetettyjen merkkien välillä suuremmalla tiedonsiirtonopeudella.
MicroSD-kortin alustaminen
Muista käyttää korttia, jossa on vähän tai ei ollenkaan files siinä. MicroSD-kortti, jossa on 3.1 Gt ZIP-muistia files- tai MP3-tiedostoilla on hitaampi vasteaika kuin tyhjällä kortilla.
Jos et alustanut microSD-korttiasi Windows-käyttöjärjestelmässä, alusta microSD-kortti uudelleen ja luo DOS-tiedosto. filejärjestelmä SD-kortilla.
Vaihda MicroSD-kortit
Kortteja on monenlaisia, erityyppisiä, uudelleenmerkittyjä, erikokoisia ja -luokallisia, eivätkä ne kaikki välttämättä toimi oikein. Yleensä käytämme 8 Gt:n luokan 4 microSD-korttia, joka toimii hyvin 9600 bps:n nopeudella. Jos tarvitset suurempia baudinopeuksia tai enemmän tallennustilaa, voit kokeilla luokan 6 tai sitä korkeampia kortteja.
Lisää viiveitä merkkien kirjoittamisen välille
Lisäämällä pienen viiveen Serial.print()-lausekkeiden väliin voit antaa OpenLogille mahdollisuuden tallentaa nykyisen arvonsa.
puskuri.
esimampseuraavat:
Serial.begin(115200);
for(int i = 1; i < 10; i++) {
Sarja.tulosta(i, DEC);
Sarja.println(“:abcdefghijklmnopqrstuvwxyz-!#”);
}

ei välttämättä kirjaudu oikein, koska lähetetään paljon merkkejä vierekkäin. Pienen 15 ms:n viiveen lisääminen suurten merkkien kirjoitusten väliin auttaa OpenLogin tallentamisessa menettämättä merkkejä.
Serial.begin(115200);
for(int i = 1; i < 10; i++) {
Sarja.tulosta(i, DEC);
Sarja.println(“:abcdefghijklmnopqrstuvwxyz-!#”);
viive (15);
}

Lisää Arduino-sarjamonitorin yhteensopivuus
Jos yrität käyttää OpenLogia sisäänrakennetun sarjaliikennekirjaston tai SoftwareSerial-kirjaston kanssa, saatat huomata ongelmia komentotilassa. Serial.println() lähettää sekä rivinvaihdon että rivinvaihdon. Tämän voi ratkaista kahdella vaihtoehtoisella komennolla.
Ensimmäinen on käyttää \r-komentoa (ASCII-rivinvaihto):
Sarja.tulosta("TEKSTI\r");
Vaihtoehtoisesti voit lähettää arvon 13 (desimaalirivinvaihto):
Sarja.tulosta("TEKSTI");
Sarja.kirjoitus(13);

Hätänollaus
Muista, että jos sinun on palautettava OpenLogin oletustilaan, voit tehdä sen kytkemällä RX-nastan GND:hen, käynnistämällä OpenLogin, odottamalla, kunnes LEDit alkavat vilkkua yhdessä, ja sitten sammuttamalla OpenLogin ja poistamalla hyppyjohtimen.
Jos olet muuttanut hätäohitusbitin arvoksi 1, sinun on muokattava konfiguraatiota. file, koska hätänollaus ei toimi.
Tarkista yhteisöltä
Jos sinulla on edelleen ongelmia OpenLogin kanssa, tutustu GitHub-arkistomme nykyisiin ja ratkaistuihin ongelmiin täällä. OpenLogin parissa työskentelee suuri yhteisö, joten on todennäköistä, että joku on löytänyt korjauksen näkemääsi ongelmaan.

Resurssit ja jatkotoimet

Nyt kun olet onnistuneesti kirjannut tietoja OpenLogillasi, voit määrittää etäprojekteja ja seurata kaikkea mahdollista tulevaa dataa. Harkitse oman Citizen Science -projektin tai jopa lemmikkien seurantalaitteen luomista nähdäksesi, mitä Fluffy tekee liikkeellä ollessaan!
Tutustu näihin lisäresursseihin vianmääritykseen, apuun tai inspiraatioon seuraavaa projektiasi varten.

• OpenLog GitHub
• Illumitune-projekti
• LilyPad-valoanturin kytkentä
• BadgerHack: Maaperäanturin lisäosa
• OBD-II:n käytön aloittaminen
• Vernier-valoportti

Kaipaatko lisää inspiraatiota? Tutustu näihin aiheeseen liittyviin opetusvideoihin:
Photon-etävedenpinnan anturi
Opi rakentamaan vesisäiliön etävedenpinnan anturi ja automatisoimaan pumppu lukemien perusteella!
Photon-etävedenpinnan anturi
Opi rakentamaan vesisäiliön etävedenpinnan anturi ja automatisoimaan pumppu lukemien perusteella!
Tietojen kirjaaminen Google Sheetsiin Tesselillä 2
Tässä projektissa käsitellään tietojen kirjaamista Google Sheetsiin kahdella tavalla: IFTTT:n avulla web liitäntä tai USB-muistitikku ja “lenkkariverkko” ilman.
Anturidatan kuvaaja Pythonin ja Matplotlibin avulla
Käytä matplotlibia luodaksesi reaaliaikaisen kuvaajan Raspberry Pihin kytketyn TMP102-anturin keräämistä lämpötilatiedoista.
Jos sinulla on palautetta opetusohjelmista, käy kommenteissa tai ota yhteyttä tekniseen tukitiimiimme osoitteessa Tekninen tuki@sparkfun.com.

Asiakirjat / Resurssit

SparkFun DEV-13712 SparkFun-kehityskortit [pdfKäyttöopas DEV-13712, DEV-11114, DEV-09873, CAB-12016, COM-13833, COM-13004, PRT-00115, PRT-08431, DEV-13712 SparkFun-kehityskortit, DEV-13712, SparkFun-kehityskortit, Kehityskortit, Kortit

Viitteet

• Käyttöopas