Aim MIL-STD-1553 - Apiopen

MIL-STD-1553 Reference Manual
43
Chapter 2 - Library Administration and Initialization Functions
2.1.17 ApiOpen
Prototype:
AyI/AyX/AMC/APM: AiInt16 ApiOpen( AiUInt8 uc_Module, AiChar *ac_SrvName,
AiUInt32 *pul_ModuleHandle );
AVI/AVX: short ApiOpen( UINT8 bModule );
Driver Command:
none
Purpose:
Note: This command is obsolete and only maintained for compatibility reasons!
We recommend to use ApiOpenEx() instead!
This function initializes the Application Interface for the specified module and must be
called first, before any other API S/W Library function is used for the specified module.
This function establishes connectivity between the Application Interface and the AIM
board by calling operating system routines to open the AIM board and initialize a
shared memory area for host-to-target communication.
Note: To open the board communication you need to call either ApiOpen() or
ApiOpenEx(), but not both!
Input
A
A
i
i
U
U
I
I
n
n
t
t
8
8
u
u
c
c
_
_
M
M
o
o
d
d
u
u
l
l
e
e
Board Module Number to access
Value
Constant
Description
0
API_MODULE_1
Module 1
1
API_MODULE_2
Module 2
2
API_MODULE_3
Module 3
3
API_MODULE_4
Module 4
…
31
API_MODULE_32
Module 32
A
A
i
i
C
C
h
h
a
a
r
r
*
*
a
a
c
c
_
_
S
S
r
r
v
v
N
N
a
a
m
m
e
e
(
(
o
o
n
n
l
l
y
y
A
A
P
P
I
I
/
/
A
A
C
C
I
I
b
b
o
o
a
a
r
r
d
d
s
s
)
)
Name of the PC, where the ANS Server is running.
Value
Description
"local"
Local use of the board
<SrvName>
Name of the PC, where the ANS (AIM Network Server) is running
(e.g. “\\SW-PC-06” or “192.168.0.119”)
Output
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
*
*
p
p
u
u
l
l
_
_
M
M
o
o
d
d
u
u
l
l
e
e
H
H
a
a
n
n
d
d
l
l
e
e
API Board Module Access Handle
Note: pul_ must be used as input for all other functions. ModuleHandle