SparkFun-logo

SparkFun DEV-13712 Foton Zarah Dengan Lubang Untuk Memateri

SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-product

Spesifikasi

  • Nama Produk: OpenLog Data Logger
  • Model: DEV-13712
  • Input Kuasa: 3.3V-12V (Disyorkan 3.3V-5V)
  • RXI Input Voltage: 2.0V-3.8V
  • TXO Output Voltage: 3.3V
  • Cabutan Arus Melahu: ~2mA-5mA (tanpa kad mikroSD), ~5mA-6mA (dengan kad mikroSD)
  • Cabutan Semasa Penulisan Aktif: ~20-23mA (dengan kad mikroSD)

Arahan Penggunaan Produk

Bahan yang Diperlukan:

  • Arduino Pro Mini 328 – 3.3V/8MHz
  • Pecah Asas SparkFun FTDI – 3.3V
  • Kabel USB SparkFun Cerberus – 6 kaki
  • Kad microSD dengan Penyesuai – 16GB (Kelas 10)
  • Pembaca USB microSD
  • Tajuk Perempuan
  • Jumper Wires Premium 6 M/M Pek 10
  • Tajuk Lelaki Berpisah – Sudut Kanan

Bacaan yang Dicadangkan:

Perkakasan Selesaiview:
OpenLog berjalan pada tetapan berikut:

Input VCC Input RXI Keluaran TXO Cabutan Semasa Terbiar Penulisan Aktif Cabutan Semasa
3.3V-12V (Disyorkan 3.3V-5V) 2.0V-3.8V 3.3V ~2mA-5mA (tanpa kad mikroSD), ~5mA-6mA (dengan kad mikroSD) ~20- 23mA (dengan/ kad microSD)

pengenalan

Angkat kepala! Tutorial ini adalah untuk Log Terbuka untuk UART bersiri [ DEV-13712 ]. Jika anda menggunakan Qwiic OpenLog untuk IC [ DEV-15164 ], sila rujuk kepada Panduan Hookup OpenLog Qwiic.

Logger Data OpenLog ialah penyelesaian sumber terbuka yang mudah digunakan untuk mengelog data bersiri daripada projek anda. OpenLog menyediakan antara muka bersiri mudah untuk log data daripada projek ke kad microSD.

SparkFun OpenLog
DEV-13712

SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-fig- (1)

SparkFun OpenLog dengan Pengepala
DEV-13955

Tiada produk ditemui

Bahan yang Diperlukan
Untuk melaksanakan sepenuhnya tutorial ini, anda memerlukan bahagian berikut. Anda mungkin tidak memerlukan segala-galanya walaupun bergantung pada apa yang anda ada. Tambahkannya pada troli anda, baca panduan dan laraskan troli jika perlu.

Panduan Hookup OpenLog

Senarai Hajat SparkFun

SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-fig- (2)SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-fig- (3)

Bacaan yang Dicadangkan
Jika anda tidak biasa atau tidak selesa dengan konsep berikut, kami mengesyorkan membaca ini sebelum meneruskan dengan Panduan Sambungan OpenLog.

  • Cara Memateri: Memateri Lubang Melalui. Tutorial ini merangkumi semua yang anda perlu ketahui tentang pematerian lubang melalui.
  • Komunikasi Bersiri Konsep komunikasi bersiri tak segerak: paket, tahap isyarat, kadar baud, UART dan banyak lagi!
  • Antara Muka Peranti Bersiri (SPI) SPI biasanya digunakan untuk menyambungkan mikropengawal kepada peranti seperti penderia, daftar anjakan dan kad SD.
  • Asas Terminal Bersiri Tutorial ini akan menunjukkan kepada anda cara berkomunikasi dengan peranti bersiri anda menggunakan pelbagai aplikasi emulator terminal.

Perkakasan Selesaiview

kuasa
OpenLog berjalan pada tetapan berikut:

Penilaian Kuasa OpenLog

SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-fig- (4)

Cabutan semasa OpenLog adalah kira-kira 20mA hingga 23mA apabila menulis kepada mikroSD. Bergantung pada saiz kad microSD dan pengilangnya, cabutan semasa aktif boleh berbeza-beza apabila OpenLog menulis pada kad memori. Meningkatkan kadar baud juga akan menarik lebih banyak arus.

Pengawal mikro
OpenLog menjalankan ATmega328 onboard, berjalan pada 16MHz, terima kasih kepada kristal onboard. ATmega328 mempunyai pemuat but Optiboot dimuatkan padanya, yang membolehkan OpenLog serasi dengan
Tetapan papan “Arduino Uno” dalam IDE Arduino.

SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-fig- (5)

Antara muka

UART bersiri
Antara muka utama dengan OpenLog ialah pengepala FTDI di tepi papan. Pengepala ini direka untuk memasangkan terus ke Arduino Pro atau Pro Mini, yang membolehkan mikropengawal menghantar data melalui sambungan bersiri ke OpenLog.

SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-fig- (6)

Amaran! Oleh kerana pesanan pin yang menjadikannya serasi dengan Arduino, ia tidak boleh dipasang terus ke papan pemecah FTDI.

SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-fig- (7)

Untuk maklumat lanjut, pastikan anda menyemak bahagian seterusnya pada Perkaitan Perkakasan.

SPI

