Panduan Koneksi OpenLog

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
• DEV-13712SparkFun OpenLog dengan Header
• DEV-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 Penyambungan OpenLog Daftar Keinginan SparkFun

	Arduino Pro Mini 328 – 3.3V/8MHz PENGEMBANGAN-11114 Warnanya biru! Tipis! Ini Arduino Pro Mini! Pendekatan desain minimalis SparkFun untuk Arduino. Ini adalah Arduino 3.3V …
	SparkFun FTDI Dasar Breakout – 3.3V PENGEMBANGAN-09873 Ini adalah revisi terbaru dari [FTDI Basic]( kamihttp://www.sparkfun.com/commerce/product_info.php?products_id= ...
	Kabel USB Cerberus SparkFun – 6 kaki CAB-12016 Anda salah memasang kabel USB. Tidak masalah kabel mana yang Anda miliki, kabel itu salah. Namun, bagaimana jika Anda bisa saja salah…
	SparkFun Buka Log PENGEMBANGAN-13712 SparkFun OpenLog adalah pencatat data sumber terbuka yang bekerja melalui koneksi serial sederhana dan mendukung mi…
	Kartu microSD dengan Adaptor – 16GB (Kelas 10) KOM-13833 Ini adalah kartu memori microSD kelas 10 16GB, cocok untuk menyimpan sistem operasi untuk komputer papan tunggal…
	Pembaca USB microSD KOM-13004 Ini adalah pembaca USB microSD kecil yang mengagumkan. Cukup masukkan kartu microSD Anda ke dalam konektor USB, lalu…
	Header Wanita PRT-00115 Baris tunggal dengan 40 lubang, header betina. Dapat dipotong sesuai ukuran dengan pemotong kawat. Jarak standar 1 inci. Kami menggunakan …
	Kabel Jumper Premium 6″ M/M Paket isi 10 PRT-08431 Ini adalah produk eksklusif SparkFun! Ini adalah jumper sepanjang 155 mm dengan konektor male di kedua ujungnya. Gunakan ini untuk ju…
	Header Pria Break Away – Sudut Kanan PRT-00553 Sederet header male siku-siku – patahkan agar pas. 40 pin yang dapat dipotong sesuai ukuran apa pun. Digunakan dengan PCB kustom atau gen…

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 Melalui Lubang
Tutorial ini mencakup semua yang perlu Anda ketahui tentang penyolderan tembus lubang.
Antarmuka Periferal Serial (SPI)
SPI umumnya digunakan untuk menghubungkan mikrokontroler ke periferal seperti sensor, register geser, dan kartu SD.
Komunikasi Serial
Konsep komunikasi serial asinkron: paket, level sinyal, laju baud, UART, dan banyak lagi!
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

Masukan VCC	3.3V-12V (Direkomendasikan 3.3V-5V)
Masukan RXI	Tegangan 2.0V-3.8V
Keluaran TXO	3.3V
Penarikan Arus Diam	~2mA-5mA (tanpa kartu microSD), ~5mA-6mA (dengan kartu microSD)
Penulisan Aktif Menggambar Arus	~20-23mA (dengan kartu microSD)

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

LED Status
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 betina pada OpenLog dan header betina 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 ke komputer Anda.
Buka terminal serial, sambungkan ke port COM FTDI Basic Anda, dan mulai!

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 melepaskan 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.

Catatan bahwa koneksinya adalah sambungan 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 menjadi sangat kecil (0) dan buffer RX harus sebesar mungkin. Penggunaan kedua pustaka modifikasi ini secara bersamaan 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 pustaka yang dimodifikasi, ubah SerialPort.h 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 agar dapat 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.

File Manipulasi

• 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.
  • Mantanample: baru file1.txt
• menambahkan File – Tambahkan teks ke akhir FileData serial kemudian dibaca dari UART dalam aliran dan menambahkannya ke file. Itu tidak bergema melalui terminal serial. Jika File tidak ada saat fungsi ini dipanggil, file akan dibuat.
  • Mantanample: 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.
  • Mantanample: tulis logs.txt 516
• rm File – Menghapus File dari direktori saat ini. Karakter pengganti didukung.
  • Mantanampfile: rm README.txt
• ukuran File – Ukuran keluaran File dalam byte.
  • Mantanample: ukuran Log112.csv
  • Keluaran: 11
• membaca File + START+ LENGTH TYPE – Keluarkan konten File dimulai dari MULAI dan menuju PANJANG.
  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
  • HEKSAGON = 2
  • MENTAH = 3
  Anda dapat menghilangkan beberapa argumen tambahan. Periksa contoh berikutampsedikit.
  Pembacaan dasar + bendera yang dihilangkan:
  • Mantanample: baca LOG00004.txt
  • Keluaran: Akselerometer X=12 Y=215 Z=317
  Dibaca dari awal 0 dengan panjang 5:
  • Mantanample: baca LOG00004.txt 0 5
  • Keluaran: Akselerasi
  Baca dari posisi 1 dengan panjang 5 dalam HEX:
  • Mantanample: baca LOG00004.txt 1 5 2
  • Keluaran: 63 63 65 6C
• Dibaca dari posisi 0 dengan panjang 50 dalam RAW:
• • Mantanample: baca LOG00137.txt 0 50 3
• • Output: 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.
  • Mantanampfile: kucing LOG00004.txt
  • Keluaran: 00000000: 41 63 65 6c 3a 20 31

Manipulasi Direktori

• ls – Mencantumkan semua isi direktori saat ini. Karakter pengganti didukung.
  • Mantanampsaya: ls
  • Keluaran: \src
• md Subdirektori – Membuat Subdirektori di direktori saat ini.
  • Mantanample: md Mantanample_Sketsa
• cd Subdirektori – Ubah ke Subdirektori.
  • Mantanample: 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.
  • Mantanampfile: cd..
• rm Subdirectory – Menghapus Subdirektori. Direktori harus kosong agar perintah ini dapat berfungsi.
  • Mantanample: suhu kamar
• rm -rf Direktori – Menghapus Direktori dan semua fileyang terkandung di dalamnya.
  • Mantanample: 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 produksi: 1/2010
  Ukuran Kartu: 965120 KB
• init – Menginisialisasi ulang sistem dan membuka kembali kartu SD. Ini berguna jika kartu SD berhenti merespons.
• sync – 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 secara manual, atau diedit di config.txt file.

• echo STATE – Mengubah status echo sistem, dan disimpan dalam memori sistem. STATE dapat berupa on atau off. Saat on, OpenLog akan menggemakan data serial yang diterima pada command prompt. Saat off, 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 berupa on atau off. Perintah ini disimpan dalam memori. Dengan menonaktifkan kesalahan verbose, OpenLog akan merespons hanya dengan ! jika terjadi kesalahan, bukan perintah yang tidak dikenal: COMMAND. Karakter ! 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 diatur ulang ke 9600bps dengan karakter escape `CTRL-Z` 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 boot up. Pengaturan ini akan terjadi di
  • daya berikutnya dan disimpan dalam EEPROM non-volatil. 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 (maksimal 65533 log). Angka tersebut disimpan dalam EEPROM dan dapat diatur ulang dari menu set.
  Semua karakter yang diterima tidak akan digemakan. Anda dapat keluar dari mode ini dan masuk ke mode perintah dengan mengirim 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 pada 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. 9600bps 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.
• escape : 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 : Mode sistem. OpenLog dimulai dalam mode Log Baru (0) secara default. Nilai yang dapat diterima adalah 0 = Log Baru, 1 = Log Berurutan, 2 = Mode Perintah.
• verb : Mode verbose. Pesan kesalahan yang diperpanjang (verbose) diaktifkan secara default. Menyetel ini ke 1 akan mengaktifkan pesan kesalahan verbose (seperti perintah yang tidak diketahui: remove ! ). 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.
• ignoreRX : Emergency Override. Biasanya, OpenLog akan melakukan reset darurat saat pin RX ditarik rendah selama power up. Mengatur ini ke 1 akan menonaktifkan pemeriksaan pin RX selama power up. 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 _.txt 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

Kecepatan Baud	Waktu per byte	Waktu Hingga Buffer Terlampaui
Kecepatan 9600bps	1.04 menit	532 menit
Kecepatan 57600bps	0.174 menit	88 menit
Kecepatan 115200bps	0.087 menit	44 menit

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.
Format Kartu MicroSD Anda
Ingatlah untuk menggunakan kartu dengan sedikit atau tanpa fileada di sana. Kartu microSD dengan ZIP 3.1GB fileKartu memori atau MP3 memiliki waktu respons yang lebih lambat daripada kartu kosong.
Jika Anda tidak memformat kartu microSD Anda pada OS Windows, format ulang kartu microSD dan buat DOS filesistem pada kartu SD.
Tukar Kartu MicroSD
Ada banyak jenis produsen kartu, kartu berlabel ulang, ukuran kartu, dan kelas kartu, dan semuanya mungkin tidak berfungsi dengan baik. Kami biasanya menggunakan kartu microSD kelas 8 4GB, yang berfungsi baik pada 9600bps. Jika Anda memerlukan kecepatan baud yang lebih tinggi, atau ruang penyimpanan yang lebih besar, Anda mungkin ingin mencoba kartu kelas 6 atau lebih tinggi.
Tambahkan Penundaan Antar Penulisan Karakter
Dengan menambahkan penundaan kecil antara pernyataan Serial.print(), Anda dapat memberi OpenLog kesempatan untuk merekam arusnya
penyangga.
Misalnyaampsaya:
Serial.mulai(115200);
untuk (int i = 1 ; i < 10 ; i++) {
Serial.print(i, DES);
Serial.println(":abcdefghijklmnopqrstuvwxyz-!#");
}

mungkin tidak dapat mencatat dengan benar, karena ada banyak karakter yang dikirim berdekatan. Menyisipkan jeda singkat selama 15 ms di antara penulisan karakter besar akan membantu OpenLog mencatat tanpa menghilangkan karakter.
Serial.mulai(115200);
untuk (int i = 1 ; i < 10 ; i++) {
Serial.print(i, DES);
Serial.println(":abcdefghijklmnopqrstuvwxyz-!#");
tunda(15);
}

Tambahkan Kompatibilitas Monitor Serial Arduino
Jika Anda mencoba menggunakan OpenLog dengan pustaka serial bawaan atau pustaka SoftwareSerial, Anda mungkin melihat masalah dengan mode perintah. Serial.println() mengirimkan baris baru DAN carriage return. Ada dua perintah alternatif untuk mengatasi hal ini.
Yang pertama adalah dengan menggunakan perintah \r (ASCII carriage return):
Serial.print(“TEKS\r”);
Alternatifnya, Anda dapat mengirim nilai 13 (nilai desimal):
Serial.print(“TEKS”);
Serial.tulis(13);

Reset Darurat
Ingat, jika Anda perlu mengatur ulang OpenLog ke keadaan default, Anda dapat mengatur ulang papan dengan mengikat pin RX ke GND, menyalakan OpenLog, menunggu hingga LED mulai berkedip serempak, lalu mematikan OpenLog dan melepaskan jumper.
Jika Anda telah mengubah bit Emergency Override menjadi 1, Anda perlu mengubah konfigurasinya file, karena Reset Darurat tidak akan berfungsi.
Periksa dengan Komunitas
Jika Anda masih mengalami masalah dengan OpenLog, silakan periksa masalah terkini dan yang sudah diselesaikan pada repositori GitHub kami di sini. Ada komunitas besar yang bekerja dengan OpenLog, jadi kemungkinan besar seseorang telah menemukan perbaikan untuk masalah yang Anda alami.

Sumber Daya dan Melangkah Lebih Jauh

Sekarang setelah Anda berhasil mencatat data dengan OpenLog, Anda dapat menyiapkan proyek jarak jauh dan memantau semua data yang mungkin masuk. Pertimbangkan untuk membuat proyek Citizen Science Anda sendiri, atau bahkan pelacak hewan peliharaan untuk melihat apa yang dilakukan Fluffy saat bepergian!
Lihat sumber daya tambahan ini untuk pemecahan masalah, bantuan, atau inspirasi untuk proyek Anda berikutnya.

• Bahasa Indonesia: OpenLog GitHub
• Proyek Illumitune
• Sambungan Sensor Cahaya LilyPad
• BadgerHack: Add-On Sensor Tanah
• Memulai dengan OBD-II
• Fotogate Vernier

Butuh inspirasi lebih? Lihat beberapa tutorial terkait berikut:
Sensor Ketinggian Air Jarak Jauh Foton
Pelajari cara membuat sensor ketinggian air jarak jauh untuk tangki penyimpanan air dan cara mengotomatiskan pompa berdasarkan pembacaan!
Sensor Ketinggian Air Jarak Jauh Foton
Pelajari cara membuat sensor ketinggian air jarak jauh untuk tangki penyimpanan air dan cara mengotomatiskan pompa berdasarkan pembacaan!
Mencatat Data ke Google Sheets dengan Tessel 2
Proyek ini membahas cara mencatat data ke Google Sheets dengan dua cara: menggunakan IFTTT dengan web koneksi atau pen drive USB dan “sneakernet” tanpa.
Data Sensor Grafik dengan Python dan Matplotlib
Gunakan matplotlib untuk membuat plot data suhu waktu nyata yang dikumpulkan dari sensor TMP102 yang terhubung ke Raspberry Pi.
Jika Anda memiliki umpan balik tutorial, silakan kunjungi komentar atau hubungi tim dukungan teknis kami di Dukungan Teknis@sparkfun.com.

Dokumen / Sumber Daya

Papan Pengembangan SparkFun DEV-13712 SparkFun [Bahasa Indonesia:] Panduan Pengguna Papan Pengembangan SparkFun DEV-13712, DEV-11114, DEV-09873, CAB-12016, COM-13833, COM-13004, PRT-00115, PRT-08431, Papan Pengembangan SparkFun DEV-13712, Papan Pengembangan SparkFun, Papan Pengembangan, Papan

Referensi

• Panduan Pengguna