Komunikasi Antar-Tugas Efisien dengan Sinyal Nucleus SE
Dalam seri RTOS Revealed ini, kita menjelajahi sinyal – metode paling sederhana dan biaya rendah untuk komunikasi antar-tugas di Nucleus SE. Sinyal memungkinkan pertukaran pesan ringan dan andal antar-tugas.
Menggunakan Sinyal
Berbeda dengan objek kernel lainnya, sinyal tidak otonom; mereka intrinsik terhubung ke sebuah tugas dan hanya ada dalam konteks tugas tersebut. Ketika sinyal diaktifkan dalam aplikasi, setiap tugas otomatis menerima sekelompok delapan flag sinyal biner.
Setiap tugas dapat mengatur flag sinyal milik tugas lain. Namun, hanya tugas pemilik yang dapat membaca dan menghapus flag tersebut – dan pembacaannya destruktif, artinya flag di-reset selama operasi baca. Tidak ada tugas lain yang dapat memeriksa atau memodifikasi status sinyal sebuah tugas.
Nucleus RTOS menawarkan fasilitas yang memungkinkan sebuah tugas menunjuk callback untuk berjalan ketika tugas lain mengatur salah satu flag sinyalnya. Ini analog dengan rutina layanan interaksi. Sayangnya, fitur ini tidak tersedia di Nucleus SE; tugas harus secara eksplisit memantau flag sinyal mereka.
Mengonfigurasi Sinyal
Sinyal dikonfigurasi terutama melalui direktif #define dalam nuse_config.h. Makro kunci adalah NUSE_SIGNAL_SUPPORT, yang, ketika diatur ke TRUE, mengaktifkan dukungan sinyal di seluruh aplikasi. Jumlah sinyal per tugas tetap delapan; tidak diperlukan konfigurasi tambahan.
Mengaktifkan sinyal menciptakan struktur data yang diperlukan dan mengaktifkan panggilan API yang relevan. Setiap fungsi API di Nucleus SE memiliki makro enable sendiri. Untuk sinyal, enables berikut didefinisikan:
NUSE_SIGNALS_SEND NUSE_SIGNALS_RECEIVE
Secara default, keduanya diatur ke FALSE, menonaktifkan panggilan layanan yang sesuai dan menghilangkan kode implementasi. Untuk menggunakan sinyal, setel enables yang diinginkan ke TRUE. Gagal mengaktifkan API saat menggunakan panggilan akan menghasilkan kesalahan waktu kompilasi; menggunakan API yang tidak diimplementasikan akan menyebabkan kesalahan waktu link.
Cuplikan contoh dari nuse_config.h:
#define NUSE_SIGNAL_SUPPORT FALSE /* Mengaktifkan dukungan sinyal */ #define NUSE_SIGNALS_SEND FALSE /* Enabler panggilan layanan */ #define NUSE_SIGNALS_RECEIVE FALSE /* Enabler panggilan layanan */
Panggilan Layanan Sinyal
Nucleus SE menyediakan empat panggilan layanan utama terkait sinyal. Hanya dua yang diimplementasikan di SE; yang lainnya adalah untuk RTOS tetapi bukan SE.
- Mengirim sinyal ke tugas tertentu – NUSE_Signals_Send()
- Menerima sinyal – NUSE_Signals_Receive()
- Mendaftarkan handler sinyal – tidak diimplementasikan di SE
- Mengaktifkan/menonaktifkan sinyal – tidak diimplementasikan di SE
Operasi Kirim dan Terima
Flag sinyal adalah bit, paling baik divisualisasikan sebagai angka biner. Karena C standar tidak memiliki literal biner, Nucleus SE menyertakan nuse_binary.h, yang mendefinisikan makro seperti b01010101 untuk semua 256 nilai 8-bit.
#define b00000000 ((U8)0x00) #define b00000001 ((U8)0x01) #define b00000010 ((U8)0x02) #define b00000011 ((U8)0x03) #define b00000100 ((U8)0x04) #define b00000101 ((U8)0x05)
Mengirim Sinyal
Setiap tugas dapat mengatur satu atau lebih flag sinyal pada tugas lain melalui operasi OR – flag yang sebelumnya diatur tetap tidak berubah.
Panggilan API Nucleus RTOS
STATUS NU_Send_Signals(NU_TASK *task, UNSIGNED signals);
Parameter:
- task – pointer ke blok kontrol tugas target
- signals – nilai flag sinyal yang akan diatur
Mengembalikan:
- NU_SUCCESS – panggilan berhasil
- NU_INVALID_TASK – pointer tugas tidak valid
Panggilan API Nucleus SE
STATUS NUSE_Signals_Send(NUSE_TASK task, U8 signals);
Parameter:
- task – indeks (ID) tugas target
- signals – nilai flag sinyal yang akan diatur
Mengembalikan:
- NUSE_SUCCESS – panggilan berhasil
- NUSE_INVALID_TASK – indeks tugas tidak valid
Implementasi NUSE_Signals_Send()
STATUS NUSE_Signals_Send(NUSE_TASK task, U8 signals){ #if NUSE_API_PARAMETER_CHECKING if (task >= NUSE_TASK_NUMBER){ return NUSE_INVALID_TASK; } #endif NUSE_CS_Enter(); NUSE_Task_Signal_Flags[task] |= signals; NUSE_CS_Exit(); return NUSE_SUCCESS; } Menerima Sinyal
Sebuah tugas hanya dapat membaca flag sinyalnya sendiri, dan operasi tersebut destruktif – flag dihapus saat dibaca.
Panggilan API Nucleus RTOS
UNSIGNED NU_Receive_Signals(VOID);
Mengembalikan nilai flag sinyal saat ini.
Panggilan API Nucleus SE
U8 NUSE_Signals_Receive(void);
Mengembalikan nilai flag sinyal saat ini.
Implementasi NUSE_Signals_Receive()
U8 NUSE_Signals_Receive(void){ U8 signals; NUSE_CS_Enter(); signals = NUSE_Task_Signal_Flags[NUSE_Task_Active]; NUSE_Task_Signal_Flags[NUSE_Task_Active] = 0; NUSE_CS_Exit(); return signals; } Fungsi sederhana ini menggambarkan bagaimana Nucleus SE mengelola sinyal secara efisien tanpa mempengaruhi penangguhan atau penjadwalan tugas.