跳至主要内容

【转】VxWorks编程常用函数说明

时间:2008-8-5    来源:网络   编辑:Admin 浏览次数:2766

这两天在看VxWorks下的socket网络方面的编程,其中涉及到不少VxWorks下的函数使用,在网上搜了半天觉得这个很不错,于是将其copy下来。最后给出了copy的链接。

vxWorks编程指南



一、官方的Program Guide
位于安装目录下:\docs\vxworks\guide\index.html

二、常用的库:
#i nclude "taskLib.h" /* 任务 */
#i nclude "msgQLib.h" /* 消息队列 */
#i nclude "semLib.h" /* 信号量 */
#i nclude "ioLib.h" /* IO */
#i nclude "wdLib.h" /* Watch dog */
#i nclude "logLib.h" /* 信息输出 */
#i nclude "socket.h" /* 网络套接字 */

三、IO系统:ioLib.h
1、系统中的IO设备,包括键盘、串口、文件等,都用统一的接口访问。第一步通常先得到文件描述符,然后进行读写或者设置的工作,最后关闭该描述符。
creat:建立文件
open:得到文件或设备的描述符
read:读文件或设备
write:写文件或设备
ioctl:设置参数
close:关闭文件描述符
remove:删除文件

2、内存文件
memDrv( ) - 初始化伪内存设备
memDevCreate( ) - 建立伪内存设备
memDevCreateDir( ) - 建立一组伪内存设备
memDevDelete( ) - 删除伪内存设备

Init() {
uchar_t buffer[1024];
int fd;
memDrv( );
memDevCreate("/mem/mem1", buffer, sizeof(buffer));
if ((fd = open("/mem/mem1", O_RDWR, 0644)) != ERROR) {
write(fd, &data, sizeof(data));
... ...
close(fd);
}
memDevDelete("/mem/mem1");
}

3、通过Select函数实现多个IO监听:selectLib.h
当等待多个IO时,我们可以使用Select函数,fd为文件描述符:
int select(
int width, /* 最大的fd,或直接FD_SETSIZE (2048) */
fd_set * pReadFds, /* 读的fd集合 */
fd_set * pWriteFds, /* 写的fd集合 */
fd_set * pExceptFds, /* vxWorks不支持,NULL */
struct timeval * pTimeOut /* 等待时间, NULL = forever */
)
还有几个宏:
FD_SET(fd, &fdset) 设置fd的监听位
FD_CLR(fd, &fdset) 清除fd的监听位
FD_ZERO(&fdset) 清除所有监听位
FD_ISSET(fd, &fdset) fd是否有数据
例子,其中MAX意为取最大值:
Init() {
struct fd_set readFds;
int fds[4];
int width;

fds[0] = open(..);... ...;fds[3] = open(..); /* 打开IO */
width = MAX(fds[0], ... ... , fds[3])+1; /* fd的最大值+1 */
/* FOREVER {*/
FD_ZERO(&readFds); /* 设置fd_set结构 */
FD_SET(fds[0], & readFds);... ...; FD_SET(fds[3], & readFds);

if (select(width, &readFds, NULL, NULL, NULL) == ERROR) { /*监听*/
close(fds[0]); ... ...; close(fds[3]);
return;
}
for(i=0; i
if (FD_ISSET(fds[i], &readFds)) {
... ...; /* 进行读写操作 */
}
}
/* } */
}

四、多任务环境的编程:
1、任务控制:taskLib.h
taskSpawn( ) - 创建任务
taskInit( ) -初始化任务,用户自己指定栈和PCB地址
taskActivate( ) - 激活已经初始化的任务
exit( ) - 在任务中结束 (ANSI)
taskDelete( ) - 删除任务
taskDeleteForce( ) - 强制删除,即使被保护
taskSuspend( ) - 挂起任务
taskResume( ) - 恢复挂起的任务
taskRestart( ) - 重新启动任务
taskPrioritySet( ) - 改变任务优先级
taskPriorityGet( ) - 读取任务优先级
taskLock( ) - 禁止任务调度
taskUnlock( ) - 允许任务调度
taskSafe( ) - 保护任务不被删除
taskUnsafe( ) - 解除保护
taskDelay( ) - 延时
taskIdSelf( ) - 得到当前任务的ID
taskIdVerify( ) - 任务ID是否存在
taskTcb( ) - 得到任务控制块(TCB)的地址
taskOptionsSet( ) - 改变任务选项
taskOptionsGet( ) - 得到任务当前选项
taskRegsGet( ) - 得到任务TCB中寄存器的信息
taskRegsSet( ) - 设定任务TCB中寄存器的信息
taskName( ) - 得到任务名称
taskNameToId( ) - 由名称得到ID
taskIdDefault( ) - 设置默认的任务ID
taskIsReady( ) - 任务是否就绪
taskIsSuspended( ) - 任务是否挂起
taskIdListGet( ) - 得到活动的任务列表