Terdapat juga empat mata ujian SPI yang dipecahkan di hujung papan yang bertentangan. Anda boleh menggunakannya untuk memprogram semula pemuat but pada ATmega328.

  • SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-fig- (8)OpenLog terkini (DEV-13712) memecahkan pin ini pada lubang bersalut yang lebih kecil. Jika anda perlu menggunakan ISP untuk memprogram semula atau memuat naik pemuat but baharu ke OpenLog, anda boleh menggunakan pin pogo untuk menyambung ke titik ujian ini.
  • Antara muka terakhir untuk berkomunikasi dengan OpenLog ialah kad microSD itu sendiri. Untuk berkomunikasi, kad microSD memerlukan pin SPI. Bukan sahaja ini di mana data disimpan oleh OpenLog, tetapi anda juga boleh mengemas kini konfigurasi OpenLog melalui config.txt file pada kad microSD.
    kad microSD

Semua data yang dilog oleh OpenLog disimpan pada kad microSD. OpenLog berfungsi dengan kad microSD yang mempunyai ciri berikut:

  • 64MB hingga 32GB
  • FAT16 atau FAT32

SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-fig- (9)

Terdapat dua LED status pada OpenLog untuk membantu anda menyelesaikan masalah.

  • STAT1 – LED penunjuk biru ini dipasang pada Arduino D5 (ATmega328 PD5) dan bertukar-tukar hidup/mati apabila aksara baharu diterima. LED ini berkelip apabila komunikasi bersiri berfungsi.
  • STAT2 - LED hijau ini disambungkan kepada Arduino D13 (SPI Serial Clock Line/ ATmega328 PB5). LED ini hanya berkelip apabila antara muka SPI aktif. Anda akan melihatnya berkelip apabila OpenLog merekodkan 512 bait ke kad microSD.

SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-fig- (10)

Sambungan Perkakasan

Terdapat dua kaedah utama untuk menyambungkan OpenLog anda ke litar. Anda memerlukan beberapa pengepala atau wayar untuk menyambung. Pastikan anda memateri pada papan untuk sambungan yang selamat.

Sambungan Bersiri Asas

Petua: Jika anda mempunyai pengepala wanita pada OpenLog dan pengepala wanita pada FTDI, anda memerlukan wayar pelompat M/F untuk menyambung.

SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-fig- (11)

Sambungan perkakasan ini direka bentuk untuk antara muka dengan OpenLog jika anda perlu memprogram semula papan atau log data melalui sambungan bersiri asas.

Buat sambungan berikut:
OpenLog → 3.3V FTDI Breakout Asas

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

Perhatikan bahawa ia bukan sambungan langsung antara FTDI dan OpenLog – anda mesti menukar sambungan pin TXO dan RXI.

Sambungan anda sepatutnya kelihatan seperti berikut:

SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-fig- (12)

Sebaik sahaja anda mempunyai sambungan antara OpenLog dan FTDI Basic, palamkan papan FTDI anda ke dalam kabel USB dan komputer anda. Buka terminal bersiri, sambungkan ke port COM FTDI Basic anda, dan pergi ke bandar!

Sambungan Perkakasan Projek

Petua: Jika anda mempunyai pengepala wanita yang dipateri pada OpenLog, anda boleh memateri pengepala lelaki ke Arduino Pro Mini untuk memasangkan papan bersama tanpa memerlukan wayar.

SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-fig- (13)

Walaupun antara muka dengan OpenLog melalui sambungan bersiri adalah penting untuk pengaturcaraan semula atau penyahpepijatan, tempat di mana OpenLog bersinar adalah dalam projek terbenam. Litar umum ini ialah cara kami mengesyorkan anda menyambungkan OpenLog anda kepada mikropengawal (dalam kes ini, Arduino Pro Mini) yang akan menulis data bersiri ke OpenLog.

Pertama, anda perlu memuat naik kod ke Pro Mini anda yang ingin anda jalankan. Sila lihat Lakaran Arduino untuk beberapa bekasampkod yang anda boleh gunakan.

Nota: Jika anda tidak pasti cara memprogramkan Pro Mini anda, sila lihat tutorial kami di sini.

Menggunakan Arduino Pro Mini 3.3V

  • Tutorial ini adalah panduan anda untuk semua perkara Arduino Pro Mini. Ia menerangkan apa itu, apa yang bukan, dan cara mula menggunakannya.
  • Sebaik sahaja anda telah memprogramkan Pro Mini anda, anda boleh mengalih keluar papan FTDI dan menggantikannya dengan OpenLog. Pastikan untuk menyambungkan pin berlabel BLK pada kedua-dua Pro Mini dan OpenLog (pin berlabel GRN pada kedua-duanya juga akan sepadan jika dilakukan dengan betul).
  • Jika anda tidak boleh memasangkan OpenLog terus ke dalam Pro Mini (disebabkan pengepala yang tidak sepadan atau papan lain yang menghalang), anda boleh menggunakan wayar pelompat dan membuat sambungan berikut.

OpenLog → Arduino Pro/Arduino Pro Mini

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

Sebaik sahaja anda selesai, sambungan anda sepatutnya kelihatan seperti berikut dengan Arduino Pro Mini dan Arduino Pro. Gambar rajah Fritzing menunjukkan OpenLogs dengan pengepala dicerminkan. Jika anda membalikkan soket microSD berbanding bahagian atas Arduino view, mereka harus sepadan dengan pengepala pengaturcaraan seperti FTDI.

SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-fig- (14)

Ambil perhatian bahawa sambungan adalah syot lurus dengan OpenLog "terbalik" (dengan microSD menghadap ke atas).

Nota: Memandangkan Vcc dan GND antara OpenLog dan Arduino sedang diduduki oleh pengepala, anda perlu menyambung kepada kuasa ke pin lain yang tersedia pada Arduino. Jika tidak, anda boleh memateri wayar ke pin kuasa terdedah pada mana-mana papan.

Kuatkan sistem anda, dan anda sudah bersedia untuk mula mengelog!

Lakaran Arduino

