Špecifikácie

• Názov produktu: OpenLog Data Logger
• Model: DEV-13712
• Vstupné napätie: 3.3 V – 12 V (odporúčané 3.3 V – 5 V)
• Vstupná hlasitosť RXItage: 2.0 V-3.8 V
• Výstupná hlasitosť TXOtage: 3.3 V.
• Odber prúdu v kľudovom stave: ~2mA-5mA (bez microSD karty), ~5mA-6mA (s microSD kartou)
• Odber prúdu pri aktívnom zápise: ~20-23mA (s kartou microSD)

Návod na použitie produktu

Požadované materiály:

• Arduino Pro Mini 328 – 3.3V/8MHz
• Základný rozbočovač SparkFun FTDI – 3.3 V
• USB kábel SparkFun Cerberus – 6 m
• Pamäťová karta microSD s adaptérom – 16 GB (trieda 10)
• Čítačka microSD USB
• Ženské hlavičky
• Štartovacie káble Premium 6 M/M balenie 10 kusov
• Odtrhávacie samčie hlavičky – pravouhlé

Odporúčané čítanie:

• Ako spájkovať: Spájkovanie cez otvor
• Základy sériovej komunikácie
• Serial Peripheral Interface (SPI)
• Základy sériového terminálu

Hardware Overview:
OpenLog beží s nasledujúcimi nastaveniami:

Úvod

Pozor! Tento návod je pre Open Log pre sériový UART [DEV-13712]. Ak používate Qwiic OpenLog pre IC [DEV-15164], pozrite si, prosím, Sprievodcu pripojením Qwiic OpenLog.

OpenLog Data Logger je jednoducho použiteľné riešenie s otvoreným zdrojovým kódom na zaznamenávanie sériových údajov z vašich projektov. OpenLog poskytuje jednoduché sériové rozhranie na zaznamenávanie údajov z projektu na kartu microSD.

SparkFun OpenLog
DEV-13712

SparkFun OpenLog s hlavičkami
DEV-13955

Nenašiel sa žiadny produkt

Požadované materiály
Aby ste si mohli tento návod plne preštudovať, budete potrebovať nasledujúce súčasti. Možno však nebudete potrebovať všetko v závislosti od toho, čo máte. Pridajte si ich do košíka, prečítajte si návod a podľa potreby upravte košík.

Sprievodca pripojením OpenLogu

Zoznam želaní SparkFun

Odporúčané čítanie
Ak nie ste oboznámení s nasledujúcimi konceptmi alebo s nimi nie ste spokojní, odporúčame vám prečítať si ich predtým, ako budete pokračovať s príručkou OpenLog Hookup Guide.

• Ako spájkovať: Spájkovanie cez otvor. Tento návod pokrýva všetko, čo potrebujete vedieť o spájkovaní cez otvor.
• Sériová komunikácia Koncepty asynchrónnej sériovej komunikácie: pakety, úrovne signálu, prenosové rýchlosti, UART a ďalšie!
• Serial Peripheral Interface (SPI) SPI sa bežne používa na pripojenie mikrokontrolérov k periférnym zariadeniam, ako sú senzory, posuvné registre a SD karty.
• Základy sériového terminálu Tento návod vám ukáže, ako komunikovať so sériovými zariadeniami pomocou rôznych aplikácií emulátora terminálu.

Hardware Overview

Sila
OpenLog beží s nasledujúcimi nastaveniami:

Hodnotenia výkonu OpenLog

Odber prúdu zariadenia OpenLog pri zápise na kartu microSD je približne 20 mA až 23 mA. V závislosti od veľkosti karty microSD a jej výrobcu sa aktívny odber prúdu môže líšiť, keď zariadenie OpenLog zapisuje na pamäťovú kartu. Zvýšenie prenosovej rýchlosti tiež zvýši odber prúdu.

mikroradič
OpenLog je vybavený integrovaným kryštálom ATmega328 s frekvenciou 16 MHz. ATmega328 má nainštalovaný bootloader Optiboot, ktorý umožňuje kompatibilitu OpenLogu s...
Nastavenia dosky „Arduino Uno“ v prostredí Arduino IDE.

Rozhranie

Sériový UART
Primárnym rozhraním s OpenLogom je FTDI konektor na okraji dosky. Tento konektor je určený na priame pripojenie k Arduino Pro alebo Pro Mini, čo umožňuje mikrokontroléru odosielať dáta cez sériové pripojenie do OpenLogu.

POZOR! Kvôli usporiadaniu pinov, ktoré ho robí kompatibilným s doskami Arduino, sa nedá priamo zapojiť do rozbočovacej dosky FTDI.

