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

APIS - AcQ Platform Interface Software

Programmer’s Manual Version: 2.1

AcQuisition Technology bv

P.O. Box 627, 5340 AP

Oss, The Netherlands

Page 31 of 77

4.4. FUNCTION REFERENCE

In this section the function provided to the application provided by the i4000/OS-9 APIS are

described:

_i4000os9_open() Open hardware path

Syntax: int _i4000os9_open (APIS_PATH path, APIS_HANDLE *handle, ...);

Description: A physical path will be opened for the requested hardware address, memory size

(msize) and M-module access type (mtype). The supplied path ID must be the

physical M-module address. If the path ID is zero the default M-module base address

is used. The M-module access parameters (size and mtype) have no function (on the

i4000) but must be provided for compatibility reasons. The requested size and mtype

are checked against the following i4000 limitations: size, 0x100 max. mtype, only

A08D16 supported. This routine will request access permission to the physical

memory. Next, memory for the path information is allocated and the path information

structure is initialized. If the link count is zero the process links to the apistrap

trap-handler. The trap-handler runs in system state and will be used for installation of

interrupt routines and for execution of critical user code (with interrupts masked).

Finally the pointer to the path info structure is passed to the caller via the handle and

the link count is incremented.

Arguments: APIS_PATH path

Path ID, must be either a valid M-module address or zero for the default

M-module address

APIS_HANDLE *handle

Pointer to hardware-path information structure

... Variable argument list:

UINT32 size

Memory size (0 <= size <= 0x100)

UINT32 mtype

M-module access type (mtype == A08D16)

Returns: APIS error code

_i4000os9_close() Close hardware path

Syntax: int _i4000os9_close(APIS_HANDLE handle);

Description: Decrement link count, disable interrupt, remove interrupt handler, free allocated

memory, and return 0 if the link count reaches zero, unlink the trap-handler. When

the link count is already zero the function just returns.

Arguments: APIS_HANDLE handle

Hardware path handle

Returns: APIS error code

1 2 ... 28 29 30 31 32 33 34 35 36 37 38 ... 78 79

Comments to this Manuals

No comments

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

Comments to this Manuals

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