Terdapat enam bekas yang berbezaamptermasuk lakaran yang boleh anda gunakan pada Arduino apabila disambungkan ke OpenLog.

  • OpenLog_Benchmarking — Bekas iniample digunakan untuk menguji OpenLog. Ini menghantar jumlah data yang sangat besar pada 115200bps dalam berbilang files.
  • OpenLog_CommandTest — Ex iniample menunjukkan cara membuat dan menambahkan a file melalui kawalan baris arahan melalui Arduino.
  • OpenLog_ReadExample - Bekas iniample menjalankan bagaimana untuk mengawal OpenLog melalui baris arahan.
  • OpenLog_ReadExample_BesarFile - Cthampbagaimana untuk membuka simpanan yang besar file pada OpenLog dan laporkannya melalui sambungan Bluetooth tempatan.
  • OpenLog_Test_Sketch — Digunakan untuk menguji OpenLog dengan banyak data bersiri.
  • OpenLog_Test_Sketch_Binary — Digunakan untuk menguji OpenLog dengan data binari dan aksara melarikan diri.

Perisian tegar

OpenLog mempunyai dua perisian utama pada papan: pemuat but dan perisian tegar.

Pemuat But Arduino

Nota: Jika anda menggunakan OpenLog yang dibeli sebelum Mac 2012, pemuat but onboard serasi dengan tetapan "Arduino Pro atau Pro Mini 5V/16MHz w/ ATmega328" dalam Arduino IDE.

  • Seperti yang dinyatakan sebelum ini, OpenLog mempunyai pemuat but bersiri Optiboot. Anda boleh merawat OpenLog seperti Arduino Uno apabila memuat naik exampkod atau perisian tegar baharu ke papan.
  • Jika anda akhirnya merosakkan OpenLog anda dan perlu memasang semula pemuat but, anda juga akan mahu memuat naik Optiboot ke papan. Sila lihat tutorial kami tentang memasang Arduino Bootloader untuk maklumat lanjut.

Menyusun dan Memuatkan Perisian Tegar pada OpenLog

Nota: Jika ini kali pertama anda menggunakan Arduino, sila semulaview tutorial kami tentang memasang Arduino IDE. Jika anda belum memasang perpustakaan Arduino sebelum ini, sila lihat panduan pemasangan kami untuk memasang perpustakaan secara manual.

  • Jika atas apa-apa sebab anda perlu mengemas kini atau memasang semula perisian tegar pada OpenLog anda, proses berikut akan menyediakan papan anda dan berjalan.
  • Mula-mula, sila muat turun Arduino IDE v1.6.5. Versi lain IDE mungkin berfungsi untuk menyusun perisian tegar OpenLog, tetapi kami telah mengesahkan ini sebagai versi yang diketahui baik.
  • Seterusnya, muat turun perisian tegar OpenLog dan himpunan perpustakaan yang diperlukan.

MUAT TURUN OPENLOG FIRMWARE BUNDLE (ZIP)

  • Sebaik sahaja anda memuat turun perpustakaan dan perisian tegar, pasang perpustakaan ke dalam Arduino. Jika anda tidak pasti cara memasang perpustakaan secara manual dalam IDE, sila lihat tutorial kami: Memasang Perpustakaan Arduino: Memasang Perpustakaan Secara Manual.

Nota:

  • Kami menggunakan versi pustaka SdFat dan SerialPort yang diubah suai untuk mengisytiharkan sewenang-wenangnya berapa besar penimbal TX dan RX sepatutnya. OpenLog memerlukan penimbal TX menjadi sangat kecil (0), dan penimbal RX perlu sebesar mungkin.
  • Menggunakan kedua-dua perpustakaan yang diubah suai ini bersama-sama membolehkan peningkatan prestasi OpenLog.

Mencari Versi Terkini?
Jika anda lebih suka versi pustaka dan perisian tegar yang paling terkini, anda boleh memuat turunnya terus daripada repositori GitHub yang dipautkan di bawah. Perpustakaan SdFatLib dan Serial Port tidak kelihatan dalam pengurus papan Arduino jadi anda perlu memasang perpustakaan secara manual.

  • GitHub: OpenLog > Firmware > OpenLog_Firmware
  • Perpustakaan Arduino Bill Greiman
    • SdFatLib-beta
    • SerialPort
  • Seterusnya, untuk mengambil advantage daripada perpustakaan yang diubah suai, ubah suai SerialPort.hh file ditemui dalam direktori \Arduino\Libraries\SerialPort. Tukar BUFFERED_TX kepada 0 dan ENABLE_RX_ERROR_CHECKING kepada 0. Simpan file, dan buka Arduino IDE.
  • Jika anda belum melakukannya, sambungkan OpenLog anda ke komputer melalui papan FTDI. Sila semak semula bekas ituample litar jika anda tidak pasti bagaimana untuk melakukan ini dengan betul.
  • Buka lakaran OpenLog yang anda ingin muat naik di bawah menu Alat>Papan, pilih "Arduino/Genuino Uno", dan pilih port COM yang sesuai untuk papan FTDI anda di bawah Alat>Port.
  • Muat naik kod.
  • Itu sahaja! OpenLog anda kini diprogramkan dengan perisian tegar baharu. Anda kini boleh membuka monitor bersiri dan berinteraksi dengan OpenLog. Apabila kuasa dinaikkan, anda akan melihat sama ada 12> atau 12<. 1 menunjukkan sambungan bersiri diwujudkan, 2 menunjukkan kad SD telah berjaya dimulakan, < menunjukkan OpenLog bersedia untuk log sebarang data bersiri yang diterima, dan > menunjukkan OpenLog bersedia untuk menerima arahan.

