Drivers

Pengemudi

Repositori terpusat untuk driver tingkat rendah yang dikembangkan oleh Zenith Aerospace

Tujuan • Lingkungan • Cara menggunakan driver • Menambahkan driver

Tujuan

Simpan dan kelola pengemudi yang dikembangkan.

Cara menggunakan driver

Setiap pengemudi diatur dalam foldernya sendiri, di mana Anda akan menemukan pasangan .c/.h . Cukup tambahkan file ke proyek Anda, misalnya dalam proyek STM32Cubeide Tambahkan file .c ke folder Core/Src dan .h ke Core/Inc . Namun semua driver menggunakan platform "Framework", jadi Anda juga perlu menyalin seluruh folder platform ke proyek Anda juga, di STM32Cubeide menambahkannya ke folder Core/Inc . Semua pengemudi harus memiliki contoh cara menggunakannya.

Platform

Kerangka kerja platform adalah satu set macro dan perpustakaan header saja yang digunakan driver alih-alih fungsi spesifik platform. Misalnya, transaksi I2C dalam proyek STM32 memanggil perpustakaan ST HAL, itu berarti bahwa pengemudi (sebagaimana adanya) hanya dapat digunakan dalam mikrokontroler STM32. Pekerjaan platform adalah untuk mendeteksi di mana mikrokontroler sedang dikompilasi dan kemudian memilih pustaka yang sesuai, sehingga pengemudi yang dikembangkan ke platform dapat digunakan di mikrokontroler/prosesor lainnya.

Bagaimana cara kerjanya?

Pertama, file platform.h mengatur antarmuka umum ke driver, structs umum dan tanda tangan fungsi. Kemudian sekelompok arahan preprocessor mencoba menebak jenis proyek apa ini dan menyertakan implementasi platform yang benar (perpustakaan header-only) di folder arch .

FYI, jika platform tidak dapat menemukan implementasi itu default ke mode debug PC, di mana implementasi yang hanya mencetak ke stdout digunakan.

Lingkungan

Secara realistis, kami kebanyakan menggunakan STM32Cubeide karena sebagian besar proyek yang kami lakukan berdasarkan platform itu. Tetapi dengan kerangka kerja platform Anda hanya perlu kompiler C.

Menambahkan pengemudi

Pedoman untuk pengemudi:

• Anda harus menggunakan C kecuali jika perlu
  • Mengapa: Untuk memaksimalkan kompatibilitas (ya masih ada UC yang hanya bisa menggunakan c)
• Anda harus menambahkan beberapa dokumentasi dengan sebuah contoh
  • Mengapa: Sebagian besar pengguna hanya ingin menyalin dan menempelkan kode yang benar
• Anda harus menggunakan fungsi platform untuk mengakses sumber daya perangkat keras, kecuali perlu
  • Mengapa: Memaksimalkan kompatibilitas, namun platform tidak mencakup semuanya, untuk saat ini, Anda dapat menambahkan driver yang spesifik platform.

Langkah -langkah dalam daftar:

1. Kloning repositori ini
2. Buat folder dengan nama driver
3. Tambahkan .c dan .h
4. Tambahkan file README.md ke folder driver
   1. Pada readme, tambahkan penulis, tanggal, dan tujuan perpustakaan
   2. Tambahkan dokumentasi: parameter dan tujuan setiap fungsi
   3. Tambahkan bagian Catatan untuk informasi tambahan dari IC
5. (Opsional) Tambahkan folder yang disebut Docs
   1. Tambahkan dokumentasi eksternal apa pun termasuk lembar data, catatan aplikasi, dan peta daftar
6. Jika ada masalah GitHub untuk pengemudi, tambahkan pesan atau tutup.

---

[email protected]