ra8_npu.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
 
#include "ra8_device.h"
#include "ra8_err.h"
#include "ra8_npu_regs.h"
 
#ifndef RA8_HAS_NPU
#error "ra8_npu.h included on a device without an NPU (RA8P1-only)."
#endif
 
#ifdef __cplusplus
extern "C" {
#endif

typedef struct {
  const void* cmd_stream;                          
  uint32_t    cmd_stream_bytes;                    
  uint8_t     region_count;                        
  uint64_t    region_base[k_ra8_npu_region_count]; 
} ra8_npu_job_t;

typedef struct {
  uint32_t raw;        
  bool     running;    
  bool     irq_raised; 
  bool     cmd_end;    
  bool     fault;      
} ra8_npu_status_t;

[[nodiscard]] ra8_err_t ra8_npu_init(void);

[[nodiscard]] ra8_err_t ra8_npu_deinit(void);

[[nodiscard]] ra8_err_t ra8_npu_reset(void);

[[nodiscard]] ra8_err_t ra8_npu_read_id(uint32_t* out_id);

[[nodiscard]] ra8_err_t ra8_npu_submit(const ra8_npu_job_t* job);

[[nodiscard]] ra8_err_t ra8_npu_run(void);

[[nodiscard]] ra8_err_t ra8_npu_poll(bool* out_done);

[[nodiscard]] ra8_err_t ra8_npu_wait(void);

[[nodiscard]] ra8_err_t ra8_npu_read_status(ra8_npu_status_t* out);

[[nodiscard]] ra8_err_t ra8_npu_clear_irq(void);

[[nodiscard]] ra8_err_t ra8_npu_irq_arm(void);

void ra8_npu_irq_handler(void* ctx);

[[nodiscard]] ra8_err_t ra8_npu_wait_irq(void);
 
#ifdef __cplusplus
}
#endif