ทําไม Mailbox Client HAL API ไม่พร้อมใช้งานสําหรับอุปกรณ์ FPGA Agilex™ 5

ในซอฟต์แวร์ Quartus® Prime Pro Edition เวอร์ชัน 24.1 คุณอาจสังเกตเห็นว่าไดรเวอร์ HAL Application Programming Interface (API) ของ Mailbox Client IP ไม่พร้อมใช้งานใน BSP สําหรับ Nios®การออกแบบ V ที่เน้นอุปกรณ์ตระกูล Agilex™ 5 FPGA ทั้งหมด

อุปกรณ์ที่ใช้ SDM อื่นๆ ไม่ได้รับผลกระทบ

เมื่อต้องการหลีกเลี่ยงปัญหานี้ในซอฟต์แวร์ Quartus® Prime Pro Edition เวอร์ชัน 24.1 ให้ทําตามขั้นตอนเหล่านี้:

1. เริ่ม ระบบโปรเซสเซอร์ Nios® V ด้วย Mailbox Client IP ในซอฟต์แวร์ Quartus® Prime Pro Edition เวอร์ชัน 24.1

2. สร้าง BSP คุณอาจเห็นว่า ชื่อไดรเวอร์และเวอร์ชันของไดรเวอร์สําหรับ IP ไคลเอ็นต์กล่องจดหมายไม่เป็นไม่มี

   

3. ไปที่โฟลเดอร์โครงการ <BSP>/ไดรเวอร์

4. นําทางไปยังไดเรกทอรี <Quartus Prime แยกต่างหาก>/24.1/ip/altera/pgm/altera_s10_mailbox_client/HAL

5. สังเกตว่าไดเรกทอรีโฟลเดอร์ทั้งสองเหมือนกัน - inc และ src

6. คัดลอก เนื้อหาของโฟลเดอร์ Quartus® Prime HAL ไปยังโฟลเดอร์ไดรเวอร์ BSP ตามลําดับ

7. ไปที่ไดเรกทอรี <Quartus Prime>/24.1/ip/altera/pgm/altera_s10_mailbox_client/inc

8. คัดลอก altera_s10_mailbox_client_regs.h ไปยังโฟลเดอร์ไดรเวอร์ BSP/inc

9. ตรวจสอบ เนื้อหาของโฟลเดอร์ BSP inc อยู่ด้านล่าง

   • 

10. ตรวจสอบ เนื้อหาของโฟลเดอร์ BSP src อยู่ด้านล่าง

    • 

11. แก้ไข target_sources ใน CMakeLists.txt BSP

    • เพิ่มไฟล์ C ในคอลัมน์ PRIVATE

      • ไดรเวอร์/src/altera_s10_mailbox_client.c

        ไดรเวอร์/src/altera_s10_mailbox_client_flash.c

        ไดรเวอร์/src/altera_s10_mailbox_client_flash_rsu.c

        ไดรเวอร์/src/altera_s10_mailbox_client_rsu.c

        ไดรเวอร์/src/librsu.c

        ไดรเวอร์/src/librsu_cb.c

        ไดรเวอร์/src/librsu_cfg.c

        ไดรเวอร์/src/librsu_ll_qspi.c

        ไดรเวอร์/src/librsu_misc.c

        ไดรเวอร์/src/rsu_client.c

        …

    • เพิ่มไฟล์ส่วนหัวในคอลัมน์สาธารณะ

      • ไดรเวอร์/inc/altera_s10_mailbox_client.h

        ไดรเวอร์/inc/altera_s10_mailbox_client_flash.h

        ไดรเวอร์/inc/altera_s10_mailbox_client_flash_rsu.h

        ไดรเวอร์/inc/altera_s10_mailbox_client_regs.h

        ไดรเวอร์/inc/altera_s10_mailbox_client_rsu.h

        ไดรเวอร์/inc/librsu.h

        ไดรเวอร์/inc/librsu_cb.h

        ไดรเวอร์/inc/librsu_cfg.h

        ไดรเวอร์/inc/librsu_ll.h

        ไดรเวอร์/inc/librsu_misc.h

        ไดรเวอร์/inc/rsu_client.h

        …

12. ปรับเปลี่ยน alt_sys_init.c ในส่วนต่อไปนี้

• ส่วนหัวของอุปกรณ์

  • #include "altera_s10_mailbox_client.h"

• จัดสรรอุปกรณ์จัดเก็บข้อมูล

  • ALTERA_S10_MAILBOX_CLIENT_INSTANCE (MAILBOX_CLIENT, mailbox_client);

• เริ่มต้นอุปกรณ์คอนโทรลเลอร์แบบไม่ขัดจังหวะ

  • ALTERA_S10_MAILBOX_CLIENT_INIT (MAILBOX_CLIENT, mailbox_client);

ดําเนินการ คอมไพล์ โครงการซอฟต์แวร์

ปัญหานี้ได้รับการแก้ไขในซอฟต์แวร์ Quartus® Prime Pro Edition เวอร์ชัน 24.3