Lakaran Perisian Tegar OpenLog
Terdapat tiga lakaran disertakan yang boleh anda gunakan pada OpenLog, bergantung pada aplikasi tertentu anda.

  • OpenLog - Perisian tegar ini dihantar secara lalai pada OpenLog. Menghantar? Perintah akan menunjukkan versi perisian tegar yang dimuatkan pada unit.
  • OpenLog_Light - Versi lakaran ini mengalih keluar menu dan mod arahan, membolehkan penimbal terima ditingkatkan. Ini adalah pilihan yang baik untuk pembalakan berkelajuan tinggi.
  • OpenLog_Minimal – Kadar baud mesti ditetapkan dalam kod dan dimuat naik. Lakaran ini disyorkan untuk pengguna berpengalaman tetapi juga merupakan pilihan terbaik untuk pengelogan kelajuan tertinggi.

Set Perintah

Anda boleh antara muka dengan OpenLog melalui terminal bersiri. Perintah berikut akan membantu anda membaca, menulis dan memadam files, serta menukar tetapan OpenLog. Anda perlu berada dalam Mod Perintah untuk menggunakan tetapan berikut.

Semasa OpenLog berada dalam Mod Perintah , STAT1 akan menogol hidup/mati untuk setiap aksara yang diterima. LED akan kekal menyala sehingga aksara seterusnya diterima.

  • baru File – Mencipta yang baharu file bernama File dalam direktori semasa. Standard 8.3 filenama disokong. Untuk exampmaka, "87654321.123" boleh diterima, manakala "987654321.123" tidak.
    • Example: baru file1.txt
  • Lampirkan File – Tambahkan teks pada penghujung File. Data bersiri kemudiannya dibaca daripada UART dalam aliran dan ditambah pada file. Ia tidak bergema pada terminal bersiri. Sekiranya File tidak wujud apabila fungsi ini dipanggil, the file akan diwujudkan.
    • Example: tambah barufile.csv
  • tulis File OFFSET – Tulis teks ke File dari lokasi OFFSET dalam file. Teks dibaca dari UART, baris demi baris, dan bergema kembali. Untuk keluar dari keadaan ini, hantar baris kosong.
    • Example: tulis log.txt 516
  • rm File – Memadamkan File daripada direktori semasa. Kad bebas disokong.
    • Example: rm README.txt
  • saiz File – Saiz output daripada File dalam bait.
    • Example: saiz Log112.csv
    • Keluaran: 11
  • Baca File + START+ LENGTH TYPE – Output kandungan File bermula dari MULA dan berterusan untuk LENGTH. Jika START diabaikan, keseluruhannya file dilaporkan. Jika LENGTH ditinggalkan, keseluruhan kandungan dari titik permulaan dilaporkan. Jika TYPE diabaikan, OpenLog akan lalai kepada pelaporan dalam ASCII. Terdapat tiga JENIS keluaran:
    • ASCII = 1
    • HEX = 2
    • MENTAH = 3
  • Anda boleh meninggalkan beberapa hujah yang tertinggal. Semak contoh berikutamples.
  • Bacaan asas + bendera yang ditinggalkan:
    • Example: baca LOG00004.txt
    • Output: Accelerometer X=12 Y=215 Z=317
  • Baca dari permulaan 0 dengan panjang 5:
    • Example: baca LOG00004.txt 0 5
    • Keluaran: Accel
  • Baca dari kedudukan 1 dengan panjang 5 dalam HEX:
    • Example: baca LOG00004.txt 1 5 2
    • Keluaran: 63 63 65 6C
  • Baca dari kedudukan 0 dengan panjang 50 dalam RAW:
    • Example: baca LOG00137.txt 0 50 3
    • Output: André– -þ Ujian Watak Lanjutan
  • Kucing File – Tulis kandungan a file dalam hex ke monitor bersiri untuk viewing. Ini kadangkala membantu untuk melihat bahawa a file sedang merakam dengan betul tanpa perlu menarik kad SD dan view yang file di komputer.
    • Example: kucing LOG00004.txt
    • Output: 00000000: 41 63 65 6c 3a 20 31

Manipulasi Direktori

  • ls – Menyenaraikan semua kandungan direktori semasa. Kad bebas disokong.
    • Example: ls
    • Output: \src
  • md Subdirektori – Buat Subdirektori dalam direktori semasa.
    • Example: md Cthample_Lakaran
  • cd Subdirektori – Tukar kepada Subdirektori.
    • Example: cd Hello_World
  • cd .. – Tukar kepada direktori yang lebih rendah dalam pokok. Ambil perhatian bahawa terdapat ruang antara 'cd' dan '..'. Ini membolehkan penghurai rentetan melihat arahan CD.
    • Example: cd..
  • rm Subdirektori – Memadam Subdirektori. Direktori mesti kosong untuk arahan ini berfungsi.
    • Example: rm temps
  • Direktori rm -rf – Memadam Direktori dan mana-mana files terkandung di dalamnya.
    • Example: rm -rf Perpustakaan

Perintah Fungsi Aras Rendah

  • ? – Perintah ini akan mengeluarkan senarai arahan yang tersedia pada OpenLog.
  • Cakera – Tunjukkan ID pengeluar kad, nombor siri, tarikh pembuatan dan saiz kad. Cthampoutput ialah:
    • Jenis kad: SD2 ID Pengilang: 3
    • ID OEM: SD
    • Produk: SU01G
    • Versi: 8.0
    • Nombor siri: 39723042 Tarikh pembuatan: 1/2010 Saiz Kad: 965120 KB
  • init – Mulakan semula sistem dan buka semula kad SD. Ini berguna jika kad SD berhenti bertindak balas.
  • Sync – Menyegerakkan kandungan semasa penimbal ke kad SD. Perintah ini berguna jika anda mempunyai kurang daripada 512 aksara dalam penimbal dan ingin merakamnya pada kad SD.
  • Set Semula – Lompat OpenLog ke lokasi sifar, jalankan semula pemuat but, dan kemudian kod init. Perintah ini berguna jika anda perlu mengedit konfigurasi file, tetapkan semula OpenLog dan mula menggunakan konfigurasi baharu. Berbasikal kuasa masih merupakan kaedah pilihan untuk menetapkan semula papan, tetapi pilihan ini tersedia.