2、任务互斥 - 信号量:semLib.h
semGive( ) � 释放一个信号量
semTake( ) � 获取一个信号量,会阻塞
semFlush( ) � 使所有阻塞在本信号量上的任务变为就绪状态
semDelete( ) � 删除一个信号量
1)二进制信号量:semBCreate
可用于任务同步和互斥,但常用于任务同步
2)互斥信号量:semMCreate
专门用于任务互斥的信号量,保护临界资源
3)计数信号量:semCCreate
多实例资源的访问控制

3、任务同步
1)消息队列:msgQLib.h
消息队列
msgQCreate( ) - 创建消息队列
msgQDelete( ) - 删除消息队列
msgQSend( ) - 发送消息
msgQReceive( ) - 接受消息,调用后阻塞
msgQNumMsgs( ) - 得到消息队列中的消息数量

Init() {
/* 创建消息队列 */
if ((msgQID = msgQCreate(8, 1, MSG_Q_FIFO)) == NULL) {
printf("Message queue create failed!\n");
}
}

taskSend() {
if (OK != msgQSend(msgQID, "A", 1, NO_WAIT, MSG_PRI_NORMAL)) {
printf("Message send failed!");
}
}

taskReceive() {
uchar_t ch;
msgQReceive(msgQID, &ch, 1, WAIT_FOREVER); /* 这里任务会阻塞 */
printf("Received from msgq: %c ", ch);
}

2)管道:ioLib.h,系统默认包含了pipe驱动组件
pipeDevCreate( ) - 创建管道
pipeDevDelete( ) - 删除管道
由于管道属于IO,所以可以使用Select监听,消息队列不是IO,不能使用Select

Init() {
/* 创建管道 */
if (pipeDevCreate("/pipe/mypipe", 8, 1) != OK) {
printf("/pipe/mypipe create fialed!\n");
}
/* 创建互斥信号量 */
if ((semMID = semMCreate(SEM_Q_FIFO)) == NULL)
{
printf("Mutex semaphore create failed!\n");
}
}

taskSend() {
int pd; /* pipe的描述符 */
if ((pd = open("/pipe/mypipe", O_WRONLY, 0644)) == ERROR) {
printf("Open pipe failed!");
}
if (semTake(semMID, NO_WAIT) == ERROR) {
printf("Pipe in use!");
}
write(pd, "a", 1);
semGive(semMID);
close(pd);
}

taskReceive() {
int pd; /* pipe的描述符 */
uchar_t ch;
if ((pd = open("/pipe/mypipe", O_RDONLY, 0644)) == ERROR) {
printf("Open pipe failed!");
}
if (read(pd, &ch, 1)>0) { /* 这里任务会阻塞 */
printf("Received from pipe: %c", ch);
}
}

3)二进制信号量
Init() {
/* 创建二进制信号量 */
if ((semBID = semBCreate(SEM_Q_FIFO, SEM_EMPTY)) == NULL) {
printf("Binary semaphore create failed!\n");
}
}

taskSend() {
semGive(semBID);
}

taskReceive() {
semTake(semBID, WAIT_FOREVER); /* 这里任务会阻塞 */
}

4)事件:eventLib
发送事件要指定目标任务的ID
eventReceive( ) - 等待事件
eventSend( ) - 发送事件
eventClear( ) - 清除当前任务的事件.

taskSend() {
if (OK != eventSend(taskReceiveID, 0x00000001)) {
printf("Event send failed!");
}
}

taskReceive() {
UINT32 Ev;
if (OK!=eventReceive(0x00ffffff, EVENTS_WAIT_ANY, WAIT_FOREVER, &Ev)) {
printf("eventReceive Error!\n");
}
else {
Ev &= 0x00000001;
if (Ev) {
printf("Event %d received!", Ev);
}
}
}

