
116
Reference Manual AFDX / ARINC 664 Application Interface Library
Section 4 – Function Reference: Transmitter Functions
4
4
.
.
3
3
.
.
4
4
D
D
a
a
t
t
a
a
B
B
u
u
f
f
f
f
e
e
r
r
F
F
u
u
n
n
c
c
t
t
i
i
o
o
n
n
s
s
4
4
.
.
3
3
.
.
4
4
.
.
1
1
F
F
d
d
x
x
C
C
m
m
d
d
T
T
x
x
B
B
u
u
f
f
f
f
e
e
r
r
Q
Q
u
u
e
e
u
u
e
e
A
A
l
l
l
l
o
o
c
c
Prototype:
AiReturn FdxCmdTxBufferQueueAlloc (AiUInt32 ul_Handle,
TY_FDX_TX_BUF_QUEUE_DESC *px_TxBufferQueueDesc,
TY_FDX_FW_BUF_HDL *px_TxBufferQueueHandle,
TY_FDX_TX_BUF_QUEUE_INFO *px_TxBufferQueueInfo)
Driver Command:
FDX_TX_BUF_QUEUE_ALLOC
Purpose:
This function allocates a Transmit Buffer Queue in the BIU associated memory (Global Ram) to
use it for commands which need a special associated buffer queue (e.g.
FdxCmdTxQueueWrite
for special Payload Buffer
Modes
). The Buffer Queue provides
administration and handling of a single or multiple Payload Buffers, which are organised in a
wrap around manner by the queue.
Input:
T
T
Y
Y
_
_
F
F
D
D
X
X
_
_
T
T
X
X
_
_
B
B
U
U
F
F
_
_
Q
Q
U
U
E
E
U
U
E
E
_
_
D
D
E
E
S
S
C
C
*
*
p
p
x
x
_
_
T
T
x
x
B
B
u
u
f
f
f
f
e
e
r
r
Q
Q
u
u
e
e
u
u
e
e
D
D
e
e
s
s
c
c
Structure which describes the Buffer Queue Parameter
typedef struct {
AiUInt32
ul_MaxTransfers;
AiUInt32
ul_BuffersInQueue;
AiUInt32
ul_BufferSize;
AiUInt32
ul_BufferQueueMode;
AiUInt32
ul_BufferIndex;
AiUInt32
ul_BufferPayloadMode;
}
TY_FDX_TX_BUF_QUEUE_DESC;
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
u
u
l
l
_
_
M
M
a
a
x
x
T
T
r
r
a
a
n
n
s
s
f
f
e
e
r
r
s
s
This parameter describes the maximum number of Transfers which share this Buffer Queue.
It is importand, that all transfers sharing this Buffer Queue are set up with the same Payload
Buffer Mode.
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
u
u
l
l
_
_
B
B
u
u
f
f
f
f
e
e
r
r
s
s
I
I
n
n
Q
Q
u
u
e
e
u
u
e
e
This parameter describes the number of Buffers in the Queue.
The size of each Buffer is given by the ul_BufferSize parameter. Therefore the total size of
allocated Buffer Memory is equal to ul_BufferSize * ul_BuffersInQueue plus an internal
overhead. The maximum number of buffers in a queue is 128. A value of zero is invalid for this
parameter. This number schould be given in power of 2 value. If not it will be aligned to the
next possible value (1, 2, 4, 8 … … 128).
A
A
i
i
U
U
I
I
n
n
t
t
3
3
2
2
u
u
l
l
_
_
B
B
u
u
f
f
f
f
e
e
r
r
S
S
i
i
z
z
e
e
Summary of Contents for AFDX / ARINC 664
Page 2: ......