4Links Diagnostic SpaceWire Interface DSI-RG408, Руководство пользователя

Страница: 71 / 130

Diagnostic SpaceWire Interface
EtherSpaceLink family User Manual
17. 6 . 6 .
EtherSpaceLink_write_packet()
S ynops i s
int EtherSpaceLink_write_packet ( EtherSpaceLink DSI_unit,
void * buffer,
int length,
int terminator
)
D esc ri pt i on
EtherSpaceLink_write_packet()
s
en
ds da
t
a
v
i a
t
h
e
E
t
h
e
r
S
pac
eL
i
n
k
un
i
t to t
h
e S
pac
e
W ir
e
l i n k . Th e bu ff e r m ay c ont a i n a ll , o r pa r t , o f a pack et as i n d i ca te d b y t h e f i n a l pa r a mete r,
terminator
.
Acc e p t a ble v a lue s f o r
terminator
a r e :
EtherSpaceLink_EOP
Th i s i s t h e l as t pa r t , o r a ll , o f a da t a pack et; a n en d- o f-
pack et ( EO P) i s add e d .
EtherSpaceLink_EEP
Th i s i s t h e l as t pa r t , o r a ll , o f a da t a pack et; a n e rr o r en d-
o f-pack et ( EE P) i s add e d .
EtherSpaceLink_PART_EOP_EEP
Th i s i s pa r t o f a da t a pack et; no en d- o f-pack et i s add e d .
EtherSpaceLink_EXTN
Th i s i s a c
om
p
lete “exten
s i
on”
cha r ac
te
r s
e
q
uen
c
e.
E
xten
s i
on
pack
et
s ha
ve
a
m
a
x
i
mum len
g
t
h
o
f 6
0 b
y
te
s
.
EtherSpaceLink_SPECIAL
Th i s i s a c
om
p
lete “
sp
e
c i a
l”
pack
et.
EE P w oul d not no r m a ll y be u s e d to te r m i n a te a pack et but i s a v a i l a ble h e r e to ass i s t w i t h te s t i n g wh e r e
a
n e
rr
oneou
s pack
et m
ay
u
s
e
f
ull
y
be
g
ene
r a
te
d
.
D a t a i s q ueue d i n bu ff e r s i n t h e A P I i n o r d e r to m ak e be s t u s e o f t h e TC P/ I P s t r e a m a n d m ay not be
s
ent
i
mme
d i a
tel
y
.
EtherSpaceLink_flush()
sh
oul
d
be u
s
e
d
to en
s
u
r
e t
h
e
i
mme
d i a
te
t r a n s m i ss i on o f a n y bu ff e r e d da t a .
Th
e one
-cha r ac
te
r
exten
s i
on
s
e
q
uen
c
e
s
m
ay
be
s
ent u
s i
n
g
EtherSpaceLink_write_EXTN()
.
Th e f ull l i s t o f exten s i on s e q uen c e s i s p r ov i d e d i n s e c t i on
1 7
.
6
.
7,
“
EtherSpaceLink_write_EXTN()
”.
I nput p ara mete r s
DSI_unit
t
h
e
ha
n
d
le
r
etu
r
ne
d
b
y a s
u
cc
e
ssf
ul
EtherSpaceLink_open()
c
omm
a
n
d
.
buffer
a bu ff e r c ont a i n i n g t h e da t a to be s ent
length
t
h
e numbe
r
o
f
b
y
te
s
o
f da
t
a
to
s
en
d
.
terminator
i
n
d i ca
te
s wh
et
h
e
r
t
h i s i s pa r
t o
f a pack
et
, a
no
r
m
a
l
pack
et o
r a
n e
rr
o
r
4Links Limited
www.4Links.co.uk
support@4Links.co.uk
page 71 of 130
T +44 1908 642001; F +44 1908 363463
Milton Keynes MK3 6EB, UK
Suite EU2, Bletchley Park