Viac informácií nájdete v nasledujúcej časti o pripojení hardvéru.

SPI

Na opačnom konci dosky sú tiež štyri testovacie SPI konektory. Tieto konektory môžete použiť na preprogramovanie bootloaderu na ATmega328.

• Najnovší OpenLog (DEV-13712) má tieto piny vylamované na menších pokovovaných priechodných otvoroch. Ak potrebujete na preprogramovanie alebo nahranie nového bootloaderu do OpenLogu použiť poskytovateľa internetových služieb, môžete na pripojenie k týmto testovacím bodom použiť pogo piny.
• Posledným rozhraním pre komunikáciu s OpenLogom je samotná karta microSD. Na komunikáciu karta microSD vyžaduje SPI piny. Nielenže sa tu ukladajú dáta pomocou OpenLogu, ale konfiguráciu OpenLogu môžete aktualizovať aj pomocou súboru config.txt. file na karte microSD.
  Karta microSD

Všetky údaje zaznamenané zariadením OpenLog sú uložené na karte microSD. OpenLog funguje s kartami microSD, ktoré majú nasledujúce funkcie:

• 64 MB až 32 GB
• FAT16 alebo FAT32

Na zariadení OpenLog sú dve stavové LED diódy, ktoré vám pomôžu pri riešení problémov.

• STAT1 – Táto modrá indikačná LED dióda je pripojená k doske Arduino D5 (ATmega328 PD5) a zapína/vypína sa pri prijatí nového znaku. Táto LED dióda bliká, keď funguje sériová komunikácia.
• STAT2 – Táto zelená LED dióda je pripojená k Arduinu D13 (SPI Serial Clock Line/ATmega328 PB5). Táto LED dióda bliká iba vtedy, keď je aktívne rozhranie SPI. Blikať uvidíte, keď OpenLog zaznamená 512 bajtov na kartu microSD.

Hardvérové ​​pripojenie

Existujú dva hlavné spôsoby pripojenia vášho OpenLogu k obvodu. Na pripojenie budete potrebovať nejaké konektory alebo vodiče. Pre bezpečné pripojenie sa uistite, že ste ich prispájkovali k doske.

Základné sériové pripojenie

TipAk máte na OpenLogu samičí konektor a na FTDI samičí konektor, na prepojenie budete potrebovať prepojovacie vodiče M/F.

Toto hardvérové ​​pripojenie je navrhnuté na prepojenie s OpenLogom, ak potrebujete preprogramovať dosku alebo zaznamenávať dáta cez základné sériové pripojenie.

Vykonajte nasledujúce pripojenia:
OpenLog → 3.3V FTDI základný rozbočovač

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

Všimnite si, že nejde o priame prepojenie medzi FTDI a OpenLogom – musíte prehodiť pripojenia pinov TXO a RXI.

Vaše pripojenia by mali vyzerať takto:

Keď už máte prepojené zariadenia OpenLog a FTDI Basic, zapojte dosku FTDI do USB kábla a počítača. Otvorte sériový terminál, pripojte ju k COM portu vášho FTDI Basic a môžete sa do toho pustiť!

Pripojenie hardvéru projektu

Tip: Ak máte na OpenLogu prispájkované samičie konektory, môžete k Arduino Pro Mini prispájkovať samčie konektory, aby ste dosky spojili bez potreby káblov.

Hoci je prepojenie s OpenLogom cez sériové pripojenie dôležité pre preprogramovanie alebo ladenie, OpenLog sa osvedčí v embedded projektoch. Tento všeobecný obvod odporúčame pripojiť váš OpenLog k mikrokontroléru (v tomto prípade Arduino Pro Mini), ktorý bude zapisovať sériové dáta do OpenLogu.

Najprv budete musieť nahrať kód do vášho Pro Mini, ktoré chcete spustiť. Pozrite si, prosím, náčrty Arduina, kde nájdete niekoľko príkladov.ampkód, ktorý môžete použiť.

Poznámka: Ak si nie ste istí, ako naprogramovať svoj Pro Mini, pozrite si náš návod tu.

Používanie Arduino Pro Mini 3.3V

• Tento tutoriál je vaším sprievodcom všetkým, čo sa týka Arduino Pro Mini. Vysvetľuje, čo to je, čo to nie je a ako to začať používať.
• Keď naprogramujete svoj Pro Mini, môžete vybrať dosku FTDI a nahradiť ju OpenLogom. Uistite sa, že ste zapojili piny označené BLK na Pro Mini aj OpenLog (piny označené GRN na oboch sa tiež zhodujú, ak to urobíte správne).
• Ak nemôžete zapojiť OpenLog priamo do Pro Mini (kvôli nezhodným konektorom alebo iným doskám v ceste), môžete použiť prepojovacie káble a vykonať nasledujúce pripojenia.

