C 语言的语法

#include <file.h>

int add_device(char * name,
unsigned flags ,
int (* dopen)(const char *path, unsigned flags, int llv_fd),
int (* dclose )( int dev_fd),
int (* dread)(intdev_fd, char *buf, unsigned count),
int (* dwrite )(int dev_fd, const char *buf, unsigned count),
off_t (* dlseek )(int dev_fd, off_t ioffset, int origin),
int (* dunlink )(const char *path),
int (* drename )(const char *old_name, const char *new_name));

定义位置

lowlev.c（在编译器安装程序的 lib/src 子目录中）

说明

add_device 函数将器件记录添加至器件表，以便在 C 语言中将该器件用于 I/O。器件表中的第一个条目预定义为运行调试器的主机器件。add_device() 函数会在器件表中查找第一个空位置，然后对表示器件的结构字段进行初始化。

若要在新添加的器件上打开一个流，请使用 fopen( ) 并以 devicename :filename 格式的字符串作为第一个参数。

• name 是表示器件名称的字符串，上限为 8 个字符。
• flags 是器件特性，具体如下：

  _SSA 表示器件一次仅支持一个开放流

  _MSA 表示器件支持多个开放流

  通过在 file.h 中进行定义，可以添加更多的标志。

• dopen、dclose、dread、dwrite、dlseek、dunlink 和 drename 说明符均为函数指针，指向器件驱动程序中的函数，这些函数由低级函数调用，用于在指定的器件上执行 I/O。您必须使用节 7.2.2部分中指定的接口来声明这些函数。用于运行 ARM 调试器的主机所适用的器件驱动程序包含在 C I/O 库中。

返回值

该函数将返回以下值之一：

示例

Example7-2 将执行以下操作：

• 将器件 mydevice 添加至器件表
• 打开该器件上名为 test 的文件并将其与 FILE 指针 fid 关联
• 将字符串 Hello, world 写入该文件
• 关闭该文件