Spesifikasi

• Nama Produk: Pencatat Data OpenLog
• Model: DEV-13712
• Daya Masukan: 3.3V-12V (Direkomendasikan 3.3V-5V)
• Masukan RXI Voltage: 2.0V-3.8V
• Keluaran TXO Voltage: 3.3V
• Pengambilan Arus Idle: ~2mA-5mA (tanpa kartu microSD), ~5mA-6mA (dengan kartu microSD)
• Pengambilan Arus Penulisan Aktif: ~20-23mA (dengan kartu microSD)

Petunjuk Penggunaan Produk

Bahan yang dibutuhkan:

• Arduino Pro Mini 328 – 3.3V/8MHz
• SparkFun FTDI Dasar Breakout – 3.3V
• Kabel USB Cerberus SparkFun – 6 kaki
• Kartu microSD dengan Adaptor – 16GB (Kelas 10)
• Pembaca USB microSD
• Header Wanita
• Kabel Jumper Premium 6 M/M Paket isi 10
• Header Pria Break Away – Sudut Kanan

Bacaan yang Direkomendasikan:

• Cara Menyolder: Penyolderan Melalui Lubang
• Dasar-dasar Komunikasi Serial
• Antarmuka Periferal Serial (SPI)
• Dasar-dasar Terminal Serial

Perangkat Keras Berakhirview:
OpenLog berjalan pada pengaturan berikut:

Perkenalan

Perhatian! Tutorial ini ditujukan untuk Open Log untuk serial UART [DEV-13712]. Jika Anda menggunakan Qwiic OpenLog untuk IC [DEV-15164], silakan lihat Panduan Penyambungan Qwiic OpenLog.

OpenLog Data Logger adalah solusi sumber terbuka yang mudah digunakan untuk mencatat data serial dari proyek Anda. OpenLog menyediakan antarmuka serial sederhana untuk mencatat data dari proyek ke kartu microSD.

SparkFun Buka Log
PENGEMBANGAN-13712

SparkFun OpenLog dengan Header
PENGEMBANGAN-13955

Tidak ada produk yang ditemukan

Bahan yang dibutuhkan
Untuk dapat mengikuti tutorial ini secara lengkap, Anda memerlukan komponen berikut. Namun, Anda mungkin tidak memerlukan semuanya, tergantung pada apa yang Anda miliki. Tambahkan komponen tersebut ke keranjang belanja Anda, baca panduannya, dan sesuaikan keranjang belanja sesuai kebutuhan.

Panduan Koneksi OpenLog

Daftar Keinginan SparkFun

Bacaan yang Direkomendasikan
Jika Anda kurang familier atau kurang nyaman dengan konsep berikut, kami sarankan Anda membaca terlebih dahulu sebelum melanjutkan ke Panduan Sambungan OpenLog.

• Cara Menyolder: Penyolderan Lubang-Tembus. Tutorial ini mencakup semua yang perlu Anda ketahui tentang penyolderan lubang-tembus.
• Komunikasi Serial Konsep komunikasi serial asinkron: paket, level sinyal, laju baud, UART, dan banyak lagi!
• Antarmuka Periferal Serial (SPI) SPI umumnya digunakan untuk menghubungkan mikrokontroler ke periferal seperti sensor, register geser, dan kartu SD.
• Dasar-dasar Terminal Serial Tutorial ini akan menunjukkan kepada Anda cara berkomunikasi dengan perangkat serial Anda menggunakan berbagai aplikasi emulator terminal.

Perangkat Keras Berakhirview

Kekuatan
OpenLog berjalan pada pengaturan berikut:

Peringkat Daya OpenLog

Arus yang ditarik OpenLog sekitar 20mA hingga 23mA saat menulis ke microSD. Bergantung pada ukuran kartu microSD dan produsennya, arus aktif yang ditarik dapat bervariasi saat OpenLog menulis ke kartu memori. Meningkatkan baud rate juga akan menarik lebih banyak arus.

Mikrokontroler
OpenLog berjalan pada ATmega328 onboard, yang berjalan pada 16MHz, berkat kristal onboard. ATmega328 memiliki bootloader Optiboot yang dimuat di dalamnya, yang memungkinkan OpenLog kompatibel dengan
Pengaturan papan “Arduino Uno” di Arduino IDE.

Antarmuka

Serial UART
Antarmuka utama dengan OpenLog adalah header FTDI di tepi papan. Header ini dirancang untuk disambungkan langsung ke Arduino Pro atau Pro Mini, yang memungkinkan mikrokontroler mengirimkan data melalui koneksi serial ke OpenLog.