OpenLog → Arduino Pro/Arduino Pro Mini

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

Keď skončíte, vaše pripojenia s Arduinom Pro Mini a Arduinom Pro by mali vyzerať takto. Fritzingov diagram zobrazuje OpenLogs so zrkadlovo otočenými hlavičkami. Ak otočíte microSD päticu vzhľadom na vrch Arduina view, mali by sa zhodovať s programovacou hlavičkou ako FTDI.

Upozorňujeme, že pripojenie je priame s OpenLogom „hore nohami“ (s microSD smerom nahor).

Poznámka: Keďže Vcc a GND medzi OpenLogom a Arduinom sú obsadené konektormi, budete musieť pripojiť napájanie k ostatným dostupným pinom na Arduine. V opačnom prípade by ste mohli prispájkovať vodiče k odkrytým napájacím pinom na ktorejkoľvek doske.

Zapnite systém a ste pripravení začať logovať!

Náčrty pre Arduino

Existuje šesť rôznych bývalýchampzahrnuté náčrty, ktoré môžete použiť na Arduine po pripojení k OpenLogu.

• OpenLog_Benchmarking — Tento exampPoužíva sa na testovanie OpenLogu. Tento protokol odosiela veľmi veľké množstvo dát rýchlosťou 115200 XNUMX bps cez niekoľko files.
• OpenLog_CommandTest — Tento example ukazuje, ako vytvoriť a pripojiť file ovládanie z príkazového riadku cez Arduino.
• OpenLog_ReadExample — Tento exampTento návod popisuje, ako ovládať OpenLog pomocou príkazového riadka.
• OpenLog_ReadExample_LargeFile — Prample o tom, ako otvoriť veľký úložný priestor file na OpenLogu a nahlásiť to cez lokálne pripojenie Bluetooth.
• OpenLog_Test_Sketch — Používa sa na testovanie OpenLogu s množstvom sériových dát.
• OpenLog_Test_Sketch_Binary — Používa sa na testovanie OpenLogu s binárnymi údajmi a únikovými znakmi.

Firmvér

OpenLog má na palube dva hlavné softvérové ​​komponenty: bootloader a firmvér.

Bootloader pre Arduino

Poznámka: Ak používate OpenLog, ktorý bol zakúpený pred marcom 2012, integrovaný bootloader je kompatibilný s nastavením „Arduino Pro alebo Pro Mini 5V/16MHz s ATmega328“ v Arduino IDE.

• Ako už bolo spomenuté, OpenLog má integrovaný sériový bootloader Optiboot. Pri nahrávaní exportovaných dát môžete s OpenLogom zaobchádzať rovnako ako s Arduinom Uno.ampkód alebo nový firmvér na dosku.
• Ak sa vám stane, že sa vám OpenLog zablokuje a budete musieť preinštalovať bootloader, budete chcieť nahrať aj Optiboot na dosku. Viac informácií nájdete v našom návode na inštaláciu bootloaderu pre Arduino.

Kompilácia a načítanie firmvéru do OpenLog

Poznámka: Ak používate Arduino prvýkrát, prosím, znovaview náš návod na inštaláciu Arduino IDE. Ak ste ešte nenainštalovali knižnicu Arduino, pozrite si našu inštalačnú príručku a nainštalujte knižnice manuálne.

• Ak z akéhokoľvek dôvodu potrebujete aktualizovať alebo preinštalovať firmvér na vašom OpenLogu, nasledujúci postup vám pomôže spustiť vašu dosku.
• Najprv si stiahnite Arduino IDE v1.6.5. Iné verzie IDE môžu fungovať na kompiláciu firmvéru OpenLog, ale túto sme overili ako známu a funkčnú verziu.
• Ďalej si stiahnite firmvér OpenLog a požadovaný balík knižníc.

STIAHNUŤ BALÍK FIRMVÉRU OPENLOG (ZIP)

• Po stiahnutí knižníc a firmvéru ich nainštalujte do Arduina. Ak si nie ste istí, ako manuálne nainštalovať knižnice v IDE, pozrite si náš návod: Inštalácia knižnice pre Arduino: Manuálna inštalácia knižnice.

Poznámka:

• Používame upravené verzie knižníc SdFat a SerialPort, aby sme mohli ľubovoľne deklarovať, aké veľké by mali byť vyrovnávacie pamäte TX a RX. OpenLog vyžaduje, aby bola vyrovnávacia pamäť TX veľmi malá (0) a vyrovnávacia pamäť RX musí byť čo najväčšia.
• Použitie týchto dvoch upravených knižníc spolu umožňuje zvýšiť výkon OpenLogu.

