RN2483 Library
1.0.0
Perpustakaan C tertanam platform-independen untuk modul LORA Micrchip RN2483.
Catatan: Repo ini saat ini tidak dipertahankan dan ditulis terhadap v1.0 dari spesifikasi Lorawan. Anggap itu terdepresiasi untuk saat ini . Biar ketahui jika kamu mau
Ini adalah perpustakaan C tertanam untuk berinteraksi dengan modul LORA Microchip RN2483. Ini bertujuan untuk menjadi sederhana dan modular (cukup untuk membuat porting ke platform yang berbeda mudah).
Salah satu fitur utama dari perpustakaan ini adalah portabilitasnya. Perpustakaan tertanam dengan I/O apa pun tidak akan pernah benar -benar portabel, sehingga platform spesifik didukung di cabang repositori terpisah. Cabang utama dari repo ini adalah kode inti platform-independen. Cabang individual (misalnya platform/mbit ), adalah apa yang sebenarnya ingin Anda gunakan jika Anda mencoba menggunakan ini untuk digunakan pada platform.
Satu-satunya fungsionalitas khusus perangkat keras yang dirancang ulang oleh perpustakaan ini adalah kemampuan untuk R/W melalui UART ke modul RN2483. Akibatnya, ini ditangani oleh fungsi pembungkus: read dan write . Di cabang master , ini hanya diisi dengan #Error yang memberitahu Anda untuk mengimplementasikannya pada kompilasi.
Untuk detail tentang penambahan dukungan untuk platform tertentu, lihat 6. AddingPlatforms .
Untuk contoh dukungan platform tertentu, lihat 5. Platform yang Didukung .
Ada dokumentasi doxygen , cukup jalankan doksycfg doxygen di direktori utama dan itu akan menghasilkan dokumen/ folder. Semua komentar harus kompatibel dengan doxygen dan saya sudah mencoba untuk menjadi selembut mungkin, tetapi saya akan memberikan gambaran singkat tentang hal itu di sini untuk kemudahan penggunaan.
Perpustakaan ditulis dalam standar C (C99) dan menyediakan fungsionalitas penuh dari modul RN2483.
Ada fungsi command yang memungkinkan Anda untuk menulis perintah yang valid ke modul (lihat referensi perintah untuk perintah yang valid)
Ada perintah initMAC yang menggunakan pengaturan yang ditentukan dalam file rn2483.cfg (yang ditulis ke config.h oleh Makefile ) untuk menginisialisasi semua pengaturan khusus Lorawan yang Anda butuhkan untuk berhasil menghubungkan jaringan Lorawan.
Selain itu, fungsi -fungsi penting lainnya adalah join (bergabung dengan jaringan) dan tx (mengirimkan data melalui jaringan yang terhubung), yang menangani jabat tangan Lorawan untuk Anda.
Catatan: Saya ingin memperluas perpustakaan ini di masa depan dan merapikannya.
Pastikan untuk memeriksa file RN2483.CFG untuk mengonfigurasi pengaturan Lorawan Anda dan menjalankan Makefile
Pengaturan akan bergantung pada platform Anda, jadi untuk itu melihat readme cabang platform tertentu. Tidak ada fungsi init atau apa pun untuk menyiapkan pin yang perlu dikhawatirkan - itu semua dilakukan dalam fungsi read dan write (diimplementasikan oleh Anda, untuk usecase Anda).
Di cabang master , saya awalnya memiliki fungsi printf dan getc untuk ini (dengan maksud membiarkan pengguna mengalihkan streaming stdin dan stdout atau mendefinisikan kembali fungsi dengan makro), tetapi setelah mengalami mikro mikro: proses pembuatan cmake bit, saya memutuskan bahwa lebih mudah untuk hanya memutuskan untuk menggunakan fungsi wrapper yang dimodifikasi.
Selain pengaturan, penggunaan umum harus dilakukan:
Ingatlah bahwa Anda dapat mengakses fungsionalitas lain dari RN2483 melalui fungsi RN2483_Command ()
Lihat Cabang: Platform/MBIT 's ReadMe.MD.
Saya sudah mencoba memodulus perubahan yang diperlukan untuk menambahkan platform sebanyak mungkin. Ini sebagian besar dilakukan melalui fungsi pembungkus baca/tulis di RN2483.c, tetapi jika Anda melihat BBC Micro: Bit Branch Anda akan melihat bahwa dalam beberapa kasus Anda perlu mengubah lebih dari ini (lihat readme cabang itu untuk detailnya).
Fungsi yang perlu diubah di rn2483.c :
Jelas, tidak pernah sesederhana ini, jadi Anda mungkin mengalami beberapa hambatan yang membutuhkan modifikasi lebih lanjut. Misalnya, di cabang platform/MBIT saya harus melewati petunjuk ke objek serial microbit.