Peringatan! Karena urutan pin yang membuatnya kompatibel dengan Arduino, ia tidak dapat dicolokkan langsung ke papan breakout FTDI.

Untuk informasi lebih lanjut, pastikan untuk memeriksa bagian berikutnya pada Penyambungan Perangkat Keras.

SPI

Ada juga empat titik uji SPI yang dibagi di ujung papan yang berlawanan. Anda dapat menggunakannya untuk memprogram ulang bootloader pada ATmega328.

• OpenLog terbaru (DEV-13712) membagi pin-pin ini pada lubang-lubang kecil yang dilapisi pelat. Jika Anda perlu menggunakan ISP untuk memprogram ulang atau mengunggah bootloader baru ke OpenLog, Anda dapat menggunakan pin pogo untuk terhubung ke titik-titik uji ini.
• Antarmuka terakhir untuk berkomunikasi dengan OpenLog adalah kartu microSD itu sendiri. Untuk berkomunikasi, kartu microSD memerlukan pin SPI. Bukan hanya di sinilah data disimpan oleh OpenLog, tetapi Anda juga dapat memperbarui konfigurasi OpenLog melalui config.txt file pada kartu microSD.
  Kartu microSD

Semua data yang dicatat oleh OpenLog disimpan di kartu microSD. OpenLog bekerja dengan kartu microSD yang memiliki fitur berikut:

• 64MB hingga 32GB
• FAT16 atau FAT32

Ada dua LED status pada OpenLog untuk membantu Anda memecahkan masalah.

• STAT1 – LED indikator biru ini terpasang pada Arduino D5 (ATmega328 PD5) dan menyala/mati saat karakter baru diterima. LED ini berkedip saat komunikasi Serial berfungsi.
• STAT2 – LED hijau ini terhubung ke Arduino D13 (SPI Serial Clock Line/ ATmega328 PB5). LED ini hanya berkedip saat antarmuka SPI aktif. Anda akan melihatnya berkedip saat OpenLog merekam 512 byte ke kartu microSD.

Sambungan Perangkat Keras

Ada dua metode utama untuk menghubungkan OpenLog ke sirkuit. Anda akan memerlukan beberapa header atau kabel untuk menghubungkannya. Pastikan Anda menyolder ke papan untuk koneksi yang aman.

Koneksi Serial Dasar

Tip:Jika Anda memiliki header perempuan pada OpenLog dan header perempuan pada FTDI, Anda akan memerlukan kabel jumper M/F untuk menghubungkannya.

Sambungan perangkat keras ini dirancang untuk berinteraksi dengan OpenLog jika Anda perlu memprogram ulang papan atau mencatat data melalui sambungan serial dasar.

Buat koneksi berikut:
OpenLog → Breakout Dasar FTDI 3.3V

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

Perhatikan bahwa ini bukanlah koneksi langsung antara FTDI dan OpenLog – Anda harus mengganti koneksi pin TXO dan RXI.

Koneksi Anda akan terlihat seperti berikut:

Setelah Anda memiliki koneksi antara OpenLog dan FTDI Basic, hubungkan papan FTDI Anda ke kabel USB dan komputer Anda. Buka terminal serial, hubungkan ke port COM FTDI Basic Anda, dan mulailah!

Koneksi Perangkat Keras Proyek

Tip: Jika Anda telah menyolder header perempuan pada OpenLog, Anda dapat menyolder header laki-laki ke Arduino Pro Mini untuk menyambungkan papan-papan tersebut tanpa memerlukan kabel.

Meskipun berinteraksi dengan OpenLog melalui koneksi serial penting untuk pemrograman ulang atau debugging, OpenLog paling unggul dalam proyek tertanam. Rangkaian umum ini adalah cara yang kami sarankan untuk menghubungkan OpenLog ke mikrokontroler (dalam hal ini, Arduino Pro Mini) yang akan menulis data serial ke OpenLog.

Pertama, Anda perlu mengunggah kode ke Pro Mini yang ingin Anda jalankan. Silakan periksa Sketsa Arduino untuk beberapa contohampkode yang dapat Anda gunakan.

Catatan: Jika Anda tidak yakin cara memprogram Pro Mini, lihat tutorial kami di sini.

Menggunakan Arduino Pro Mini 3.3V

• Tutorial ini adalah panduan Anda untuk semua hal tentang Arduino Pro Mini. Tutorial ini menjelaskan apa itu Arduino Pro Mini, apa yang bukan, dan cara memulai menggunakannya.
• Setelah Anda memprogram Pro Mini, Anda dapat melepas papan FTDI dan menggantinya dengan OpenLog. Pastikan untuk menghubungkan pin berlabel BLK pada Pro Mini dan OpenLog (pin berlabel GRN pada keduanya juga akan cocok jika dilakukan dengan benar).
• Jika Anda tidak dapat mencolokkan OpenLog langsung ke Pro Mini (karena header yang tidak cocok atau papan lain yang menghalangi), Anda dapat menggunakan kabel jumper dan membuat sambungan berikut.