五、Watch dog :wdLib.h
系统提供了软看门狗定时器,使用也简便:
wdCreate( ) - 创建看门狗
wdDelete( ) - 删除
wdStart( ) - 启动
wdCancel( ) - 停止

Init() {
/* 创建看门狗 */
if ((wdID = wdCreate()) == NULL) {
printf("Watch dog create failed!\n");
}
}

task() {
if (OK != wdStart(wdID, sysClkRateGet()*5, proc_wd, 0)) {
printf("Watch dog start failed!\n");
}
}

int proc_wd(int param) {
logMsg(... ...);
}

六、网络编程:sockLib.h
使用标准的BSD Socket套接字,使用TCP或者UDP协议进行通讯。
socket( ) - 打开套接字
bind( ) - 与端口、地址等绑定
listen( ) - 监听模式
accept( ) - 允许对方的连接
connect( ) - 主动与远端连接
connectWithTimeout( ) - 超时功能的connect函数
sendto( ) - 发送
send( ) - 发送
sendmsg( ) - 发送
recvfrom( ) - 接收
recv( ) - 接收
recvmsg( ) -接收
setsockopt( ) - 设定套接字参数
getsockopt( ) - 得到套接字参数
getsockname( ) - 得到套接字名称
getpeername( ) -得到连接的对点的名称
shutdown( ) - 关闭连接

七、异常处理
1、错误号:errnoLib.h
32位有符号整数,1~500被系统占用,其他程序内可用。如
#define MEMORY_LEAK 0x20005
errnoGet( ) - 得到当前任务的错误号
errnoOfTaskGet( ) - 得到指定任务的错误号
errnoSet( ) - 设定当前任务的错误号
errnoOfTaskSet( ) - 设定指定任务的错误号

2、信号:sigLib.h
signal( ) - 指定信号的入口函数
raise( ) - 发送信号给当前任务
kill( ) - 发送信号给指定任务

task1() {
signal(30, proc_sig); /* 注册30号的信号 */
/* raise(30); */
}

task2() {
kill(task1ID, 30);
}

void proc_sig(int param) {
logMsg("Error message...");
}

八、中断:iv.h
x86的0x0~0xf号中断对应vxWorks中0x20~0x2f号中断
以9号中断为例:
初始化中断:
intConnect( INUM_TO_IVEC(9+0x20), Int9Handler, 0); /* 绑定中断函数 */
sysIntEnablePIC(9); /* 使能9号中断 */

中断函数原型:
void Int9Handler(int Param); /* 注意中断函数中不要调用阻塞函数 */

评论

此博客中的热门博文

【转】cs8900网卡的移植至基于linux2.6内核的s3c2410平台

cs8900网卡的移植至基于linux2.6内核的s3c2410平台(转) 2008-03-11 20:58 硬件环境:SBC-2410X开发板(CPU:S3C2410X) 内核版本:2.6.11.1 运行环境:Debian2.6.8 交叉编译环境:gcc-3.3.4-glibc-2.3.3 第一部分 网卡CS8900A驱动程序的移植 一、从网上将Linux内核源代码下载到本机上,并将其解压: #tar jxf linux-2.6.11.1.tar.bz2 二、打开内核顶层目录中的Makefile文件,这个文件中需要修改的内容包括以下两个方面。 (1)指定目标平台。 移植前:         ARCH?= $(SUBARCH) 移植后: ARCH            :=arm (2)指定交叉编译器。 移植前: CROSS_COMPILE ?= 移植后: CROSS_COMPILE   :=/opt/crosstool/arm-s3c2410-linux-gnu/gcc-3.3.4-glibc-2.3.3/bin/arm-s3c2410-linux-gnu- 注:这里假设编译器就放在本机的那个目录下。 三、添加驱动程序源代码,这涉及到以下几个方面。(1)、从网上下载了cs8900.c和cs8900.h两个针对2.6.7的内核的驱动程序源代码,将其放在drivers/net/arm/目录下面。 #cp cs8900.c ./drivers/net/arm/ #cp cs8900.h ./drivers/net/arm/ 并在cs8900_probe()函数中,memset (&priv,0,sizeof (cs8900_t));函数之后添加如下两条语句: __raw_writel(0x2211d110,S3C2410_BWSCON); __raw_writel(0x1f7c,S3C2410_BANKCON3); 注:其原因在"第二部分"解释。 (2)、修改drivers/net/arm/目录下的Kconfig文件,在最后添加如...

