AcQuisition Technology Quad M-module Carrier i4000 User Manual download pdf (Page 31)

APIS - AcQ Platform Interface Software

Programmer’s Manual Version: 2.1

AcQuisition Technology bv

P.O. Box 627, 5340 AP

Oss, The Netherlands

Page 29 of 77

4. APIS PLATFORM SUPPORT EXAMPLE

This chapter contains an example of the APIS implementation for the i4000 M-module carrier board

in an OS-9 environment. The name of the platform is ‘i4000os9'. In the appendix the source code

listings of the APIS for i4000/OS-9 can be found.

4.1. APPLICATION PROGRAMMING INTERFACE

The application programming interface of the i4000os9 APIS consists of the general definition file

apis.h and the platform dependent definition file apis_i4000os9.h.

For more information on the APIS application programming interface in general refer to section 3.3.

The file apis_i4000os9.h contains references to and macro definitions of the supported APIS

functions. Furthermore the file contains configurable macros:

Macro Name Default Description

APIS_MULTIPLATFORM undefined Must be defined for using the APIS in a

mult-platform environment.

i4000os9_DEFAULT_BASE 0xff800000 Base address used when the requested path ID

is zero.

i4000os9_DEFAULT_VECTOR 100 Interrupt vector used when the requested vector

is zero

i4000os9_DEFAULT_LEVEL 2 Interrupt level used when the requested

interrupt level is zero

The table below gives an overview of the available APIS functions:

APIS Function

platform_open

platform_close

platform_read

platform_write

platform_readblock

platform_writeblock

platform_readfifo

platform_writefifo

platform_irqinstall

platform_irqremove

platform_waitforirq

platform_waitforirqtmd

platform_criticalcode

platform_delay

platform_checkversion

platform_getversion

4.2. APIS PLATFORM SUPPORT MODULES

APIS for the i4000/OS-9 consists of two platform support modules:

! i4000os9_apis.c and i4000os9_apis.h containing the APIS function implementation

! apistrap, OS-9 trap-handler for handling interrupts and execution of critical code.

The APIS support library is available in ANSI-C source code: apis_i4000os9.c. The source code must

be compiled and linked to the application. The trap-handler apistrap is provided as an OS-9 module

and must be resident in memory or must be loadable via the execution path , details with respect to

the apistrap trap-handler are beyond the scope of this document.

1 2 ... 26 27 28 29 30 31 32 33 34 35 36 ... 78 79

Comments to this Manuals

No comments

AcQuisition Technology Quad M-module Carrier i4000 User Manual Page 31

Comments to this Manuals

Related products and manuals for Networking AcQuisition Technology Quad M-module Carrier i4000