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

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

EtherSpaceLink-RG408
EtherSpaceLink family User Manual
14. 6 .1.
EtherSpaceLink_open()
S ynops i s
EtherSpaceLink EtherSpaceLink_open ( char * ip_address
)
D esc ri pt i on
EtherSpaceLink_open()
i s s uppl i ed w i t h a te x t st ri n g des c ri b i n g t h e lo ca t i o n o f t h e
E
t
h
e rS
p ac
eL i n
k u
n i t. It m
a y
be
a
n I
P a
dd r ess (e. g .“1
9
2.1 6 8.3.1 0 1
”
)
o
r
a h o
st
-
n
a
me r e
c o
g n i sed b
y
t
h
e
h o st m ach i ne.
I
f
t
h
e E t
h
e rS p
ac
eL i n k u n i t i s
f
ou nd ,
a ha
nd l e t o i t i s r et u r ned
f
o r u se i n o t
h
e r
acc
ess r ou t i nes.
A
r et u r n
v a lu e o f z e r o i nd i ca tes a fa i lu r e t o c o nne c t t o t h e u n i t.
EtherSpaceLink_open()
a l s o r e a ds t h e t a b l e o f m o d ul es i nst a ll ed i n t h e E t h e rS p ac eL i n k t o a n
i nte r n
a l
b
u ff
e r,
f o
r
u
se b
y p
r
o c
ed
u
r es
acc
ess i n g st
a
t
u
s
a
nd m
o
d
ul
e i n
f o
r m
a
t i
o
n.
Wh en op ened , t h e S p ac e W ir e l i n k w i ll be i n t h e d i s a b l ed st a te a nd i ts de fa ul t s p eed w i ll be 1 0 M b / s.
M o
d
ul
e
a
nd
l
i n
k p a
r
a
mete r s
ca
n be set i mmed i
a
te
ly
b
u
t t
h
e
l
i n
k
m
u
st be st
a
r ted (
u
s i n g
EtherSpaceLink_set_mode()
) be f o r e d a t a ca n be t r a ns f e rr ed o v e r t h e S p ac e W ir e l i n k .
I nput p ara mete r s
ip_address
a po
i nte r t
o a cha
r
ac
te r st ri n g .
Th
i s m
a y
be
a
n I
P a
dd r ess
o
r
a
n
a
me.
Retu r ns
z
e r
o
t
h
e
E
t
h
e rS
p ac
eL i n
k u
n i t
c oul
d n
o
t be
f ou
nd
o
r s
o
me
o
t
h
e r e rr
o
r
o cc u
rr ed.
n o n -z e r o t h e u n i t w a s f ou nd a nd a c o nne c t i o n w a s est a b l i s h ed.
S ee A lso
EtherSpaceLink_close()
4Links Limited
www.4Links.co.uk
support@4Links.co.uk
page 52 of 110
T +44 1908 642001; F +44 1908 363463
Milton Keynes MK3 6EB, UK
Suite EU2, Bletchley Park