Aim MIL-STD-1553 - Apiwriteblockmemdata

MIL-STD-1553 Reference Manual
183
Chapter 5 – Buffer Functions
5.1.18 ApiWriteBlockMemData
Prototype:
AiInt16 ApiWriteBlockMemData( AiUInt32 ul_ModuleHandle, AiUInt8 memtype,
AiUInt32 offset, AiUInt8 width, void* data_p,
AiUInt32 size, AiUInt32 *pul_BytesWritten );
Driver Command:
none
Purpose:
This function is used to write a data block to 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
–
–
M
M
e
e
m
m
o
o
r
r
y
y
T
T
y
y
p
p
e
e
t
t
o
o
b
b
e
e
a
a
c
c
c
c
e
e
s
s
s
s
e
e
d
d
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
Global Memory access
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
v
v
o
o
i
i
d
d
*
*
d
d
a
a
t
t
a
a
_
_
p
p
Data to write from. This pointer should match the data size given in the parameter width.
Note: Be sure to have allocated enough memory referenced by this pointer
within the application!