Tetapan Sistem

Tetapan ini boleh dikemas kini atau diedit secara manual dalam config.txt file.

  • Echo STATE – Mengubah keadaan sistem, dan disimpan dalam memori sistem. STATE boleh sama ada dihidupkan atau dimatikan. Semasa pada OpenLog akan bergema data bersiri yang diterima pada command prompt. Semasa dimatikan, sistem tidak membaca semula aksara yang diterima.

Nota: Semasa pengelogan biasa, gema akan dimatikan. Permintaan sumber sistem untuk menggemakan data yang diterima terlalu tinggi semasa pengelogan.

  • STATE Verbose – Mengubah keadaan pelaporan ralat verbose. STATE boleh sama ada dihidupkan atau dimatikan Perintah ini disimpan dalam ingatan. Dengan mematikan ralat verbose, OpenLog akan bertindak balas dengan hanya ! jika terdapat ralat, dan bukannya arahan yang tidak diketahui: C OMMAND.D..TThe hecharacterss lebih mudah untuk sistem terbenam untuk menghuraikan daripada ralat penuh. Jika anda menggunakan terminal, membiarkan verbose hidup akan membolehkan anda melihat mesej ralat penuh.
  • baud – Perintah ini akan membuka menu sistem yang membolehkan pengguna memasukkan kadar baud. Sebarang kadar baud antara 300bps dan 1Mbps disokong. Pemilihan kadar baud adalah serta-merta, dan OpenLog memerlukan kitaran kuasa untuk tetapan berkuat kuasa. Kadar baud disimpan ke EEPROM dan dimuatkan setiap kali OpenLog dihidupkan. Lalai ialah 9600 8N1 .

