4Links EtherSpaceLink Series, Руководство пользователя

Страница: 45 / 110

EtherSpaceLink-RG408
EtherSpaceLink family User Manual
A bette r w a y t o dete r m i ne t h e st a t u s o f a l i n k i s t o i ss u e t h e r e q u est embedded i n t h e r ou t i nes
l i sted
a
b o v e u s i n g
EtherSpaceLink_write_packet(EtherSpaceLink_SPECIAL)
, t o
w a i t f o r t h e a s y n ch r o n ou s st a t u s i nd i ca t i o n u s i n g
EtherSpaceLink_read_packet_full()
,
a
nd t o p r o
c
ess t
h
e r es po nse w
h
en i t
a
rriv es.
14.5.4. Us i n g M ult i ple Th r e ad s Sa fely
It i s po ss i b l e t o r u n t h r e a ds i n t h e A P I a ppl i ca t i o n o n t h e h o st c o m pu te r, a nd t h i s ca n s i m pl i f y i ts
st r
u c
t
u
r e
- a
t
a c o
st
o f
m
a
n
a
gi n g t
h
e
c o
n
c u
rr en
c y p
r
op
e r
ly
.
T yp
i
ca lly
i n
E
t
h
e rS
p ac
eL i n
k p
r
o
gr
a
ms ,
t wo t h r e a ds a r e u sed:
o
ne t
h
r e
a
d g ene r
a
tes t r
aff
i
c a
nd sends i t
o
n S
p ac
e
W
ir e t
o
t
h
e
c o
nne
c
ted i nst r
u
ment vi
a
t
h
e
E t h e rS p ac eL i n k u n i t;
t
h
e se
c
o nd t
h
r e
a
d r e
a
ds
a
ll o
f
t
h
e t r
aff
i
c
t
ha
t i s r et u r ned
f
r o m t
h
e E t
h
e rS p
ac
eL i n k u n i t t o t
h
e
h
o st
c o
m
pu
te r, de
-
i nte r
l
e
a
v es i t , r e
c o
r ds i t ,
a
nd
po
ss i b
ly u
ses t
h
e i n
f o
r m
a
t i
o
n r e
c
e iv ed t
o
g ene r
a
te
f
u r t
h
e r ou t g o i n g S p
ac
e
W
ir e t r
aff
i
c
.
Th
e r em
a
i n i n g i ss
u
e i s
h ow
t
o
s
af
e
ly p a
ss i n
f o
r m
a
t i
o
n
f
r
o
m t
h
e r e
c
e iv e t
h
r e
a
d b
ac k
t
o
t
h
e t r
a
nsm i t
t h r e a d. Th i s m u st be d o ne u s i n g sem a p h o r es o r o t h e r f o r ms o f m u t u a l e x c lu s i o n t o ens u r e t ha t r ac e
c o
nd i t i
o
ns
a
nd
c o
n
c u
rr ent
w
ri tes t
o
v
a
ri
a
b
l
es
a
r e n
o
t
po
ss i b
l
e.
T
r
a
ns
f
e rri n g s i m
pl
e st
a
t
u
s i n
f o
r m
a
t i
o
n
f r o m t h e r e c e ivi n g t h r e a d b ac k t o t h e t r a nsm i tt i n g t h r e a d i s u s u a lly st r a ig h t f o r w a r d.
SpW.c
a
nd t
h
e e x
a
m
pl
e i n se
c
t i
o
n 1
4
.
5
. 6, “
A
n
A
d v
a
n
c
ed
A P
I
E
x
a
m
pl
e
”
,
c o
nt
a
i ns e x
a
m
pl
e
c o
de t
o
i llu st r a te t h e u se o f m ul t i pl e t h r e a ds.
14.5.5. Maxi m i s i n g the Th r ou g hput of A P I P r o gra ms
E
S L
u
n i ts s
uppo
r t j
u
st
o
ne
ac
t iv e S
p ac
e
W
ir e
po
r t ,
a
nd d
a
t
a f o
r t
h
i s
ca
n be st r e
a
med
f
r
o
m
a
s i m
pl
e
a ppl i ca t i o n w i t h ou t p a r t i c ul a r p e r f o r m a n c e c o n c e r ns.
14.5. 6 . A n Adva nce d A P I E xa mple
Th e f ollow i n g p r o gr a m u ses t wo t h r e a ds. O ne t h r e a d st r e a ms t h e c o ntents o f a f i l e t o po r t 1 o f a n E S L
u
n i t.
Th
e se
c o
nd t
h
r e
a
d r e
c
e iv es S
p ac
e
W
ir e t r
aff
i
c f
r
o
m t
h
e
E
S L
u
n i t ,
a
nd st
o
r es t
h
e b
y
tes r e
c
e iv ed t
o
a f i l e.
Wh
en t
h
i s p r o gr
a
m i s r u n o n
a
n E S L u n i t ,
a
loop
-
b
ac
k
c
o nne
c
t i o n m
a
y be u sed o n po r t 1;
a
l te r n
a
t iv e ly
a
n e x te r n
a l
S
p ac
e
W
ir e de vi
c
e m
a y
be
u
sed t
o
s i n
k
t
h
e t r
a
nsm i tted d
a
t
a
st r e
a
m
a
nd t
o
s
upply
d i
ff
e r ent
i n
f
o r m
a
t i o n t o t
h
e E S L.
Th
e t r
a
nsm i tt i n g t
h
r e
a
d sends S p
ac
e
W
ir e t i me
-c
o de 99 w
h
en i t
ha
s
f
i n i s
h
ed
send i n g,
a
nd t
h
e r e
c
e ivi n g t
h
r e
a
d st
op
s
w h
en i t r e
c
e iv ed t
h
i s t i me
-c o
de.
Th
ese t i me
-c o
de
f
e
a
t
u
r es
r e
q
u ir e t
h
e p r esen
c
e o
f
t
h
e E S L ’ s
T
i me
-C
o de (
TC
) op t i o n.
4Links Limited
www.4Links.co.uk
support@4Links.co.uk
page 45 of 110
T +44 1908 642001; F +44 1908 363463
Milton Keynes MK3 6EB, UK
Suite EU2, Bletchley Park