Tekniset tiedot

• Tuotteen nimi: OpenLog-tiedonkeruulaite
• Malli: DEV-13712
• Virtalähde: 3.3–12 V (suositus 3.3–5 V)
• RXI-tuloäänenvoimakkuustage: 2.0V-3.8V
• TXO-lähtöäänenvoimakkuustage: 3.3 V.
• Lepotilan virrankulutus: ~2mA-5mA (ilman microSD-korttia), ~5mA-6mA (microSD-kortilla)
• Aktiivinen kirjoitusvirrankulutus: ~20-23mA (microSD-kortilla)

Tuotteen käyttöohjeet

Tarvittavat materiaalit:

• Arduino Pro Mini 328 – 3.3V/8MHz
• SparkFun FTDI peruskytkentä – 3.3 V
• SparkFun Cerberus USB-kaapeli – 6 m
• microSD-kortti sovittimella – 16 Gt (luokka 10)
• microSD-USB-lukija
• Naisotsikot
• Premium-käynnistysoljet, 6 kpl, 10 kpl pakkaus
• Irrotettavat miespuoliset otsikot – suorakulmainen

Suositeltavaa luettavaa:

• Juottaminen: Läpijuottaminen
• Sarjaliikenteen perusteet
• SPI (Serial Peripheral Interface)
• Sarjapäätteen perusteet

Laitteisto ohiview:
OpenLog toimii seuraavilla asetuksilla:

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-13712

SparkFun OpenLog otsikoilla
DEV-13955

Tuotteita 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-kytkentäopas

SparkFunin toivelista

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.

• Kuinka juottaa: Läpijuotto. Tämä opetusohjelma kattaa kaiken, mitä sinun tarvitsee tietää läpijuottamisesta.
• Sarjaliikenne Asynkronisen sarjaliikenteen käsitteet: paketit, signaalitasot, baudinopeudet, UARTit ja paljon muuta!
• SPI (Serial Peripheral Interface) SPI:tä käytetään yleisesti mikrokontrollerien kytkemiseen oheislaitteisiin, kuten antureihin, siirtorekistereihin ja SD-kortteihin.
• 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

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-prosessorilla, joka toimii 16 MHz:n kellotaajuudella sisäänrakennetun kiteen ansiosta. ATmega328:ssa on Optiboot-käynnistyslataaja, jonka ansiosta OpenLog on yhteensopiva...
”Arduino Uno” -kortin asetukset Arduino IDE:ssä.

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, joilla on seuraavat ominaisuudet:

• 64MB - 32GB
• FAT16 tai FAT32

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ärkiJos OpenLogissa ja FTDI:ssä on naarasliitin, tarvitset kytkentään M/F-hyppyjohdot.