Ingat: Jika anda membuat papan tersekat dalam kadar baud yang tidak diketahui, anda boleh mengikat RX kepada GND dan menghidupkan OpenLog. LED akan berkelip ke depan dan ke belakang selama 2 saat dan kemudian akan berkelip serentak. Matikan OpenLog, dan keluarkan pelompat. OpenLog kini ditetapkan semula kepada 9600bps dengan aksara melarikan diri `CTRL-Z` ditekan tiga kali berturut-turut. Ciri ini boleh diganti dengan menetapkan bit Kecemasan Override kepada 1. Lihat config.txt untuk mendapatkan maklumat lanjut.

  • Set – Perintah ini membuka menu sistem untuk memilih mod but. Tetapan ini akan berlaku pada kuasa hidup seterusnya dan disimpan dalam EEPROM tidak meruap.
    • baru File Pembalakan – Mod ini mencipta mod baharu file setiap kali OpenLog berkuasa. OpenLog akan menghantar 1 (UART masih hidup), 2 (kad SD dimulakan), kemudian < (OpenLog bersedia untuk menerima data). Semua data akan direkodkan ke LOG#####.txt. Nombor ##### meningkat setiap kali OpenLog berkuasa (maksimum ialah 65533 log). Nombor tersebut disimpan dalam EEPROM dan boleh ditetapkan semula daripada menu yang ditetapkan. Tidak semua aksara yang diterima digemakan. Anda boleh keluar dari mod ini dan masuk ke mod arahan dengan menghantar CTRL+z (ASCII 26). Semua data buffer akan disimpan.
  • Nota: Jika terlalu banyak log telah dibuat, OpenLog akan mengeluarkan ralat **Terlalu banyak log**, keluar dari mod ini dan jatuh ke Prompt Perintah. Keluaran bersiri akan kelihatan seperti `12!Terlalu banyak log!
    • Lampirkan File Pembalakan – Juga dikenali sebagai mod berjujukan, mod ini mencipta a file dipanggil SEQLOG.txt jika ia belum ada, dan menambahkan sebarang data yang diterima pada file. OpenLog akan menghantar 12< pada masa OpenLog bersedia untuk menerima data. Watak tidak bergema. Anda boleh keluar dari mod ini dan masuk ke mod arahan dengan menghantar CTRL+z (ASCII 26). Semua data buffer akan disimpan.
    • Prompt Perintah – OpenLog akan menghantar 12> pada masa itu sistem bersedia untuk menerima arahan. Ambil perhatian bahawa tanda > menunjukkan OpenLog bersedia untuk menerima arahan, bukan data. Anda boleh mencipta files dan tambah data ke files, tetapi ini memerlukan beberapa penghuraian bersiri (untuk semakan ralat), jadi kami tidak menetapkan mod ini secara lalai.
    • Tetapkan semula Baharu File Nombor – Mod ini akan menetapkan semula log file nombor ke LOG000.txt . Ini berguna jika anda baru-baru ini mengosongkan kad microSD dan mahu log itu file nombor untuk bermula semula.
    • Watak Melarikan Diri Baharu – Pilihan ini membenarkan pengguna memasukkan aksara, seperti CTRL+z atau $, dan menetapkan ini sebagai aksara melarikan diri baharu. Tetapan ini ditetapkan semula kepada CTRL+z semasa tetapan semula kecemasan.
    • Bilangan Aksara Melarikan Diri – Pilihan ini membenarkan pengguna memasukkan aksara (seperti 1, 3, atau 17), mengemas kini bilangan aksara melarikan diri baharu yang diperlukan untuk diturunkan ke mod arahan. Untuk exampKemudian, memasukkan 8 akan memerlukan pengguna untuk menekan CTRL+z lapan kali untuk pergi ke mod arahan. Tetapan ini ditetapkan semula kepada 3 semasa tetapan semula kecemasan.
  • Escape Characters Penjelasan: Sebab OpenLog memerlukan `CTRL+z` hit sebanyak 3 kali untuk memasuki mod arahan adalah untuk mengelakkan papan daripada ditetapkan semula secara tidak sengaja semasa memuat naik kod baharu daripada Arduino IDE. Terdapat kemungkinan bahawa lembaga akan melihat watak `CTRL+z` muncul semasa pemuatan but (isu yang kami lihat dalam versi awal perisian tegar OpenLog), jadi ini bertujuan untuk mengelakkannya. Jika anda pernah mengesyaki papan anda telah rosak disebabkan ini, anda sentiasa boleh melakukan tetapan semula kecemasan dengan menahan pin RX ke tanah semasa kuasa dihidupkan.

Konfigurasi File

Jika anda lebih suka tidak menggunakan terminal bersiri untuk mengubah suai tetapan pada OpenLog anda, anda juga boleh mengemas kini tetapan dengan mengubah suai CONFIG.TXT file.

Nota: Ciri ini hanya berfungsi pada perisian tegar versi 1.6 atau lebih baru. Jika anda telah membeli OpenLog selepas 2012, anda akan menjalankan perisian tegar versi 1.6+

  • Untuk melakukan ini, anda memerlukan pembaca kad microSD dan penyunting teks. Buka config.txt file (huruf besar bagi file nama tidak penting), dan konfigurasi jauh! Jika anda tidak pernah menghidupkan OpenLog anda dengan kad SD sebelum ini, anda juga boleh membuat kad SD secara manual file. Jika anda telah menghidupkan OpenLog dengan kad microSD yang dimasukkan sebelum ini, anda akan melihat sesuatu seperti berikut apabila anda membaca kad microSD.SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-fig- (15)OpenLog mencipta config.txt dan LOG0000.txt file pada kuasa pertama.
  • Konfigurasi lalai file mempunyai satu baris tetapan dan satu baris definisi.SparkFun-DEV-13712-Particle-Photon-With-Holes-For-Soldering-fig- (16)Konfigurasi lalai file telah ditulis oleh OpenLog.
  • Ambil perhatian bahawa ini ialah aksara biasa yang boleh dilihat (tiada nilai tidak kelihatan atau binari), dan setiap nilai dipisahkan dengan koma.

Tetapan ditakrifkan seperti berikut:

  • baud : Kadar baud komunikasi. 9600 bps adalah lalai. Nilai yang boleh diterima yang serasi dengan Arduino IDE ialah 2400, 4800, 9600, 19200, 38400, 57600 dan 115200. Anda boleh menggunakan kadar baud lain, tetapi anda tidak akan dapat berkomunikasi dengan OpenLog melalui monitor bersiri Arduino IDE.
  • Escap:e Nilai ASCII (dalam format perpuluhan) bagi aksara melarikan diri. 26 ialah CTRL+z dan merupakan lalai. 36 ialah $ dan merupakan watak melarikan diri yang biasa digunakan.
  • Esc #: Bilangan aksara melarikan diri yang diperlukan. Secara lalai, ia adalah tiga, jadi anda mesti menekan watak melarikan diri tiga kali untuk turun ke mod arahan. Nilai yang boleh diterima adalah dari 0 hingga 254. Menetapkan nilai ini kepada 0 akan melumpuhkan semakan aksara melarikan diri sepenuhnya.
  • Mod Mod sistem. OpenLog bermula dalam mod Log Baharu( 0 ) secara lalai. Nilai yang boleh diterima ialah 0 =Log Baharu, 1 = Log Berjujukan, 2 = Mod Perintah.
  • Kata kerja: Mod verbose. Mesej ralat lanjutan (verbose) dihidupkan secara lalai. Menetapkan ini kepada 1 menghidupkan mesej ralat verbose (seperti arahan yang tidak diketahui: alih keluar ! ). Menetapkan ini kepada 0 mematikan ralat verbose, tetapi akan bertindak balas dengan ! jika ada kesilapan. Mematikan mod verbose adalah berguna jika anda cuba menangani ralat daripada sistem terbenam.
  • Gema: Mod gema. Semasa dalam mod arahan, aksara digemakan secara lalai. Menetapkan ini kepada 0 mematikan gema aksara. Mematikan ini adalah berguna jika mengendalikan ralat, dan anda tidak mahu arahan dihantar digema kembali ke OpenLog.II
  • iignoreRXEmergency Override. Biasanya, OpenLog akan tetapan semula kecemasan apabila pin RX ditarik rendah semasa kuasa dinaikkan. Menetapkan ini kepada 1 akan melumpuhkan pemeriksaan pin RX semasa kuasa dihidupkan. Ini boleh membantu untuk sistem yang akan mengekalkan garisan RX rendah atas pelbagai sebab. Jika Kecemasan Override dilumpuhkan, anda tidak akan dapat memaksa unit kembali kepada 9600bps, dan konfigurasi file akan menjadi satu-satunya cara untuk mengubah suai kadar baud.

Cara OpenLog Mengubah Konfigurasi File
Terdapat lima situasi berbeza untuk OpenLog mengubah suai config.txt file.

  • Konfigurasi file dijumpai: Semasa kuasa naik, OpenLog akan mencari config.txt file. Sekiranya file ditemui, OpenLog akan menggunakan tetapan yang disertakan dan menulis ganti sebarang tetapan sistem yang disimpan sebelum ini.
  • Tiada konfigurasi file dijumpai: Jika OpenLog tidak dapat mencari config.txt file maka OpenLog akan mencipta config.txt dan merekodkan tetapan sistem yang sedang disimpan kepadanya. Ini bermakna jika anda memasukkan kad microSD yang baru diformat, sistem anda akan mengekalkan tetapan semasanya.
  • Konfigurasi rosak file dijumpai: OpenLog akan memadam config.txt yang rosak file, dan akan menulis semula kedua-dua tetapan EEPROM dalaman dan tetapan config.txt file kepada keadaan yang diketahui baik iaitu 9600,26,3,0,1,1,0.
  • Nilai tidak sah dalam konfigurasi file: Jika OpenLog menemui sebarang tetapan yang mengandungi nilai haram, OpenLog akan menimpa nilai yang rosak dalam config.txt file dengan tetapan sistem EEPROM yang disimpan pada masa ini.
  • Perubahan melalui gesaan arahan: Jika tetapan sistem ditukar melalui gesaan arahan (sama ada melalui sambungan bersiri atau melalui arahan bersiri mikropengawal) perubahan tersebut akan direkodkan ke EEPROM sistem dan ke config.txt file.
  • Tetapan Semula Kecemasan: Jika OpenLog dikitar kuasa dengan pelompat antara RX dan GND, dan bit Kecemasan Override ditetapkan kepada 0 (membenarkan tetapan semula kecemasan), OpenLog akan menulis semula kedua-dua tetapan EEPROM dalaman dan tetapan config.txt file kepada keadaan baik yang diketahui 9600,26,3,0,1,1,0 .

Menyelesaikan masalah

Terdapat beberapa pilihan yang berbeza untuk menyemak sama ada anda menghadapi masalah menyambung melalui monitor bersiri, menghadapi masalah dengan aksara yang tercicir dalam log, atau melawan OpenLog yang rosak.

Semak Gelagat LED STAT1
LED STAT1 menunjukkan tingkah laku yang berbeza untuk dua ralat biasa yang berbeza.

  • 3 Berkelip: Kad microSD gagal dimulakan. Anda mungkin perlu memformat kad dengan FAT/FAT16 pada komputer.
  • 5 Berkelip: OpenLog telah bertukar kepada kadar baud baharu dan perlu dikitar kuasa.

Semak Dua Kali Struktur Subdirektori

  • Jika anda menggunakan OpenLog.ino lalai exampOleh itu, OpenLog hanya akan menyokong dua subdirektori. Anda perlu menukar FOLDER_TRACK_DEPTH daripada 2 kepada bilangan subdirektori yang anda perlukan untuk menyokong. Setelah anda melakukan ini, susun semula kod dan muat naik perisian tegar yang diubah suai.
  • Sahkan Bilangan Files dalam Direktori Akar
  • OpenLog hanya akan menyokong sehingga 65,534 log files dalam direktori akar. Kami mengesyorkan anda memformat semula kad microSD anda untuk meningkatkan kelajuan pengelogan.
  • Sahkan Saiz Perisian Tegar Ubah Suai anda
  • Jika anda menulis lakaran tersuai untuk OpenLog, sahkan bahawa lakaran anda tidak lebih besar daripada 32,256. Jika ya, ia akan memotong ke 500 bait atas memori Flash, yang digunakan oleh pemuat but bersiri Optiboot.
  • Semakan Berganda File Nama
  • Semua file nama hendaklah alfa-numerik. MyLOG1.txt ok, tetapi Hai !e _ .txtt mungkin tidak berfungsi.
  • Gunakan 9600 Baud
  • OpenLog menjalankan ATmega328 dan mempunyai jumlah RAM yang terhad (2048 bait). Apabila anda menghantar aksara bersiri ke OpenLog, aksara ini mendapat penimbal. Spesifikasi Dipermudahkan Kumpulan SD membenarkan kad SD mengambil masa sehingga 250ms (bahagian 4.6.2.2 Tulis) untuk merekodkan blok data kepada memori kilat.
  • Pada 9600bps, itu 960 bait (10 bit per bait) sesaat. Iaitu 1.04ms setiap bait. OpenLog pada masa ini menggunakan penimbal terima 512 bait supaya ia boleh menampan sekitar 50ms aksara. Ini membolehkan OpenLog berjaya menerima semua aksara yang datang pada 9600bps. Apabila anda meningkatkan kadar baud, penimbal akan bertahan untuk masa yang lebih singkat.

Masa Overrun Penampan OpenLog

Kadar Baud Masa setiap bait Masa Sehingga Penampan Ditakluki
9600bps 1.04ms 532ms
57600bps 0.174ms 88ms
115200bps 0.087ms 44ms

Banyak kad SD mempunyai masa rekod yang lebih pantas daripada 250ms. Ini boleh dipengaruhi oleh 'kelas' kad dan jumlah data yang telah disimpan pada kad. Penyelesaiannya adalah dengan menggunakan kadar baud yang lebih rendah atau meningkatkan jumlah masa antara aksara yang dihantar pada kadar baud yang lebih tinggi.

Formatkan Kad MicroSD anda
Ingat untuk menggunakan kad dengan sedikit atau tidak files di atasnya. Kad microSD dengan ZIP bernilai 3.1GB files atau MP3 mempunyai masa tindak balas yang lebih perlahan daripada kad kosong. Jika anda tidak memformat kad microSD anda pada OS Windows, format semula kad microSD dan buat DOS filesistem pada kad SD.
Tukar Kad MicroSD
Terdapat pelbagai jenis pengeluar kad, kad yang dilabel semula, saiz kad dan kelas kad, dan mereka mungkin tidak semuanya berfungsi dengan betul. Kami biasanya menggunakan kad microSD kelas 8 4GB, yang berfungsi dengan baik pada 9600bps. Jika anda memerlukan kadar baud yang lebih tinggi atau ruang storan yang lebih besar, anda mungkin ingin mencuba kad kelas 6 atau lebih tinggi.
Tambah Kelewatan Antara Tulisan Aksara
Dengan menambahkan kelewatan kecil antara pernyataan Serial.print(), anda boleh memberi OpenLog peluang untuk merekodkan penimbal semasanya.
Untuk example:
  • Serial.begin(115200);
    for(int i = 1 ; i < 10 ; i++) { Serial.print(i, DEC); Serial.println(“:abcdefghijklmnopqrstuvwxyz-!#”); }

mungkin tidak log dengan betul, kerana terdapat banyak aksara dihantar bersebelahan antara satu sama lain. Memasukkan kelewatan kecil 15ms antara penulisan aksara besar akan membantu OpenLog merekod tanpa menjatuhkan aksara.

  • Serial.begin(115200);
    for(int i = 1 ; i < 10 ; i++) { Serial.print(i, DEC); Serial.println(“:abcdefghijklmnopqrstuvwxyz-!#”); kelewatan(15); }

Tambah Keserasian Monitor Bersiri Arduino

Jika anda cuba menggunakan OpenLog dengan perpustakaan bersiri terbina dalam atau perpustakaan SoftwareSerial, anda mungkin melihat masalah dengan mod arahan. Serial.println() menghantar kedua-dua baris baharu DAN pemulangan pengangkutan. Terdapat dua arahan alternatif untuk mengatasi ini.

Yang pertama ialah menggunakan perintah \r (pemulangan kereta ASCII):
Serial.print("TEKS\r");

Sebagai alternatif, anda boleh menghantar nilai 13 (pulangan pengangkutan perpuluhan):

  • Serial.print("TEKS");
  • Serial.write(13);

Tetapan Semula Kecemasan

Ingat, jika anda perlu menetapkan semula OpenLog kepada keadaan lalai, anda boleh menetapkan semula papan dengan mengikat pin RX ke GND, menghidupkan OpenLog, menunggu sehingga LED mula berkelip serentak, dan kemudian mematikan OpenLog dan mengeluarkan pelompat.
Jika anda telah menukar bit Emergency Override kepada 1, anda perlu mengubah suai konfigurasi file, kerana Tetapan Semula Kecemasan tidak akan berfungsi.

Semak dengan Komuniti

Jika anda masih menghadapi masalah dengan OpenLog anda, sila semak isu semasa dan tertutup pada repositori GitHub kami di sini. Terdapat komuniti besar yang bekerja dengan OpenLog, jadi kemungkinan besar seseorang telah menemui penyelesaian untuk masalah yang anda lihat.

Sumber dan Melangkah Lebih Jauh

Memandangkan anda telah berjaya melog data dengan OpenLog anda, anda boleh menyediakan projek jauh dan memantau semua kemungkinan data yang datang. Pertimbangkan untuk mencipta projek Sains Warganegara anda sendiri, atau bahkan penjejak haiwan peliharaan untuk melihat apa yang Fluffy lakukan apabila keluar dan sekitar!
Lihat sumber tambahan ini untuk menyelesaikan masalah, bantuan atau inspirasi untuk projek anda yang seterusnya.

  • OpenLog GitHub
  • Projek Illumitune
  • Sambungan Penderia Cahaya LilyPad
  • BadgerHack: Alat tambah Sensor Tanah
  • Bermula dengan OBD-II
  • Vernier Photogate

Perlukan lebih banyak inspirasi? Lihat beberapa tutorial berkaitan ini:

  • Sensor Paras Air Jauh Foton
    Ketahui cara membina penderia paras air jauh untuk tangki simpanan air dan cara mengautomasikan pam berdasarkan bacaan!
  • Panduan Projek Blynk Board
    Satu siri projek Blynk yang boleh anda sediakan pada Blynk Board tanpa memprogramkannya semula.
  • Mengelog Data ke Helaian Google dengan Tessel 2
    Projek ini merangkumi cara log data ke Helaian Google dua cara: menggunakan IFTTT dengan a web sambungan atau pemacu pen USB dan "sneakernet" tanpa.
  • Data Penderia Graf dengan Python dan Matplotlib
    Gunakan matplotlib untuk mencipta plot masa nyata data suhu yang dikumpul daripada sensor TMP102 yang disambungkan ke Raspberry Pi.

Jika anda mempunyai sebarang maklum balas tutorial, sila lawati ulasan atau hubungi pasukan sokongan teknikal kami di TechSupport@sparkfun.com.

Soalan Lazim

Apakah input kuasa yang disyorkan untuk OpenLog?

Input kuasa yang disyorkan untuk OpenLog adalah antara 3.3V hingga 5V.

Berapakah arus yang diperoleh OpenLog apabila melahu?

OpenLog menarik kira-kira 2mA hingga 5mA apabila melahu tanpa kad mikroSD, dan sekitar 5mA hingga 6mA apabila kad mikroSD dimasukkan.

Apakah tujuan Reaaboutn USB microSD kepada OpenLog?

Pembaca USB microSD membolehkan pemindahan data dengan mudah daripada kad microSD yang digunakan dengan OpenLog ke komputer.

Dokumen / Sumber

SparkFun DEV-13712 Foton Zarah Dengan Lubang Untuk Memateri [pdf] Panduan Pengguna
DEV-13712, DEV-13955, DEV-13712 Foton Zarah Dengan Lubang Untuk Memateri, DEV-13712, Foton Zarah Dengan Lubang Untuk Memateri, Lubang Untuk Memateri, Untuk Memateri, Memateri

Rujukan

Tinggalkan komen

Alamat e-mel anda tidak akan diterbitkan. Medan yang diperlukan ditanda *