Hľadáte najnovšie verzie?
Ak uprednostňujete najaktuálnejšie verzie knižníc a firmvéru, môžete si ich stiahnuť priamo z repozitárov GitHub, na ktoré odkazujeme nižšie. Knižnice SdFatLib a Serial Port nie sú viditeľné v správcovi dosiek Arduino, takže si ich budete musieť nainštalovať manuálne.

• GitHub: OpenLog > Firmvér > OpenLog_Firmware
• Knižnice Billa Greimana pre Arduino
  • SdFatLib-beta
  • Sériový port
• Ďalej, aby sme využili výhodytagZ upravených knižníc upravte súbor SerialPort.hh file nachádza sa v adresári \Arduino\Libraries\SerialPort. Zmeňte BUFFERED_TX na 0 a ENABLE_RX_ERROR_CHECKING na 0. Uložte filea otvorte vývojové prostredie Arduino.
• Ak ste tak ešte neurobili, pripojte svoj OpenLog k počítaču pomocou dosky FTDI. Skontrolujte, prosím, exampobvod, ak si nie ste istí, ako to správne urobiť.
• Otvorte náčrt OpenLog, ktorý chcete nahrať, v ponuke Nástroje>Doska, vyberte „Arduino/Genuino Uno“ a v časti Nástroje>Port vyberte správny COM port pre vašu dosku FTDI.
• Nahrajte kód.
• To je všetko! Váš OpenLog je teraz naprogramovaný s novým firmvérom. Teraz môžete otvoriť sériový monitor a interagovať s OpenLogom. Po zapnutí sa zobrazí buď 12>, alebo 12<. 1 znamená, že sériové pripojenie je nadviazané, 2 znamená, že SD karta bola úspešne inicializovaná, < znamená, že OpenLog je pripravený zaznamenávať všetky prijaté sériové dáta a > znamená, že OpenLog je pripravený prijímať príkazy.

Náčrty firmvéru OpenLog
V OpenLogu sú zahrnuté tri náčrty, ktoré môžete použiť v závislosti od vašej konkrétnej aplikácie.

• OpenLog – Tento firmvér sa štandardne dodáva s OpenLogom. Odoslaním príkazu ? sa zobrazí verzia firmvéru nahraná v jednotke.
• OpenLog_Light – Táto verzia náčrtu odstraňuje menu a príkazový režim, čo umožňuje zväčšenie prijímacej vyrovnávacej pamäte. Toto je dobrá voľba pre vysokorýchlostné protokolovanie.
• OpenLog_Minimal – Prenosová rýchlosť musí byť nastavená v kóde a nahraná. Táto skica sa odporúča pre skúsených používateľov, ale je tiež najlepšou voľbou pre najvyššiu rýchlosť logovania.

Sada príkazov

S OpenLogom sa môžete prepojiť cez sériový terminál. Nasledujúce príkazy vám pomôžu čítať, zapisovať a mazať files, ako aj zmeniť nastavenia OpenLog. Na použitie nasledujúcich nastavení budete musieť byť v príkazovom režime.

Keď je OpenLog v príkazovom režime, STAT1 sa zapne/vypne pre každý prijatý znak. LED dióda zostane svietiť, kým sa neprijme ďalší znak.

• Nové File – Vytvára nový file pomenovaný File v aktuálnom adresári. Štandard 8.3 filemená sú podporované. NapríkladampNapríklad „87654321.123“ je prijateľné, zatiaľ čo „987654321.123“ nie.
  • Example: nový file1.txt
• Pripojiť File – Pridať text na koniec FileSériové dáta sa potom načítajú z UART v prúde a pridajú sa do fileNeprenáša sa cez sériový terminál. Ak File neexistuje, keď sa táto funkcia volá, file sa vytvorí.
  • Example: pridať novýfile.csv
• Napíšte File OFFSET – Napíšte text do File z polohy OFFSET v rámci fileText sa číta z UARTu riadok po riadku a odosiela sa späť. Na ukončenie tohto stavu odošlite prázdny riadok.
  • Example: zápis logs.txt 516
• rm File – Vymaže File z aktuálneho adresára. Zástupné znaky sú podporované.
  • Exampsúbor: rm README.txt
• veľkosť File – Výstupná veľkosť File v bajtoch.
  • Exampsúbor: veľkosť Log112.csv
  • Výstup: 11
