Semafor dalam Nucleus RTOS: Layanan Utilitas & Struktur Data
Lihat seri RTOS Revealed
Artikel ini melanjutkan peninjauan tentang semafor.
Layanan Utilitas Semafor
Nucleus RTOS menawarkan empat panggilan API yang menyediakan utilitas esensial untuk manajemen semafor: mereset semafor, mengambil informasi rinci semafor, menghitung jumlah total semafor dalam aplikasi, dan mendapatkan pointer ke semua objek semafor. Tiga fungsi pertama sepenuhnya diimplementasikan dalam Nucleus SE.
Mereset Semafor
Berbeda dengan objek kernel lainnya, mereset semafor mengembalikannya ke hitungan awal yang ditentukan daripada sekadar menginisialisasikannya ke nilai waktu kompilasi. Tugas apa pun yang terblokir pada semafor segera dibangunkan dan menerima kode kembali NUSE_SEMAPHORE_WAS_RESET (atau NU_SEMAPHORE_RESET dalam Nucleus RTOS).
Panggilan API Nucleus RTOS untuk Mereset Semafor
Prototipe panggilan layanan:
STATUS NU_Reset_Semaphore(NU_SEMAPHORE *semaphore, UNSIGNED initial_count);
Parameter:
semaphore – pointer ke blok kontrol semafor yang disediakan oleh pengguna.
initial_count – nilai yang harus diatur ke counter semafor.
Kembali:
NU_SUCCESS – operasi selesai dengan sukses.
NU_INVALID_SEMAPHORE – pointer semafor tidak valid.
Panggilan API Nucleus SE untuk Mereset Semafor
Prototipe panggilan layanan:
STATUS NUSE_Semaphore_Reset(NUSE_SEMAPHORE semaphore, U8 initial_count);
Parameter:
semaphore – indeks (ID) semafor yang akan di-reset.
initial_count – nilai yang harus diatur ke counter semafor.
Kembali:
NUSE_SUCCESS – operasi selesai dengan sukses.
NUSE_INVALID_SEMAPHORE – indeks semafor tidak valid.
Implementasi Nucleus SE untuk Reset Semafor
Rutin NUSE_Semaphore_Reset() memvalidasi argumen dan kemudian menulis hitungan baru ke dalam array NUSE_Semaphore_Counter[]. Ketika blokir diaktifkan, ia menelusuri tabel tugas untuk menemukan tugas apa pun yang tertunda pada semafor, menandai mereka sebagai siap, mengassign kode kembali NUSE_SEMAPHORE_WAS_RESET, dan akhirnya memicu reschedule jika scheduler prioritas aktif.
Semua tugas yang tertunda therefore bertransisi ke keadaan siap dengan kode kembali yang sesuai. Jika scheduler prioritas aktif, NUSE_Reschedule() memastikan tugas prioritas lebih tinggi dapat mendahului tugas prioritas lebih rendah.
Informasi Semafor
Panggilan layanan ini mengambil detail kunci tentang semafor. Dalam Nucleus SE, lebih sedikit bidang dikembalikan karena penamaan objek, urutan penangguhan, dan penangguhan tugas mungkin tidak didukung.
Panggilan API Nucleus RTOS untuk Informasi Semafor
semaphore – pointer ke blok kontrol semafor yang diminta.
name – buffer tujuan untuk nama semafor (8 karakter plus null terminator).
current_count – menerima nilai counter semafor saat ini.
suspend_type – menerima kebijakan penangguhan (misalnya, NU_FIFO atau NU_PRIORITY).
tasks_waiting – menerima jumlah tugas yang tertunda pada semafor.
first_task – menerima pointer ke blok kontrol tugas pertama yang tertunda.
Kembali:
NU_SUCCESS – panggilan selesai dengan sukses.
NU_INVALID_SEMAPHORE – pointer semafor tidak valid.
Panggilan API Nucleus SE untuk Informasi Semafor
Prototipe panggilan layanan:
STATUS NUSE_Semaphore_Information(NUSE_SEMAPHORE semaphore, U8 *current_count, U8 *tasks_waiting, NUSE_TASK *first_task);
Parameter:
semaphore – indeks semafor.
current_count – menerima nilai counter saat ini.
tasks_waiting – menerima jumlah tugas yang tertunda (jika penangguhan tugas diaktifkan).
first_task – menerima indeks tugas pertama yang tertunda (jika penangguhan tugas diaktifkan).
Kembali:
NUSE_SUCCESS – panggilan selesai dengan sukses.
NUSE_INVALID_SEMAPHORE – indeks semafor tidak valid.
NUSE_INVALID_POINTER – satu atau lebih argumen pointer tidak valid.
Implementasi Nucleus SE untuk Informasi Semafor
Implementasi ringkas: memasuki bagian kritis, menyalin nilai counter, dan, jika blokir diaktifkan, mencacah tabel tugas untuk menghitung tugas yang menunggu dan mengidentifikasi tugas pertama yang tertunda. Jika tidak, jumlah menunggu dan tugas pertama diatur ke nol.
Layanan ini mengembalikan jumlah total semafor yang didefinisikan dalam aplikasi. Dalam Nucleus RTOS nilai dapat berubah pada runtime; dalam Nucleus SE tetap pada waktu kompilasi.
Panggilan API Nucleus RTOS untuk Hitungan Semafor
Prototipe panggilan layanan:
UNSIGNED NU_Established_Semaphores(VOID);
Kembali:
Jumlah semafor yang dibuat dalam aplikasi.
Panggilan API Nucleus SE untuk Hitungan Semafor
Prototipe panggilan layanan:
U8 NUSE_Semaphore_Count(void);
Kembali:
Jumlah semafor yang dikonfigurasi dalam aplikasi.
Implementasi Nucleus SE untuk Hitungan Semafor
Rutin hanya mengembalikan nilai konstanta waktu kompilasi NUSE_SEMAPHORE_NUMBER.