OpenLog → Arduino Pro/Arduino Pro Mini

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

Setelah selesai, koneksi Anda akan terlihat seperti berikut dengan Arduino Pro Mini dan Arduino Pro. Diagram Fritzing menunjukkan OpenLogs dengan header yang dicerminkan. Jika Anda membalik soket microSD relatif terhadap bagian atas Arduino view, mereka harus mencocokkan header pemrograman seperti FTDI.

Perlu diperhatikan bahwa koneksinya adalah langsung dengan OpenLog “terbalik” (dengan microSD menghadap ke atas).

Catatan: Karena Vcc dan GND antara OpenLog dan Arduino ditempati oleh header, Anda perlu menyambungkan daya ke pin lain yang tersedia di Arduino. Jika tidak, Anda dapat menyolder kabel ke pin daya yang terbuka di kedua papan.

Nyalakan sistem Anda, dan Anda siap untuk mulai mencatat!

Sketsa Arduino

Ada enam ex yang berbedaampSketsa yang disertakan dapat Anda gunakan pada Arduino saat terhubung ke OpenLog.

• OpenLog_Benchmarking — Ini example digunakan untuk menguji OpenLog. Ini mengirimkan sejumlah besar data pada 115200bps melalui beberapa files.
• OpenLog_CommandTest — Contoh iniample menunjukkan cara membuat dan menambahkan file melalui kontrol baris perintah melalui Arduino.
• OpenLog_BacaExample — Mantan iniample menjelaskan cara mengendalikan OpenLog melalui baris perintah.
• OpenLog_BacaExample_BesarFile - Mantanampcara membuka file yang tersimpan dalam jumlah besar file di OpenLog dan melaporkannya melalui koneksi Bluetooth lokal.
• OpenLog_Test_Sketch — Digunakan untuk menguji OpenLog dengan banyak data serial.
• OpenLog_Test_Sketch_Binary — Digunakan untuk menguji OpenLog dengan data biner dan karakter escape.

Perangkat Lunak

OpenLog memiliki dua perangkat lunak utama: bootloader dan firmware.

Bootloader Arduino

Catatan: Jika Anda menggunakan OpenLog yang dibeli sebelum Maret 2012, bootloader onboard kompatibel dengan pengaturan “Arduino Pro atau Pro Mini 5V/16MHz dengan ATmega328” di Arduino IDE.

• Seperti yang disebutkan sebelumnya, OpenLog memiliki bootloader serial Optiboot. Anda dapat memperlakukan OpenLog seperti Arduino Uno saat mengunggah file exampkode atau firmware baru ke papan.
• Jika Anda akhirnya merusak OpenLog dan perlu menginstal ulang bootloader, Anda juga perlu mengunggah Optiboot ke papan. Silakan lihat tutorial kami tentang menginstal Arduino Bootloader untuk informasi lebih lanjut.

Mengkompilasi dan Memuat Firmware ke OpenLog

Catatan: Jika ini adalah pertama kalinya Anda menggunakan Arduino, silakan bacaview tutorial kami tentang cara memasang Arduino IDE. Jika Anda belum pernah memasang pustaka Arduino, silakan lihat panduan pemasangan kami untuk memasang pustaka secara manual.

• Jika karena alasan apa pun Anda perlu memperbarui atau menginstal ulang firmware pada OpenLog Anda, proses berikut akan membuat papan Anda aktif dan berjalan.
• Pertama, silakan unduh Arduino IDE v1.6.5. Versi IDE lainnya mungkin dapat digunakan untuk mengkompilasi firmware OpenLog, tetapi kami telah memverifikasi bahwa ini adalah versi yang dikenal baik.
• Berikutnya, unduh firmware OpenLog dan bundel pustaka yang diperlukan.

UNDUH BUNDEL FIRMWARE OPENLOG (ZIP)

• Setelah Anda mengunduh pustaka dan firmware, instal pustaka tersebut ke Arduino. Jika Anda tidak yakin cara menginstal pustaka secara manual di IDE, silakan lihat tutorial kami: Menginstal Pustaka Arduino: Menginstal Pustaka Secara Manual.

Catatan:

• Kami menggunakan versi modifikasi dari pustaka SdFat dan SerialPort untuk menentukan secara acak seberapa besar buffer TX dan RX. OpenLog mengharuskan buffer TX sangat kecil (0), dan buffer RX harus sebesar mungkin.
• Menggunakan kedua pustaka yang dimodifikasi ini bersama-sama memungkinkan peningkatan kinerja OpenLog.