Tämä laitteistoliitäntä on suunniteltu OpenLogin kanssa käytettäväksi, jos kortti on ohjelmoitava uudelleen tai tietoja on kirjattava lokitiedostoon tavallisen sarjaliitä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, kytke FTDI-kortti USB-kaapelilla tietokoneeseen. Avaa sarjaportti, kytke FTDI Basicin 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 Sketches -sivulta.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ä sekä Pro Minin että OpenLogin BLK-merkityt nastat on kytketty toisiinsa (molempien GRN-merkityt nastat sopivat myös 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ää OpenLog-lokit, joiden otsikot ovat peilattuina. Jos käännät microSD-liitännän Arduinon yläreunaan nähden view, niiden tulisi vastata ohjelmoinnin otsikkoa kuten FTDI:ssä.

Huomaa, että yhteys on suora, kun OpenLog on "ylösalaisin" (microSD-kortti ylöspäin).

Huomautus: 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 kirjastopaketit.

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 muokatun 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.hh-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 käyttääksesi seuraavia asetuksia.

Kun OpenLog on komentotilassa, STAT1 kytkeytyy päälle/pois jokaisen vastaanotetun merkin kohdalla. LED palaa, kunnes seuraava merkki vastaanotetaan.

• Uusi File – Luo uuden file nimetty File nykyisessä hakemistossa. Standardi 8.3 filenimiä tuetaan. EsimerkiksiampEsimerkiksi ”87654321.123” on hyväksyttävä, kun taas ”987654321.123” ei ole.
  • Example: uusi file1.txt
• Liitä File – Lisää tekstiä loppuun FileSarjadata luetaan sitten UART-liitännästä virrassa ja lisätään... fileSe ei kaikua sarjapäätteen kautta. Jos File ei ole olemassa, kun tätä funktiota kutsutaan, file luodaan.
  • Example: liitä uusifile.csv
• Kirjoittaa File SIIRTYMÄ – Kirjoita tekstiä File sijainnista OFFSET sisällä fileTeksti luetaan UART-liittimestä rivi riviltä ja toistetaan takaisin. Poistu tästä tilasta lähettämällä tyhjä rivi.
  • Example: kirjoita lokit.txt 516
• rm File – Poistaa File nykyisestä hakemistosta. Jokerimerkkejä tuetaan.
  • Examptiedosto: rm README.txt
• koko File – Tulosteen koko File tavuina.
  • Examptiedosto: koko Log112.csv
  • Lähtö: 11
• Lukea File + ALKU+ PITUUSTYYPPI – Tulostaa sisällön File alkaen kohdasta START ja jatkaen kohtaan LENGTH. 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
  • RAAKA = 3
• Voit jättää pois joitakin loppuargumentteja. Tarkista seuraava esimerkkiamples.
• Perusluku- ja poisjättämisliput:
  • Example: lue LOG00004.txt
  • Lähtö: Kiihtyvyysanturi X=12 Y=215 Z=317
• Lue alusta 0 pituudella 5:
  • Example: lue LOG00004.txt 0 5
  • Lähtö: Kiihtyvyys
• Lue kohdasta 1 alkaen heksadesimaalilukuna 5:n pituinen luku:
  • Example: lue LOG00004.txt 1 5 2
  • Lähtö: 63 63 65 6C
• Lue RAW-tiedostosta kohdasta 0, jonka pituus on 50:
  • Example: 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.
  • Examptiedosto: 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.
  • Examptiedosto: ls
  • Tuloste: \src
• md-alihakemisto – Luo alihakemisto nykyiseen hakemistoon.
  • Example: md Example_Sketches
• cd-alihakemisto – Vaihda alihakemistoon.
  • Examptiedosto: cd Hello_World
• cd .. – Siirry alempaan hakemistoon puussa. Huomaa, että 'cd':n ja '..':n välissä on välilyönti. Näin merkkijonojen jäsennin näkee CD-komennon.
  • Example: cd ..
• rm Alihakemisto – Poistaa alihakemiston. Hakemiston on oltava tyhjä, jotta tämä komento toimii.
  • Example: rm-lämpötilat
• rm -rf Hakemisto – Poistaa hakemiston ja kaikki filesen sisällä.
  • Examptiedosto: 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ämäärä: 1/2010 Kortin koko: 965120 XNUMX kt
• init – Alusta järjestelmä uudelleen ja avaa SD-kortti uudelleen. Tästä on hyötyä, jos SD-kortti lakkaa vastaamasta.
• Synkronoi – Synkronoi puskurin nykyisen sisällön SD-kortille. Tästä komennosta on hyötyä, jos puskurissa on alle 512 merkkiä ja haluat tallentaa ne SD-kortille.
• Nollaa – 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 suositeltavin tapa kortin nollaamiseen, mutta tämä vaihtoehto on käytettävissä.

Järjestelmäasetukset

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

• Echo STATE – Muuttaa järjestelmän tilaa ja tallennetaan järjestelmämuistiin. STATE voi olla joko päällä tai pois päältä. Kun tämä 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: C OMMAND.D..T Sulautettujen järjestelmien on helpompi jäsentää he-merkkejä 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.

Muistaa: 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 config.txt-tiedostossa.

• Aseta – Tämä komento avaa järjestelmävalikon käynnistystilan valitsemiseksi. Nämä asetukset tulevat käyttöön 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. #####-numero kasvaa joka kerta, kun OpenLog käynnistyy (enintään 65533 lokia). Numero tallennetaan EEPROM-muistiin ja se voidaan nollata asetusvalikosta. Kaikkia vastaanotettuja merkkejä ei toisteta. 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 virheen **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ä.Oletuskokoonpano file on kirjoittanut OpenLog.
• 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.
• Escap:e 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 siirtyäksesi komentotilaan. Hyväksyttävät arvot ovat 0 - 254. Arvon asettaminen arvoon 0 poistaa koodinvaihtomerkkien tarkistuksen kokonaan käytöstä.
• 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.
• Verbi: 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ä.
• Kaiutus: Kaiutustila. Komentotilassa merkit toistetaan oletusarvoisesti. Arvon 0 asettaminen poistaa merkkien kaiutuksen käytöstä. Tämän poistaminen käytöstä on kätevää virheitä käsiteltäessä, etkä halua lähetettyjen komentojen toistuvan takaisin OpenLog.II:een.
• ignoreRXEmergency Override. 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änopeuttaminen 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 _ .txtt 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

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.

Usein kysytyt kysymykset