Rtems例程解析

分析一：

/*

 *  Simple test program -- simplified version of sample test hello.

 *

 *  $Id: test.c,v 1.1.1.1 2009/08/06 20:25:58 joel Exp $

 */

#include <bsp.h>

#include <stdlib.h>

#include <stdio.h>

rtems_task Init(

  rtems_task_argument ignored

)

{

  printf( "\n\n*** HELLO WORLD TEST ***\n" );

  printf( "Hello World\n" );

  printf( "*** END OF HELLO WORLD TEST ***\n" );

  exit( 0 );

}

/* configuration information */

/* NOTICE: the clock driver is explicitly disabled */

#define CONFIGURE_APPLICATION_DOES_NOT_NEED_CLOCK_DRIVER

#define CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER

#define CONFIGURE_RTEMS_INIT_TASKS_TABLE

#define CONFIGURE_MAXIMUM_TASKS 1

#define CONFIGURE_INIT

#include <rtems/confdefs.h>

/* end of file */

分析1.

#define CONFIGURE_APPLICATION_DOES_NOT_NEED_CLOCK_DRIVER

#define CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER

这两个宏，用于选择打开或关闭相关设备的驱动。如第一项，关闭了时钟的驱动程序。第二项，打开了控制台的驱动程序。

分析2.

#define CONFIGURE_RTEMS_INIT_TASKS_TABLE

#define CONFIGURE_MAXIMUM_TASKS 1

第一项，API任务表初始化任务表相关选项。rtems/confdefs.h可以自动生成一个叫做Initialization_tasks的初始化任务表。而该选项就是其中一个控制如何生成该初始化任务表的一个参数。该项用来说明，用户是否希望使用Rtems API初始化任务表。用户可能使用其他API的初始化任务表或线程。默认，这一部分是不定义的，因此用户必须自己为初始化任务选择自己的API。

RTEMS API Confguration Table

typedef struct {

uint32_t maximum_tasks;

uint32_t maximum_timers;

uint32_t maximum_semaphores;

uint32_t maximum_message_queues;

uint32_t maximum_partitions;

uint32_t maximum_regions;

uint32_t maximum_ports;

uint32_t maximum_periods;

uint32_t maximum_barriers;

uint32_t number_of_initialization_tasks;

rtems_initialization_tasks_table *User_initialization_tasks_table;

} rtems_api_configuration_table;

number of initialization tasks

配置的初始化任务数。至少有一个Rtems初始化或者Posix初始化操作，用户的应用程序从这里开始执行。当用rtems/confdefs.h来配置用户应用程序时，该项参数必须配置，以此来说明有一个或多个Rtems初始化程序。

下面这些宏，与单一初始化任务涉及到的内容。

CONFIGURE_INIT_TASK_NAME

CONFIGURE_INIT_TASK_STACK_SIZE 单一初始化任务，堆栈的大小。

CONFIGURE_INIT_TASK_PRIORITY

CONFIGURE_INIT_TASK_ATTRIBUTES 单初始化任务的属性。默认被设置为RTEMS_DEFAULT_

ATTRIBUTES 。

CONFIGURE_INIT_TASK_ENTRY_POINT 初始化任务函数入口地址。默认设置为用C实现的Init例程。

CONFIGURE_INIT_TASK_INITIAL_MODES 初始化任务执行的模式。

这些宏具体是如何完成赋值的？赋值完成后，初始化任务表便有了具体的值。初始化任务表自然是为初始化任务服务。初始化任务在整个系统中又具有什么作用？

分析3.

#define CONFIGURE_INIT 

CONFIGURE_INIT常量必须给予定义，因为这可以让rtems/confdefs.h将配置的数据结构实例化。在一个应用程序中，这个只能定义一次。

分析二：

/*

* This file contains an example of a simple RTEMS

* application. It instantiates the RTEMS Configuration

* Information using confdef.h and contains two tasks:

* a * user initialization task and a simple task.

*

* This example assumes that a board support package exists.

*/

#include <rtems.h>

rtems_task user_application(rtems_task_argument argument);

rtems_task init_task(

rtems_task_argument ignored

)

{

rtems_id tid;

rtems_status_code status;

rtems_name name;

name = rtems_build_name( ’A’, ’P’, ’P’, ’1’ )

status = rtems_task_create(

name, 1, RTEMS_MINIMUM_STACK_SIZE,

RTEMS_NO_PREEMPT, RTEMS_FLOATING_POINT, &tid

);

if ( status != RTEMS_STATUS_SUCCESSFUL ) {

printf( "rtems_task_create failed with status of %d.\n", status );

exit( 1 );

}

status = rtems_task_start( tid, user_application, 0 );

if ( status != RTEMS_STATUS_SUCCESSFUL ) {

printf( "rtems_task_start failed with status of %d.\n", status );

exit( 1 );

}

status = rtems_task_delete( SELF ); /* should not return */

printf( "rtems_task_delete returned with status of %d.\n", status );

exit( 1 );

}

rtems_task user_application(rtems_task_argument argument)336 RTEMS C User’s Guide

{

/* application specific initialization goes here */

while ( 1 ) { /* infinite loop */

/* APPLICATION CODE GOES HERE

*

* This code will typically include at least one

* directive which causes the calling task to

* give up the processor.

*/

}

}

#define CONFIGURE_APPLICATION_NEEDS_CONSOLE_DRIVER /* for stdio */

#define CONFIGURE_APPLICATION_NEEDS_CLOCK_DRIVER /* for time services */

#define CONFIGURE_MAXIMUM_TASKS 2

#define CONFIGURE_INIT_TASK_NAME rtems_build_name( ’E’, ’X’, ’A’, ’M’ )

#define CONFIGURE_RTEMS_INIT_TASKS_TABLE

#define CONFIGURE_INIT

#include <confdefs.h>