Mencari Versi Terbaru?
Jika Anda lebih suka versi pustaka dan firmware terbaru, Anda dapat mengunduhnya langsung dari repositori GitHub yang ditautkan di bawah ini. Pustaka SdFatLib dan Serial Port tidak terlihat di pengelola papan Arduino sehingga Anda perlu menginstal pustaka tersebut secara manual.

• GitHub: OpenLog > Firmware > OpenLog_Firmware
• Perpustakaan Arduino milik Bill Greiman
  • SdFatLib-beta
  • Port Serial
• Selanjutnya, untuk mengambil keuntungantage dari perpustakaan yang dimodifikasi, memodifikasi SerialPort.hh file ditemukan di direktori \Arduino\Libraries\SerialPort. Ubah BUFFERED_TX menjadi 0 dan ENABLE_RX_ERROR_CHECKING menjadi 0. Simpan file, dan buka Arduino IDE.
• Jika belum, hubungkan OpenLog Anda ke komputer melalui papan FTDI. Harap periksa kembaliample circuit jika Anda tidak yakin cara melakukannya dengan benar.
• Buka sketsa OpenLog yang ingin Anda unggah pada menu Alat>Papan, pilih “Arduino/Genuino Uno”, dan pilih port COM yang tepat untuk papan FTDI Anda pada Alat>Port.
• Unggah kodenya.
• Selesai! OpenLog Anda sekarang diprogram dengan firmware baru. Anda sekarang dapat membuka monitor serial dan berinteraksi dengan OpenLog. Saat dinyalakan, Anda akan melihat 12> atau 12<. 1 menunjukkan koneksi serial telah dibuat, 2 menunjukkan kartu SD telah berhasil diinisialisasi, < menunjukkan OpenLog siap untuk mencatat data serial yang diterima, dan > menunjukkan OpenLog siap untuk menerima perintah.

Sketsa Firmware OpenLog
Ada tiga sketsa disertakan yang dapat Anda gunakan pada OpenLog, tergantung pada aplikasi khusus Anda.

• OpenLog – Firmware ini dikirimkan secara default pada OpenLog. Mengirim perintah ? akan menampilkan versi firmware yang dimuat pada unit.
• OpenLog_Light – Versi sketsa ini menghapus menu dan mode perintah, sehingga buffer penerimaan dapat ditingkatkan. Ini adalah opsi yang bagus untuk pencatatan berkecepatan tinggi.
• OpenLog_Minimal – Kecepatan baud harus ditetapkan dalam kode dan diunggah. Sketsa ini direkomendasikan untuk pengguna berpengalaman tetapi juga merupakan pilihan terbaik untuk pencatatan kecepatan tertinggi.

Set Perintah

Anda dapat berinteraksi dengan OpenLog melalui terminal serial. Perintah berikut akan membantu Anda membaca, menulis, dan menghapus files, serta mengubah pengaturan OpenLog. Anda harus berada dalam Mode Perintah untuk menggunakan pengaturan berikut.

Saat OpenLog dalam Mode Perintah, STAT1 akan menyala/mati untuk setiap karakter yang diterima. LED akan tetap menyala hingga karakter berikutnya diterima.

• Baru File – Membuat yang baru file bernama File di direktori saat ini. Standar 8.3 filenama didukung. Misalnyaample, “87654321.123” dapat diterima, sedangkan “987654321.123” tidak.
  • Example: baru file1.txt
• Menambahkan File – Tambahkan teks ke akhir FileData serial kemudian dibaca dari UART dalam aliran dan ditambahkan ke file. Itu tidak bergema melalui terminal serial. Jika File tidak ada saat fungsi ini dipanggil, file akan dibuat.
  • Example: tambahkan yang barufile.csv
• Menulis File OFFSET – Tulis teks ke File dari lokasi OFFSET dalam file. Teks dibaca dari UART, baris demi baris, dan digemakan kembali. Untuk keluar dari status ini, kirim baris kosong.
  • Example: tulis logs.txt 516
• rm File – Menghapus File dari direktori saat ini. Karakter pengganti didukung.
  • Exampfile: rm README.txt
• ukuran File – Ukuran keluaran File dalam byte.
  • Example: ukuran Log112.csv
  • Keluaran: 11
• Membaca File + START+ LENGTH TYPE – Keluarkan konten File dimulai dari START dan menuju LENGTH. Jika START dihilangkan, seluruh file dilaporkan. Jika LENGTH dihilangkan, seluruh konten dari titik awal dilaporkan. Jika TYPE dihilangkan, OpenLog akan secara default melaporkan dalam ASCII. Ada tiga TYPE keluaran:
  • Kode ASCII = 1
  • Heksadesimal = 2
  • MENTAH = 3