• Prečítajte si File + ŠTART+ TYP DĹŽKY – Výpis obsahu File od ŠTARTU až po DĹŽKU. Ak sa ŠTART vynechá, celý file sa uvádza. Ak sa vynechá argument LENGTH, zobrazí sa celý obsah od východiskového bodu. Ak sa vynechá argument TYPE, OpenLog sa predvolene zobrazí v ASCII. Existujú tri výstupné TYPE:
  • ASCII = 1
  • HEX = 2
  • SUROVÝ = 3
• Niektoré koncové argumenty môžete vynechať. Pozrite si nasledujúci príkladamples.
• Základné príznaky čítania + vynechania:
  • Example: čítať LOG00004.txt
  • Výstup: Akcelerometer X=12 Y=215 Z=317
• Čítať od začiatku 0 s dĺžkou 5:
  • Example: čítanie LOG00004.txt 0 5
  • Výstup: Zrýchlenie
• Čítať z pozície 1 s dĺžkou 5 v HEX:
  • Example: čítanie LOG00004.txt 1 5 2
  • Výstup: 63 63 65 6C
• Čítanie z pozície 0 s dĺžkou 50 v RAW:
  • Example: čítanie LOG00137.txt 0 50 3
  • Výstup: André– -þ Rozšírený test charakteru
• Cat File – Napíšte obsah file v hexadecimálnom kóde do sériového monitora pre viewing. Niekedy je užitočné vidieť, že a file nahráva správne bez nutnosti vyťahovania SD karty a view a file na počítači.
  • Exampsúbor: cat LOG00004.txt
  • Výstup: 00000000: 41 63 65 6c 3a 20 31

Manipulácia s adresármi

• ls – Vypíše všetok obsah aktuálneho adresára. Podporované sú zástupné znaky.
  • Example: ls
  • Výstup: \src
• Podadresár md – Vytvorí podadresár v aktuálnom adresári.
  • Example: md Example_Sketches
• Podadresár cd – Zmena na podadresár.
  • Example: cd Hello_World
• cd .. – Prechod do nižšieho adresára v stromovej štruktúre. Medzi „cd“ a „..“ je medzera. To umožňuje analyzátoru reťazcov vidieť príkaz CD.
  • Exampnapr. cd ..
• rm Podadresár – Odstráni podadresár. Aby tento príkaz fungoval, adresár musí byť prázdny.
  • Example: rm teploty
• rm -rf Adresár – Vymaže adresár a všetky fileje v ňom obsiahnutý.
  • Example: rm -rf Knižnice

Príkazy funkcií nízkej úrovne

• ? – Tento príkaz zobrazí zoznam dostupných príkazov v OpenLogu.
• Disk – Zobrazuje ID výrobcu karty, sériové číslo, dátum výroby a veľkosť karty. Napr.ampvýstup je:
  • Typ karty: SD2 ID výrobcu: 3
  • ID OEM: SD
  • Produkt: SU01G
  • Verzia: 8.0
  • Sériové číslo: 39723042 Dátum výroby: 1/2010 Veľkosť karty: 965120 KB
• init – Znova inicializuje systém a znova otvorí SD kartu. Toto je užitočné, ak SD karta prestane reagovať.
• Synchronizácia – Synchronizuje aktuálny obsah vyrovnávacej pamäte s kartou SD. Tento príkaz je užitočný, ak máte vo vyrovnávacej pamäti menej ako 512 znakov a chcete ich zaznamenať na kartu SD.
• Reset – Preskočí OpenLog na nulu, znova spustí bootloader a potom inicializačný kód. Tento príkaz je užitočný, ak potrebujete upraviť konfiguráciu. file, resetujte OpenLog a začnite používať novú konfiguráciu. Vypnutie a zapnutie napájania je stále preferovanou metódou resetovania dosky, ale táto možnosť je k dispozícii.

Systémové nastavenia

Tieto nastavenia je možné manuálne aktualizovať alebo upraviť v súbore config.txt file.

• Echo STATE – Mení stav systému a ukladá sa do systémovej pamäte. STATE môže byť zapnutý alebo vypnutý. Keď je zapnutý, OpenLog bude v príkazovom riadku odosielať prijaté sériové dáta. Keď je vypnutý, systém prijaté znaky nenačíta späť.

Poznámka: Počas normálneho logovania bude echo vypnuté. Nároky na systémové zdroje na logovanie prijatých údajov sú počas logovania príliš vysoké.

