RISC-V生态全景解析11——YoC组件的CSI组件介绍

名字好听吗

本文将介绍YoC系统硬件底层抽象组件 —— CSI组件。
5 j8 g6 ^) L$ C# S4 E  u1 a
1、概述
CSI （Chip System InteRFace）是针对嵌入式系统，定义了CPU内核移植接口、外围设备操作接口、统一软件接口规范，消除不同芯片的差异，简化软件的使用及提高软件的移植性。通过CSI 接口规范，可以快速实现芯片对接到YoC 平台。CSI 的具体内容包括：
-CSI-CORE：定义了CPU和相关紧耦合外设的接口规范
' S  d0 U0 D! b+ l* s6 I& d  `" m-CSI-driver：定义了常用的驱动的接口规范
) c7 m( m$ b9 f% ]. q* U( F7 H! B8 w-CSI-kernel：定义实时操作系统的接口规范


2、CSI组件使用
: U# j: W* g( x) a; hCSI有两个版本，目前CSI1.0逐步启用，推荐使用CSI2.0。

3、头文件包含
! L+ g6 E% s# Q3.1 GCC -I 路径
: n; ~! |9 Y% ^1 f* H$ N! ], C-I csi2/include/
; a" B9 q& p5 V: A6 G
3 t. K# A1 Z! d4 O3.2 CSI-Core头文件包含
#include <csi_core.h>

3.3 CSI-Driver头文件包含
# ~1 O' e% e7 S2 y& S2 v#include <drv/UART.h> #include <drv/timer.h>
( ]% O4 C; K  y# u- Q
) Z/ E; ]/ y' K% E% w- h3.4 CSI-Kernel头文件包含
#include <csi_kernel.h>

4、模块分述
4 R3 w9 O+ p" E3 T! L4.1 CSI-Core
目前已针对RISCV、C-SKY架构做了接口的定义和实现。CSI-Core是驱动和RTOS程序的基础，CSI-Driver会基于CSI-Core的接口来定义外设寄存器描述和驱动实现。
9 x/ G# x4 s) H; w+ }2 K% i
4.2 CSI-Driver
-CSI-Driver是应用接口，是对硬件功能的抽象，不会暴露所有硬件细节。
6 a% b5 o2 u8 h6 M) _$ V/ o9 j# s-CSI-Driver具有统一的接口，不同硬件IP之间的差异会在这层做统一。
! _; y7 a% W& X# l% |: o-目前已规范了40+个模块的接口，包括IO类，加解密类，定时器类等。
4.2.1 统一的设备和中断管理

4.2.2 驱动程序的注册与注销
& H( }/ g- [4 k) Q, F& O4.2.2.1 注册
注册函数负责驱动的初始化和硬件的基本初始化。一般的，CSI驱动注册函数形式为: csi_error_t csi__init(csi_xxx_t *xxx, uint32_t idx); 以uart为例，其驱动函数的注册接口如下：csi_error_t csi_uart_init(csi_uart_t *uart, uint32_t idx); 参数：   uart：uart控制块    idx：uart设备号。如uart0，则idx = 0；返回值：   错误号：csi_error_t
4.2.2.2 注销
注销函数负责驱动的反初始化和硬件的反初始化 一般的，CSI驱动注销函数形式为：void csi__uninit(csi_xxx_t *xxx); 以uart为例，其驱动函数的注销接口如下：void csi_uart_uninit(csi_uart_t *uart); 参数：   uart：uart控制块 返回值：   注销函数没有返回值
" _5 R5 g+ l# Z! W2 \1 O. L
4.3 中断、回调和事件处理
! o" w7 L; K) I. |; U/ |CSI驱动接管设备中断处理，CSI接口用户无法直接编写中断处理函数。
& F& b4 D% B. Q$ Y用户可以通过回调函数的方式来接收中断事件。
4.3.1 回调注册
CSI驱动提供回调注册注销函数：csi_xxx_attach(...) 和 csi_xxx_detach(...) 用户要接收中断事件，必须先注册回调函数。

5 X% t" |  q+ d! Q4.4 同步异步处理
8 i; ]" q. I6 o; I4 f3 M( d# O" wCSI-Driver接口设计区分同步处理和异步处理模式，轮询、中断、DMA功能分开处理。同步读写：通过轮询的方式 异步读写：通过中断或DMA的方式
4.4.1 轮询模式
6 d2 V# K. F" ]- }$ w6 n! w1 V不产生中断
不产生事件
- q& f# \( z$ P1 o' P/ X4.4.2 中断模式
5 j$ o) Q8 X% D7 B  {产生设备中断
* d* F/ A9 h! j2 }) ~+ S产生事件
4.4.3 DMA模式
: m9 P! Z2 U; F/ `1 k- g' o不产生设备中断，而产生DMA中断
, I& L+ Y- _7 b# v产生的事件类型和中断模式一致
  X4 j! G$ F9 y9 t

dragongfly

来了来了，学习学习

STGing

来了来了，学习学习