【转】嵌入式开发中使用DDD进行调试

 在嵌入式程序开发过程中,程序员要进行大量的调试,以此验证程序的正确性,修改潜在的错误。调试器对于程序员来说是不可或缺的必备工具。在Linux环境中,有很多调试工具和调试辅助工具,例如GDB、XXGDB、RHIDE、XWPE、GVD和DDD等。其中,DDD是命令行调试器的图形前端,除了一般的程序调试功能以外,还具有交互式图形数据显示的功能。它在嵌入式应用开发中也十分出色。本文主要讲述DDD(Data Display Debugger)的使用方法。      1.认识DDD     GNU DDD是命令行调试程序,如GDB、DBX、WDB、Ladebug、JDB、XDB、Perl Debugger或Python Debugger的可视化图形前端。它特有的图形数据显示功能(Graphical Data Display)可以把数据结构按照图形的方式显示出来。DDD最初源于1990年Andreas Zeller编写的VSL结构化语言,后来经过一些程序员的努力,演化成今天的模样。DDD的功能非常强大,可以调试用C\C++、Ada、 Fortran、Pascal、Modula-2和Modula-3编写的程序;可以超文本方式浏览源代码;能够进行断点设置、回溯调试和历史纪录编辑;具有程序在终端运行的仿真窗口,并在远程主机上进行调试的能力;图形数据显示功能(Graphical Data Display)是创建该调试器的初衷之一,能够显示各种数据结构之间的关系,并将数据结构以图形化形式显示;具有GDB/DBX/XDB的命令行界面,包括完全的文本编辑、历史纪录、搜寻引擎。     DDD是开源软件,用户可以去 http://www.cs.tubs.de/softech/ddd/ 下载.rpm格式的DDD源码文件。      图1显示的是DDD的主窗口。它主要由选单栏、工具条、数据窗口、源文件窗口、机器码窗口、控制台和命令工具窗口等几部分组成。其中,数据窗口用于观察复杂的数据结构,在删除数据之后,显示仍然有效;源文件窗口显示源代码、断点和当前执行到达的位置,选择该窗口中的"Display"项,可以显示任意表达式的值;机...

【转】函数指针和指针函数

【函数指针】        在程序运行中,函数代码是程序的算法指令部分,它们和数组一样也占用存储空间,都有相应的地址。可以使用指针变量指向数组的首地址,也可以使用指针变量指向函数代码的首地址,指向函数代码首地址的指针变量称为函数指针。 1.函数指针定义 函数类型 (*指针变量名)(形参列表); "函数类型"说明函数的返回类型,由于"()"的优先级高于"*",所以指针变量名外的括号必不可少,后面的"形参列表"表示指针变量指向的函数所带的参数列表。 例如: int (*f)(int x); double (*ptr)(double x); 在定义函数指针时请注意:     函数指针和它指向的函数的参数个数和类型都应该是―致的; 函数指针的类型和函数的返回值类型也必须是一致的。 2.函数指针的赋值 函数名和数组名一样代表了函数代码的首地址,因此在赋值时,直接将函数指针指向函数名就行了。 例如, int func(int x);   /* 声明一个函数 */ int (*f) (int x);    /* 声明一个函数指针 */ f=func;            /* 将func函数的首地址赋给指针f */ 赋值时函数func不带括号,也不带参数,由于func代表函数的首地址,因此经过赋值以后,指针f就指向函数func(x)的代码的首地址。 3.通过函数指针调用函数 函数指针是通过函数名及有关参数进行调用的。 与其他指针变量相类似,如果指针变量pi是指向某整型变量i的指针,则*p等于它所指的变量i;如果pf是指向某浮点型变量f的指针,则*pf就等价于它所指的变量f。同样地,*f是指向函数func(x)的指针,则*f就代表它所指向的函数func。所以在执行了f=func;之后,(*f)和func代表同一函数。 由于函数指针指向存储区中的某个函数,因此可以通过函数指针调用相应的函数。现在我们就讨论如何用函数指针调用函数,它应执行下面三步: 首先,要说明函数指针变量。 例如:int (*f)...