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

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

Diagnostic SpaceWire Interface
EtherSpaceLink family User Manual
17. 6 . 2 5. EtherSpaceLink_get_manufacturer_string()
S ynops i s
char * EtherSpaceLink_get_manufacturer_string ( EtherSpaceLink DSI_unit
)
D esc ri pt i on
EtherSpaceLink_get_manufacturer_string()
r etu r n s a n A S C II s t ri n g i n di ca t i n g t h e
m
a
nu
fac
tu
r
e
r
o
f
t
h
e un
i
t.
Th is s t ri n g is ext r ac te d f r om t h e U n i c o d e s t ri n g ac tu a ll y r etu r ne d b y t h e un i t , b y ext r ac t i n g t h e le a s t
sig
n
i f i ca
nt
8 -
b
i
t
s
o
f
e
ach cha r ac
te
r
.
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
ss f
ul
EtherSpaceLink_open()
c
omm
a
n
d
.
Retu r ns
char *
Th is is a p o i nte r to t h e memo r y a r e a c ont a i n i n g a z e r o - te r m i n a te d s t ri n g o f 8 - b i t
cha r ac
te
rs
.
A
null
p
o
i
nte
r
(0)
is r
etu
r
ne
d i f a
n e
rr
o
r
o
cc
u
rr
e
d wh i
le obt
a i
n
i
n
g
t
h
e
d a t a .
Note
Be awa r e t ha t
EtherSpaceLink_get_manufacturer_string()
s h oul d onl y be ca lle d a t t h e
s
t
a r
t o
f a
n
A
P
I p r
o
gr a
m
,
be
f
o
r
e t
h
e S
pac
e
W ir
e l
i
n
k
(
s
)
a r
e en
a
ble
d
. See
s
e
c
t
i
on
17
.5.
3,
“
A s y
n
ch r
onou
s
Iss ue s d u ri n g St a tu s Poll i n g ” ,
E xa mple
EtherSpaceLink DSI_unit;
DSI_unit = EtherSpaceLink_open ( "192.168.3.40" );
printf ( "%s", EtherSpaceLink_get_manufacturer_string ( DSI_unit ) );
4Links Limited
www.4Links.co.uk
support@4Links.co.uk
page 102 of 130
T +44 1908 642001; F +44 1908 363463
Milton Keynes MK3 6EB, UK
Suite EU2, Bletchley Park