• Anda dapat menghilangkan beberapa argumen tambahan. Periksa contoh berikutampsedikit.
• Pembacaan dasar + bendera yang dihilangkan:
  • Example: baca LOG00004.txt
  • Keluaran: Akselerometer X=12 Y=215 Z=317
• Dibaca dari awal 0 dengan panjang 5:
  • Example: baca LOG00004.txt 0 5
  • Keluaran: Akselerasi
• Baca dari posisi 1 dengan panjang 5 dalam HEX:
  • Example: baca LOG00004.txt 1 5 2
  • Keluaran: 63 63 65 6C
• Dibaca dari posisi 0 dengan panjang 50 dalam RAW:
  • Example: baca LOG00137.txt 0 50 3
  • Keluaran: André– -þ Uji Karakter Lanjutan
• Kucing File – Tuliskan isi dari sebuah file dalam hex ke monitor serial untuk viewHal ini terkadang membantu untuk melihat bahwa file merekam dengan benar tanpa harus mencabut kartu SD dan view itu file di komputer.
  • Exampfile: kucing LOG00004.txt
  • Keluaran: 00000000: 41 63 65 6c 3a 20 31

Manipulasi Direktori

• ls – Mencantumkan semua isi direktori saat ini. Karakter pengganti didukung.
  • Exampsaya: ls
  • Keluaran: \src
• md Subdirektori – Membuat Subdirektori di direktori saat ini.
  • Example: md Mantanample_Sketsa
• cd Subdirektori – Ubah ke Subdirektori.
  • Example: cd Halo_Dunia
• cd .. – Beralih ke direktori yang lebih rendah di pohon. Perhatikan bahwa ada spasi antara 'cd' dan '..'. Ini memungkinkan pengurai string untuk melihat perintah CD.
  • Exampfile: cd..
• rm Subdirectory – Menghapus Subdirektori. Direktori harus kosong agar perintah ini dapat berfungsi.
  • Example: suhu kamar
• rm -rf Direktori – Menghapus Direktori dan semua fileyang terkandung di dalamnya.
  • Example: rm -rf Perpustakaan

Perintah Fungsi Tingkat Rendah

• ? – Perintah ini akan menampilkan daftar perintah yang tersedia di OpenLog.
• Disk – Menampilkan ID produsen kartu, nomor seri, tanggal pembuatan, dan ukuran kartu.ampOutputnya adalah:
  • Jenis kartu: SD2 ID Pabrikan: 3
  • ID OEM: SD
  • Produk: SU01G
  • Versi: 8.0
  • Nomor seri: 39723042 Tanggal pembuatan: 1/2010 Ukuran Kartu: 965120 KB
• init – Menginisialisasi ulang sistem dan membuka kembali kartu SD. Ini berguna jika kartu SD berhenti merespons.
• Sinkronisasi – Menyinkronkan konten buffer saat ini ke kartu SD. Perintah ini berguna jika Anda memiliki kurang dari 512 karakter di buffer dan ingin merekamnya di kartu SD.
• Reset – Melompati OpenLog ke lokasi nol, menjalankan kembali bootloader, dan kemudian kode init. Perintah ini berguna jika Anda perlu mengedit konfigurasi file, atur ulang OpenLog, dan mulai gunakan konfigurasi baru. Pengaktifan daya berulang masih merupakan metode yang lebih disukai untuk mengatur ulang papan, tetapi opsi ini tersedia.

Pengaturan Sistem

Pengaturan ini dapat diperbarui atau diedit secara manual di config.txt file.

• Echo STATE – Mengubah status sistem, dan disimpan dalam memori sistem. STATE dapat aktif atau nonaktif. Saat aktif, OpenLog akan menggemakan data serial yang diterima pada prompt perintah. Saat nonaktif, sistem tidak membaca kembali karakter yang diterima.

Catatan: Selama pencatatan normal, gema akan dimatikan. Permintaan sumber daya sistem untuk menggemakan data yang diterima terlalu tinggi selama pencatatan.