• Verbose STATE – Mení stav podrobného hlásenia chýb. STATE môže byť zapnutý alebo vypnutý. Tento príkaz je uložený v pamäti. Vypnutím podrobných chýb bude OpenLog reagovať iba znakom !, ak sa vyskytne chyba, a nie neznámym príkazom: C OMMAND.D..T Znaky he sa pre vstavané systémy ľahšie analyzujú ako celá chyba. Ak používate terminál, ponechanie podrobného hlásenia zapnuté vám umožní vidieť celé chybové hlásenia.
• baud – Tento príkaz otvorí systémové menu, ktoré používateľovi umožní zadať prenosovú rýchlosť. Podporovaná je ľubovoľná prenosová rýchlosť medzi 300 bps a 1 Mbps. Výber prenosovej rýchlosti je okamžitý a OpenLog vyžaduje na aktiváciu cyklus vypnutia a vypnutia napájania. Prenosová rýchlosť sa uloží do pamäte EEPROM a načíta sa pri každom zapnutí OpenLog. Predvolená hodnota je 9600 8N1.

Pamätajte: Ak sa doska zasekne na neznámej prenosovej rýchlosti, môžete prepojiť RX s GND a zapnúť OpenLog. LED diódy budú 2 sekundy blikať tam a späť a potom budú blikať súčasne. Vypnite OpenLog a odstráňte prepojku. OpenLog sa teraz resetuje na 9600 bps po troch stlačeniach klávesovej skratky `CTRL-Z`. Túto funkciu je možné prepísať nastavením bitu núdzového prepínania na 1. Viac informácií nájdete v súbore config.txt.

• Nastaviť – Tento príkaz otvorí systémové menu na výber režimu spustenia. Tieto nastavenia sa prejavia pri ďalšom zapnutí a sú uložené v energeticky nezávislej pamäti EEPROM.
  • Nové File Záznam – Tento režim vytvára nový file pri každom zapnutí OpenLogu. OpenLog odošle 1 (UART je aktívny), 2 (SD karta je inicializovaná) a potom < (OpenLog je pripravený prijímať dáta). Všetky dáta sa zaznamenajú do súboru LOG#####.txt. Číslo ##### sa zvyšuje pri každom zapnutí OpenLogu (maximálne je 65533 záznamov). Číslo je uložené v EEPROM a je možné ho vynulovať z ponuky nastavení. Nie všetky prijaté znaky sa prehrajú. Tento režim môžete ukončiť a vstúpiť do príkazového režimu odoslaním kombinácie klávesov CTRL+z (ASCII 26). Všetky uložené dáta sa uložia.
