Aim MIL-STD-1553 - BUS CONTROLLER FUNCTIONS

MIL-STD-1553 Reference Manual
179
Chapter 5 – Buffer Functions
5.1.16 ApiReadBlockMemData
Prototype:
AiInt16 ApiReadBlockMemData( AiUInt32 ul_ModuleHandle, AiUInt8 memtype,
AiUInt32 offset, AiUInt8 width, void* data_p,
AiUInt32 size, AiUInt32 *pul_BytesRead );
Driver Command:
none
Purpose:
This function is used to read a data block from AIM board memory in avoidance of AIM
board command and acknowledge interface access. This is necessary to access the
board memories in case of interrupt. The function does a direct access to the AIM
board memory at the specified offset address .
I
I
n
n
p
p
u
u
t
t
A
A
i
i
U
U
I
I
n
n
t
t
8
8
m
m
e
e
m
m
t
t
y
y
p
p
e
e
Memory Type to be accessed
Value
Constant
Description
0
API_MEMTYPE_GLOBAL
Global Memory access
1
API_MEMTYPE_SHARED
Shared Memory access
2
API_MEMTYPE_LOCAL
Local Memory access
3
4
5
API_MEMTYPE_IO
API_MEMTYPE_GLOBAL
_DIRECT
API_MEMTYPE_GLOBAL
_EXTENSION
IO/Galileo Memory access
Direct access to Global Memory
even if there is a mirror
Global Memory Extension
access
Note: not all memory types are available for all boards.
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
o
o
f
f
f
f
s
s
e
e
t
t
Byte offset address relative to the start of a specific onboard memory described in
parameter ‘memtype’.
A
A
i
i
U
U
I
I
n
n
t
t
8
8
w
w
i
i
d
d
t
t
h
h
Data width of access
Value
synonym
Description
1
sizeof(AiUInt8)
Byte data access
2
sizeof(AiUInt16)
Word data access
4
sizeof(AiUInt32)
Longword data access
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
s
s
i
i
z
z
e
e
Amount of data block elements