• STATE Verbose – Mengubah status pelaporan kesalahan verbose. STATE dapat aktif atau nonaktif. Perintah ini disimpan dalam memori. Dengan menonaktifkan kesalahan verbose, OpenLog akan merespons hanya dengan ! jika terjadi kesalahan, dan bukan perintah yang tidak dikenal: C OMMAND.D..TKarakter he lebih mudah diurai oleh sistem tertanam daripada kesalahan lengkap. Jika Anda menggunakan terminal, membiarkan verbose aktif akan memungkinkan Anda melihat pesan kesalahan lengkap.
• baud – Perintah ini akan membuka menu sistem yang memungkinkan pengguna memasukkan baud rate. Baud rate antara 300bps dan 1Mbps didukung. Pemilihan baud rate bersifat langsung, dan OpenLog memerlukan siklus daya agar pengaturan dapat berlaku. Baud rate disimpan ke EEPROM dan dimuat setiap kali OpenLog menyala. Nilai default adalah 9600 8N1.

Ingat: Jika board macet pada baud rate yang tidak diketahui, Anda dapat menghubungkan RX ke GND dan menyalakan OpenLog. LED akan berkedip bolak-balik selama 2 detik dan kemudian akan berkedip serempak. Matikan OpenLog, dan lepaskan jumper. OpenLog sekarang disetel ulang ke 9600bps dengan karakter escape `CTRL-Z` yang ditekan tiga kali berturut-turut. Fitur ini dapat ditimpa dengan menyetel bit Emergency Override ke 1. Lihat config.txt untuk informasi lebih lanjut.

• Set – Perintah ini membuka menu sistem untuk memilih mode bootup. Pengaturan ini akan dilakukan saat komputer dinyalakan lagi dan disimpan dalam EEPROM nonvolatil.
  • Baru File Pencatatan – Mode ini membuat log baru file setiap kali OpenLog menyala. OpenLog akan mengirimkan 1 (UART aktif), 2 (kartu SD diinisialisasi), lalu < (OpenLog siap menerima data). Semua data akan direkam ke LOG#####.txt. Angka ##### bertambah setiap kali OpenLog menyala (maksimum 65533 log). Angka tersebut disimpan dalam EEPROM dan dapat diatur ulang dari menu set. Tidak semua karakter yang diterima digemakan. Anda dapat keluar dari mode ini dan masuk ke mode perintah dengan mengirimkan CTRL+z (ASCII 26). Semua data yang di-buffer akan disimpan.