• Poznámka: Ak bolo vytvorených príliš veľa protokolov, OpenLog vypíše chybu **Príliš veľa protokolov**, ukončí tento režim a prejde na príkazový riadok. Sériový výstup bude vyzerať takto: `12!Príliš veľa protokolov!
  • Pripojiť File Záznam – Tento režim, známy aj ako sekvenčný režim, vytvára file nazýva sa SEQLOG.txt, ak tam ešte nie je, a pridá všetky prijaté údaje do fileOpenLog odošle 12<, kedy je OpenLog pripravený prijímať dáta. Znaky sa neodosielajú. Tento režim môžete ukončiť a vstúpiť do príkazového režimu odoslaním CTRL+z (ASCII 26). Všetky uložené dáta budú uložené.
  • Príkazový riadok – OpenLog odošle 12>, v ktorom je systém pripravený prijímať príkazy. Upozorňujeme, že znak > označuje, že OpenLog je pripravený prijímať príkazy, nie dáta. Môžete vytvoriť filea pridajte údaje do files, ale to si vyžaduje sériové spracovanie (na kontrolu chýb), takže tento režim štandardne nenastavujeme.
  • Obnoviť Nové File Číslo – Tento režim vynuluje protokol file číslo do súboru LOG000.txt. Toto je užitočné, ak ste nedávno vyprázdnili kartu microSD a chcete, aby sa záznam file čísla na začiatok odznova.
  • Nový escape znak – Táto možnosť umožňuje používateľovi zadať znak, napríklad CTRL+z alebo $, a nastaviť ho ako nový escape znak. Toto nastavenie sa počas núdzového resetu resetuje na CTRL+z.
  • Počet únikových znakov – Táto možnosť umožňuje používateľovi zadať znak (napríklad 1, 3 alebo 17), čím sa aktualizuje nový počet únikových znakov potrebných na prechod do príkazového režimu. Napríkladampnapr. zadanie čísla 8 bude vyžadovať, aby používateľ osemkrát stlačil klávesy CTRL+z, aby sa dostal do príkazového režimu. Toto nastavenie sa počas núdzového resetu resetuje na hodnotu 3.
• Vysvetlenie znakov escape: Dôvod, prečo OpenLog vyžaduje trojité stlačenie klávesov `CTRL+z` na vstup do príkazového režimu, je zabrániť náhodnému resetovaniu dosky počas nahrávania nového kódu z Arduino IDE. Existuje možnosť, že doska uvidí znak `CTRL+z` počas bootovania (problém, ktorý sme zaznamenali v skorších verziách firmvéru OpenLog), takže cieľom je tomu zabrániť. Ak máte podozrenie, že vaša doska bola z tohto dôvodu zablokovaná, môžete vždy vykonať núdzový reset tak, že počas zapínania podržíte pin RX na zemi.

Konfigurácia File

Ak nechcete používať sériový terminál na úpravu nastavení vášho OpenLogu, môžete nastavenia aktualizovať aj úpravou súboru CONFIG.TXT. file.

Poznámka: Táto funkcia funguje iba s verziou firmvéru 1.6 alebo novšou. Ak ste si zakúpili OpenLog po roku 2012, budete používať verziu firmvéru 1.6 alebo novšiu.

• Na to budete potrebovať čítačku kariet microSD a textový editor. Otvorte súbor config.txt file (kapitalizácia file (na názve nezáleží) a nakonfigurujte ho! Ak ste svoj OpenLog ešte nikdy nezapínali pomocou SD karty, môžete ho vytvoriť aj manuálne fileAk ste predtým zapli OpenLog s vloženou microSD kartou, pri načítaní microSD karty by ste mali vidieť niečo podobné ako nasledovné.OpenLog vytvorí súbory config.txt a LOG0000.txt file pri prvom zapnutí.
• Predvolená konfigurácia file má jeden riadok nastavení a jeden riadok definícií.Predvolená konfigurácia file bol napísaný spoločnosťou OpenLog.
• Upozorňujeme, že ide o bežné viditeľné znaky (neexistujú žiadne neviditeľné ani binárne hodnoty) a každá hodnota je oddelená čiarkou.

Nastavenia sú definované nasledovne:

• baud: Prenosová rýchlosť komunikácie. Predvolená hodnota je 9600 bps. Prijateľné hodnoty kompatibilné s Arduino IDE sú 2400, 4800, 9600, 19200, 38400, 57600 a 115200. Môžete použiť aj iné prenosové rýchlosti, ale nebudete môcť komunikovať s OpenLogom cez sériový monitor Arduino IDE.
• Escap:e Hodnota ASCII (v desiatkovom formáte) escape znaku. 26 je CTRL+z a je predvolená hodnota. 36 je $ a je bežne používaný escape znak.
• Esc #: Počet požadovaných znakov escape. Predvolene sú to tri, takže na prechod do príkazového režimu musíte znak escape stlačiť trikrát. Prijateľné hodnoty sú od 0 do 254. Nastavenie tejto hodnoty na 0 úplne vypne kontrolu znakov escape.
• Režim Systémový režim. OpenLog sa štandardne spúšťa v režime Nový protokol (0). Prijateľné hodnoty sú 0 = Nový protokol, 1 = Sekvenčný protokol, 2 = Príkazový režim.
• Sloveso: Podrobný režim. Rozšírené (podrobné) chybové hlásenia sú predvolene zapnuté. Nastavením na hodnotu 1 sa zapnú podrobné chybové hlásenia (napríklad neznámy príkaz: odstrániť !). Nastavenie na hodnotu 0 vypne podrobné chyby, ale v prípade chyby sa zobrazí odpoveď !. Vypnutie podrobného režimu je užitočné, ak sa pokúšate spracovať chyby zo zabudovaného systému.
• Echo: Režim Echo. V príkazovom režime sa znaky štandardne opakujú. Nastavenie na 0 vypne echo znakov. Vypnutie je užitočné pri spracovaní chýb a nechcete, aby sa odoslané príkazy opakovali späť do OpenLog.II.
• ignoreRXEmergency Override. OpenLog sa normálne núdzovo resetuje, keď je RX pin počas zapínania nastavený na nízku úroveň. Nastavenie tejto hodnoty na 1 zakáže kontrolu RX pinu počas zapínania. Toto môže byť užitočné pre systémy, ktoré z rôznych dôvodov udržiavajú RX linku na nízkej úrovni. Ak je núdzové prepínanie zakázané, nebudete môcť jednotku vynútiť späť na 9600 bps a konfigurácia file bude jediný spôsob, ako upraviť prenosovú rýchlosť.

Ako OpenLog upravuje konfiguráciu File
Existuje päť rôznych situácií, kedy môže OpenLog upraviť súbor config.txt file.

• Konfig file nájdené: Počas zapínania bude OpenLog hľadať súbor config.txt file. Ak file ak sa nájde , OpenLog použije zahrnuté nastavenia a prepíše všetky predtým uložené systémové nastavenia.
• Žiadna konfigurácia file nájdené: Ak OpenLog nedokáže nájsť súbor config.txt file OpenLog potom vytvorí súbor config.txt a zaznamená doň aktuálne uložené systémové nastavenia. To znamená, že ak vložíte novo naformátovanú kartu microSD, váš systém si zachová svoje aktuálne nastavenia.
• Poškodená konfigurácia file nájdené: OpenLog vymaže poškodený súbor config.txt filea prepíše interné nastavenia EEPROM aj nastavenia súboru config.txt file do známeho dobrého stavu 9600,26,3,0,1,1,0.
• Neplatné hodnoty v konfigurácii fileAk OpenLog zistí akékoľvek nastavenia obsahujúce neplatné hodnoty, OpenLog prepíše poškodené hodnoty v súbore config.txt. file s aktuálne uloženými systémovými nastaveniami EEPROM.
• Zmeny prostredníctvom príkazového riadka: Ak sa systémové nastavenia zmenia prostredníctvom príkazového riadka (buď cez sériové pripojenie, alebo prostredníctvom sériových príkazov mikrokontroléra), tieto zmeny sa zaznamenajú do systémovej EEPROM aj do súboru config.txt. file.
• Núdzový reset: Ak je OpenLog vypnutý a zapnutý pomocou prepojky medzi RX a GND a bit núdzového prepísania je nastavený na 0 (čo umožňuje núdzový reset), OpenLog prepíše interné nastavenia EEPROM aj nastavenia súboru config.txt. file do známeho dobrého stavu 9600,26,3,0,1,1,0.

Riešenie problémov

Existuje niekoľko rôznych možností, ako skontrolovať, či máte problémy s pripojením cez sériový monitor, či máte problémy so stratenými znakmi v protokoloch alebo či bojujete so zablokovaným OpenLogom.

Skontrolujte správanie LED diódy STAT1
LED dióda STAT1 zobrazuje rôzne správanie pri dvoch rôznych bežných chybách.

• 3 bliknutia: Inicializácia karty microSD zlyhala. Možno bude potrebné kartu naformátovať pomocou systému FAT/FAT16 v počítači.
• 5 bliknutí: OpenLog zmenil prenosovú rýchlosť a je potrebné ho vypnúť a znova napájať.

Dvojitá kontrola štruktúry podadresárov

• Ak používate predvolený súbor OpenLog.ino exampOpenLog bude podporovať iba dva podadresáre. Budete musieť zmeniť FOLDER_TRACK_DEPTH z 2 na počet podadresárov, ktoré potrebujete podporovať. Keď to urobíte, prekompilujte kód a nahrajte upravený firmvér.
• Overte počet Filev koreňovom adresári
• OpenLog bude podporovať iba maximálne 65,534 XNUMX protokolov. files v koreňovom adresári. Odporúčame preformátovať kartu microSD, aby sa zrýchlilo zaznamenávanie.
• Overte veľkosť upraveného firmvéru
• Ak píšete vlastný náčrt pre OpenLog, overte si, či váš náčrt nie je väčší ako 32,256 500. Ak áno, zaberie horných XNUMX bajtov Flash pamäte, ktorú používa sériový bootloader Optiboot.
• Dvojitá kontrola File Mená
• Všetky file Názvy by mali byť alfanumerické. MyLOG1.txt je v poriadku, ale súbor Hi !e _ .txtt nemusí fungovať.
• Použite 9600 Baudov
• OpenLog beží na čipe ATmega328 a má obmedzené množstvo pamäte RAM (2048 bajtov). Keď do OpenLogu odošlete sériové znaky, tieto znaky sa uložia do vyrovnávacej pamäte. Zjednodušená špecifikácia SD Group umožňuje, aby SD karte trvalo až 250 ms (časť 4.6.2.2 Zápis), kým sa blok dát do flash pamäte zapíše.
• Pri rýchlosti 9600 b/s je to 960 bajtov (10 bitov na bajt) za sekundu. To je 1.04 ms na bajt. OpenLog v súčasnosti používa 512-bajtovú prijímaciu vyrovnávaciu pamäť, takže dokáže uložiť približne 50 ms znakov. To umožňuje OpenLogu úspešne prijímať všetky znaky prichádzajúce rýchlosťou 9600 b/s. So zvyšujúcou sa prenosovou rýchlosťou sa vyrovnávacia pamäť bude ukladať kratšie.

Čas pretečenia vyrovnávacej pamäte OpenLog

Mnohé SD karty majú čas záznamu rýchlejší ako 250 ms. To môže byť ovplyvnené „triedou“ karty a množstvom údajov, ktoré sú už na karte uložené. Riešením je použiť nižšiu prenosovú rýchlosť alebo zvýšiť čas medzi znakmi odoslanými pri vyššej prenosovej rýchlosti.

Často kladené otázky