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

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

EtherSpaceLink-RG408
EtherSpaceLink family User Manual
14. 6 . 2 1.
EtherSpaceLink_set_active_link()
S ynops i s
int EtherSpaceLink_set_active_link ( EtherSpaceLink ESL_unit,
int port_number
)
D esc ri pt i on
EtherSpaceLink_set_active_link()
se
l
e
c
ts t
h
e
ac
t iv e
po
r t
o
n
a
n
E
t
h
e rS
p ac
eL i n
k u
n i t.
Th
e
ac t iv e po r t i s t h e o ne u sed f o r
EtherSpaceLink_write_packet()
op e r a t i o ns , a s w e ll a s w i t h
f u
n
c
t i
o
ns s
u ch a
s
EtherSpaceLink_set_speed()
a
nd
EtherSpaceLink_set_mode()
.
B e f o r e ac t iv a t i n g a ne w po r t o n a n E S L u n i t , t h e p r e vi ou s ly se l e c ted po r t s h oul d be d i s a b l ed u s i n g
EtherSpaceLink_set_mode(ESL_unit, EtherSpaceLink_LINK_mode_disabled)
t o
p r e v ent u nne c ess a r y t r a ns i ents o n t h e l i ne a s i t i s pow e r ed d ow n.
I nput p ara mete r s
ESL_unit
t h e ha nd l e r et u r ned b y a s u cc ess f ul
EtherSpaceLink_open()
c o mm a nd.
port_number
t
h
e n
u
mbe r
o f
t
h
e
po
r t t
o
be m
a
de
ac
t iv e.
Th
e r e
q u
ested
po
r t s
h oul
d be i n t
h
e r
a
n g e
1 t o t h e n u mbe r o f po r ts o n t h e u n i t.
Retu r ns
0 R e
q
u est s u
cc
ess
f
ully sent
-
1
A
n e rr
o
r
o cc u
rr ed
E xa mple
EtherSpaceLink ESL_unit;
ESL_unit = EtherSpaceLink_open ( "192.168.3.40" );
EtherSpaceLink_set_active_link ( ESL_unit, 4 );
4Links Limited
www.4Links.co.uk
support@4Links.co.uk
page 82 of 110
T +44 1908 642001; F +44 1908 363463
Milton Keynes MK3 6EB, UK
Suite EU2, Bletchley Park