• Catatan: Jika terlalu banyak log yang dibuat, OpenLog akan menampilkan kesalahan **Terlalu banyak log**, keluar dari mode ini, dan masuk ke Command Prompt. Output serial akan terlihat seperti `12!Terlalu banyak log!
  • Menambahkan File Pencatatan – Juga dikenal sebagai mode sekuensial, mode ini membuat file disebut SEQLOG.txt jika belum ada, dan menambahkan data yang diterima ke file. OpenLog akan mengirimkan 12< saat OpenLog siap menerima data. Karakter tidak digemakan. Anda dapat keluar dari mode ini dan masuk ke mode perintah dengan mengirimkan CTRL+z (ASCII 26). Semua data yang di-buffer akan disimpan.
  • Command Prompt – OpenLog akan mengirimkan 12> saat sistem siap menerima perintah. Perhatikan bahwa tanda > menunjukkan OpenLog siap menerima perintah, bukan data. Anda dapat membuat files dan menambahkan data ke files, tetapi ini memerlukan beberapa penguraian serial (untuk pemeriksaan kesalahan), jadi kami tidak menyetel mode ini secara default.
  • Setel Ulang Baru File Nomor – Mode ini akan mengatur ulang log file nomor ke LOG000.txt. Ini berguna jika Anda baru saja mengosongkan kartu microSD dan ingin log file angka untuk memulai lagi.
  • Karakter Escape Baru – Opsi ini memungkinkan pengguna memasukkan karakter, seperti CTRL+z atau $, dan menetapkannya sebagai karakter escape baru. Pengaturan ini disetel ulang ke CTRL+z selama pengaturan ulang darurat.
  • Jumlah Karakter Escape – Opsi ini memungkinkan pengguna untuk memasukkan karakter (seperti 1, 3, atau 17), memperbarui jumlah karakter escape baru yang diperlukan untuk masuk ke mode perintah. Misalnyaample, memasukkan angka 8 akan mengharuskan pengguna menekan CTRL+z delapan kali untuk masuk ke mode perintah. Pengaturan ini akan direset ke 3 selama pengaturan ulang darurat.
• Penjelasan Karakter Escape: Alasan OpenLog mengharuskan `CTRL+z` ditekan 3 kali untuk masuk ke mode perintah adalah untuk mencegah papan tidak sengaja disetel ulang selama pengunggahan kode baru dari Arduino IDE. Ada kemungkinan papan akan melihat karakter `CTRL+z` muncul selama bootloading (masalah yang kami lihat di versi awal firmware OpenLog), jadi ini bertujuan untuk mencegahnya. Jika Anda menduga papan Anda rusak karena hal ini, Anda selalu dapat melakukan pengaturan ulang darurat dengan menahan pin RX ke ground selama penyalaan daya.

Konfigurasi File

Jika Anda lebih suka tidak menggunakan terminal serial untuk mengubah pengaturan pada OpenLog Anda, Anda juga dapat memperbarui pengaturan dengan mengubah CONFIG.TXT file.

Catatan: Fitur ini hanya berfungsi pada firmware versi 1.6 atau yang lebih baru. Jika Anda membeli OpenLog setelah tahun 2012, Anda akan menjalankan firmware versi 1.6+

• Untuk melakukan ini, Anda memerlukan pembaca kartu microSD dan editor teks. Buka config.txt file (kapitalisasi dari file nama tidak masalah), dan konfigurasikan! Jika Anda belum pernah menyalakan OpenLog dengan kartu SD sebelumnya, Anda juga dapat membuat secara manual fileJika Anda telah menyalakan OpenLog dengan kartu microSD yang dimasukkan sebelumnya, Anda akan melihat sesuatu seperti berikut saat Anda membaca kartu microSD.OpenLog membuat config.txt dan LOG0000.txt file saat pertama kali dinyalakan.
• Konfigurasi default file memiliki satu baris pengaturan dan satu baris definisi.Konfigurasi default file ditulis oleh OpenLog.
• Perhatikan bahwa ini adalah karakter yang terlihat biasa (tidak ada nilai yang tidak terlihat atau biner), dan setiap nilai dipisahkan dengan koma.

Pengaturannya ditetapkan sebagai berikut:

• baud: Kecepatan baud komunikasi. 9600 bps adalah nilai default. Nilai yang dapat diterima yang kompatibel dengan Arduino IDE adalah 2400, 4800, 9600, 19200, 38400, 57600, dan 115200. Anda dapat menggunakan kecepatan baud lain, tetapi Anda tidak akan dapat berkomunikasi dengan OpenLog melalui monitor serial Arduino IDE.
• Escap:e Nilai ASCII (dalam format desimal) dari karakter escape. 26 adalah CTRL+z dan merupakan default. 36 adalah $ dan merupakan karakter escape yang umum digunakan.
• Esc #: Jumlah karakter escape yang dibutuhkan. Secara default, jumlahnya tiga, jadi Anda harus menekan karakter escape tiga kali untuk masuk ke mode perintah. Nilai yang dapat diterima adalah dari 0 hingga 254. Menetapkan nilai ini ke 0 akan menonaktifkan pemeriksaan karakter escape sepenuhnya.
• Mode Sistem mode. OpenLog dimulai dalam mode Log Baru (0) secara default. Nilai yang dapat diterima adalah 0 = Log Baru, 1 = Log Berurutan, 2 = Mode Perintah.
• Kata kerja: Mode verbose. Pesan kesalahan yang diperpanjang (verbose) diaktifkan secara default. Menyetel ini ke 1 akan mengaktifkan pesan kesalahan verbose (seperti perintah yang tidak diketahui: hapus ! ). Menyetel ini ke 0 akan menonaktifkan kesalahan verbose, tetapi akan merespons dengan ! jika terjadi kesalahan. Menonaktifkan mode verbose berguna jika Anda mencoba menangani kesalahan dari sistem tertanam.
• Echo: Mode echo. Saat dalam mode perintah, karakter di-echo secara default. Mengatur ini ke 0 akan menonaktifkan echo karakter. Menonaktifkan ini berguna jika menangani kesalahan, dan Anda tidak ingin perintah yang dikirim di-echo kembali ke OpenLog.II
• iignoreRXEmergency Override. Biasanya, OpenLog akan melakukan pengaturan ulang darurat saat pin RX ditarik rendah selama penyalaan daya. Mengatur ini ke 1 akan menonaktifkan pemeriksaan pin RX selama penyalaan daya. Ini dapat membantu untuk sistem yang akan menahan jalur RX rendah karena berbagai alasan. Jika Emergency Override dinonaktifkan, Anda tidak akan dapat memaksa unit kembali ke 9600bps, dan konfigurasinya file akan menjadi satu-satunya cara untuk mengubah laju baud.

Bagaimana OpenLog Memodifikasi Konfigurasi File
Ada lima situasi berbeda bagi OpenLog untuk memodifikasi config.txt file.

• Konfigurasi file ditemukan: Selama penyalaan, OpenLog akan mencari config.txt fileJika file ditemukan, OpenLog akan menggunakan pengaturan yang disertakan dan menimpa pengaturan sistem yang disimpan sebelumnya.
• Tidak ada konfigurasi file ditemukan: Jika OpenLog tidak dapat menemukan config.txt file kemudian OpenLog akan membuat config.txt dan merekam pengaturan sistem yang saat ini tersimpan di dalamnya. Ini berarti jika Anda memasukkan kartu microSD yang baru diformat, sistem Anda akan mempertahankan pengaturannya saat ini.
• Konfigurasi rusak file ditemukan: OpenLog akan menghapus config.txt yang rusak file, dan akan menulis ulang pengaturan EEPROM internal dan pengaturan config.txt file ke keadaan yang diketahui baik yaitu 9600,26,3,0,1,1,0.
• Nilai ilegal dalam konfigurasi file:Jika OpenLog menemukan pengaturan apa pun yang berisi nilai ilegal, OpenLog akan menimpa nilai yang rusak di config.txt file dengan pengaturan sistem EEPROM yang tersimpan saat ini.
• Perubahan melalui command prompt: Jika pengaturan sistem diubah melalui command prompt (baik melalui koneksi serial atau melalui perintah serial mikrokontroler) perubahan tersebut akan direkam ke EEPROM sistem dan ke config.txt file.
• Reset Darurat: Jika OpenLog dimatikan dengan jumper antara RX dan GND, dan bit Emergency Override diatur ke 0 (memungkinkan reset darurat), OpenLog akan menulis ulang pengaturan EEPROM internal dan pengaturan config.txt file ke keadaan yang diketahui baik yaitu 9600,26,3,0,1,1,0.

Penyelesaian Masalah

Ada beberapa pilihan berbeda untuk memeriksa apakah Anda mengalami masalah saat menghubungkan melalui monitor serial, mengalami masalah dengan karakter yang hilang di log, atau mengalami masalah OpenLog.

Periksa Perilaku LED STAT1
LED STAT1 menunjukkan perilaku berbeda untuk dua kesalahan umum yang berbeda.

• 3 kali berkedip: Kartu microSD gagal diinisialisasi. Anda mungkin perlu memformat kartu dengan FAT/FAT16 di komputer.
• 5 Kedipan: OpenLog telah berubah ke laju baud baru dan perlu dimatikan kembali.

Periksa Ulang Struktur Subdirektori

• Jika Anda menggunakan OpenLog.ino default misalnyaample, OpenLog hanya akan mendukung dua subdirektori. Anda perlu mengubah FOLDER_TRACK_DEPTH dari 2 menjadi jumlah subdirektori yang perlu Anda dukung. Setelah Anda melakukan ini, kompilasi ulang kode tersebut, dan unggah firmware yang dimodifikasi.
• Verifikasi Jumlah Files di Direktori Root
• OpenLog hanya akan mendukung hingga 65,534 log filedi direktori root. Kami sarankan Anda memformat ulang kartu microSD untuk meningkatkan kecepatan pencatatan.
• Verifikasi Ukuran Firmware Anda yang Dimodifikasi
• Jika Anda menulis sketsa khusus untuk OpenLog, pastikan sketsa Anda tidak lebih besar dari 32,256. Jika demikian, sketsa tersebut akan memotong 500 byte memori Flash bagian atas, yang digunakan oleh bootloader serial Optiboot.
• Periksa Ulang File Nama
• Semua file nama harus berupa huruf dan angka. MyLOG1.txt boleh saja, tetapi Hi !e _ .txtt mungkin tidak berfungsi.
• Gunakan 9600 Baud
• OpenLog berjalan pada ATmega328 dan memiliki RAM yang terbatas (2048 byte). Saat Anda mengirim karakter serial ke OpenLog, karakter ini akan di-buffer. Spesifikasi Sederhana Grup SD memungkinkan kartu SD untuk merekam blok data ke memori flash dalam waktu hingga 250 ms (bagian 4.6.2.2 Write).
• Pada 9600bps, itu berarti 960 byte (10 bit per byte) per detik. Itu berarti 1.04 ms per byte. OpenLog saat ini menggunakan buffer penerima 512 byte sehingga dapat menyimpan sekitar 50 ms karakter. Ini memungkinkan OpenLog untuk berhasil menerima semua karakter yang datang pada 9600bps. Saat Anda meningkatkan laju baud, buffer akan bertahan lebih sedikit.

Waktu Buffer Overrun OpenLog

Banyak kartu SD yang memiliki waktu perekaman lebih cepat dari 250 ms. Hal ini dapat dipengaruhi oleh 'kelas' kartu dan seberapa banyak data yang sudah tersimpan di kartu tersebut. Solusinya adalah dengan menggunakan baud rate yang lebih rendah atau menambah jumlah waktu antara karakter yang dikirim pada baud rate yang lebih tinggi.

Pertanyaan yang Sering Diajukan