manualshive.com logo in svg

4Links Diagnostic SpaceWire Interface DSI-RG408, User Manual, Page: 8 / 130

Share
Download
4Links Diagnostic SpaceWire Interface DSI-RG408 User Manual Download Page 8

Diagnostic SpaceWire Interface

EtherSpaceLink family User Manual

2

.

D

escription of Oper

a

tion

Thi

s s

e

c

t

i

on

d

e

s

cri

be

s

t

h

e m

ai

n

f

e

a

tu

r

e

s

o

f

t

h

e D

iag

no

s

t

ic

S

pac

e

Wir

e

I

nte

rfac

e.

Th

e D

iag

no

s

t

ic

S

pac

e

Wir

e

I

nte

rfac

e (DS

I

)

i

s

a high-p

e

rf

o

r

m

a

n

c

e

E

t

h

e

r

net

-

to

-

S

pac

e

Wir

e B

ri

d

g

e t

ha

t

ca

n

r

el

ay

t

raffic fr

om

a

s

i

n

g

le

TC

P/

I

P

E

t

h

e

r

net

c

onne

c

t

i

on to u

p

to e

igh

t

c

on

c

u

rr

entl

y-

o

p

e

ra

t

i

n

g

b

i

d

ir

e

c

t

i

on

a

l S

pac

e

Wir

e

p

o

r

t

s

.

Th

e DS

I

m

ay

be

p

u

rcha

s

e

d

wi

t

h fir

m

war

e t

ha

t

s

u

pp

o

r

t

s

f

e

w

e

r

t

ha

n t

h

e e

igh

t S

pac

e

Wir

e

c

onne

c

to

r

s

on

t

h

e

RG

4

0

8

har

d

war

e

p

l

a

t

f

o

r

m.

I

n t

hi

s

ca

s

e

,

onl

y

t

h

e lo

w

e

s

t

-

numbe

r

e

d

S

pac

e

Wir

e

c

onne

c

to

r

s

ar

e

u

s

a

ble

-

e.

g

.

p

o

r

t

s 1

a

n

d 2

f

o

r

2

-p

o

r

t

fir

m

war

e

a

n

d

p

o

r

t

s 1

-4 f

o

r 4-p

o

r

t

fir

m

war

e.

Th

e

r

em

ai

n

i

n

g p

o

r

t

s

ar

e

d

i

s

a

ble

d

.

Fir

m

war

e u

pgra

d

e

s

to en

a

ble

f

u

r

t

h

e

r p

o

r

t

s

ar

e

a

v

ai

l

a

ble

fr

om

4

L

i

n

k

s

L

i

m

i

te

d

.

2

.1. Gener

a

l

Th

e DS

I

i

s

c

onne

c

te

d

to

a

n

E

t

h

e

r

net net

w

o

rk a

n

d

pa

ss

i

vel

y wai

t

s

f

o

r a c

onne

c

t

i

on

fr

om

a h

o

s

t

c

om

p

ute

r

.

I

t

i

s

i

d

ent

ifi

e

d

b

y a

n

I

P

a

dd

r

e

ss

t

ha

t

i

s

u

s

e

d

b

y

t

h

e

h

o

s

t

c

om

p

ute

r

to m

ak

e t

hi

s

c

onne

c

t

i

on.

Th

e

c

onne

c

t

i

on

i

s

m

a

d

e u

s

i

n

g a TC

P

s

o

ck

et

, which i

s

f

lo

w-c

ont

r

olle

d

a

n

d

i

s

capa

ble o

f r

e

c

ove

ri

n

g fr

om

e

rr

o

r

s

t

ha

t m

igh

t o

cc

u

r

on t

h

e net

w

o

rk

bet

w

een t

h

e u

s

e

r a

n

d

t

h

e

E

t

h

e

r

S

pac

eL

i

n

k

un

i

t.

U

p

on m

aki

n

g

t

h

e

c

onne

c

t

i

on

,

t

h

e DS

I

i

s s

et to

a k

no

w

n

s

t

a

te

wi

t

h

t

h

e S

pac

e

Wir

e l

i

n

k

s d

i

s

a

ble

d

,

t

h

e

l

i

n

k

s

p

ee

d s

et to

1

0

M

b/

s

a

n

d

a

ll t

h

e o

p

t

i

on

s

r

e

s

et.

Th

e u

s

e

r pr

o

gra

m mu

s

t en

a

ble t

h

e S

pac

e

Wir

e l

i

n

k

s

be

f

o

r

e

d

a

t

a ca

n be

s

ent o

r r

e

c

e

i

ve

d

.

O

n

c

e en

a

ble

d

,

d

a

t

a i

s

t

ra

n

s

f

e

rr

e

d

,

t

ra

n

s

par

entl

y, fr

om t

h

e

S

pac

e

Wir

e l

i

n

k

to t

h

e

app

l

ica

t

i

on

pr

o

gra

m on t

h

e

h

o

s

t

, a

n

d

a

l

s

o

fr

om t

h

e

pr

o

gra

m to t

h

e S

pac

e

Wir

e

l

i

n

k

.

Th

e

r

e

i

s

no l

i

m

i

t

a

t

i

on on t

h

e

s

iz

e o

f pack

et t

ra

n

s

f

e

r

s

i

n e

ach

d

ir

e

c

t

i

on

-

not even

a

s

a r

e

s

ult o

f fi

n

i

te

bu

ff

e

r

s

iz

e

s

.

Th

e u

s

e

r ha

s

c

om

p

lete

c

ont

r

ol ove

r

t

h

e S

pac

e

Wir

e

pack

et

c

ontent

a

n

d s

t

r

u

c

tu

r

e;

a pack

et

m

ay

be

s

ent o

r r

e

c

e

i

ve

d

i

n

s

e

g

ment

s

.

Th

e

h

o

s

t

pr

o

gra

m

ca

n

a

l

s

o

c

ont

r

ol t

h

e t

ra

n

s

m

i

ss

i

on

s

p

ee

d

o

f

t

h

e S

pac

e

Wir

e l

i

n

k

s

.

Th

e t

ra

n

s

m

i

t

s

p

ee

d

ca

n be

cha

n

g

e

d

a

t

a

n

y

t

i

me

, i

n

c

lu

d

i

n

g i

n t

h

e m

i

dd

le o

f a pack

et. S

p

ee

d

cha

n

g

e

s

ar

e t

ra

n

s

par

ent

a

n

d d

o

not

r

e

q

u

ir

e l

i

n

k

d

i

s

c

onne

c

t

i

on.

I

n

acc

o

r

d

a

n

c

e

wi

t

h

t

h

e

s

t

a

n

d

ar

d

,

t

h

e S

pac

e

Wir

e l

i

n

k

s

a

l

way

s s

t

ar

t

a

t

1

0

M

b/

s

a

n

d

t

h

en

, wh

en t

h

e l

i

n

k

(

s

)

ar

e e

s

t

a

bl

i

s

h

e

d

,

t

h

e

y

m

ay

be

cha

n

g

e

d

to t

h

e u

s

e

r-

s

ele

c

te

d s

p

ee

d

.

A

ll

o

f

t

h

e l

i

n

k

s

on t

h

e DS

I

r

un

a

t t

h

e

s

a

me u

s

e

r-

s

ele

c

te

d s

p

ee

d

,

ex

c

e

p

t

f

o

r a

n

y

t

ha

t

ar

e

s

ele

c

te

d

to

r

em

ai

n

a

t t

h

e

i

n

i

t

ia

l

1

0

M

b/

s

ra

te.

D

i

s

c

onne

c

t

i

on o

f

t

h

e u

s

e

r’

s

pr

o

gra

m

fr

om t

h

e DS

I

r

e

s

ult

s

i

n t

h

e S

pac

e

Wir

e l

i

n

k

s

be

i

n

g

d

i

s

a

ble

d

a

n

d

a

ll

o

f

t

h

e DS

I

o

p

t

i

on

s

be

i

n

g r

e

s

et.

Th

e DS

I

ca

n t

h

e

r

e

f

o

r

e be

s

een

a

s

a

t

ra

n

s

par

ent

i

nte

rfac

e

- wh

en t

h

e u

s

e

r pr

o

gra

m

ac

t

i

v

a

te

s

t

h

e

S

pac

e

Wir

e l

i

n

k

s

,

t

h

e

y ca

n

c

onne

c

t to t

h

e t

arg

et S

pac

e

Wir

e net

w

o

rk, a

n

d

wh

en t

h

e u

s

e

r pr

o

gra

m

i

s

s

to

pp

e

d

,

t

h

e S

pac

e

Wir

e l

i

n

k

s d

i

s

c

onne

c

t.

Th

e D

iag

no

s

t

ic

S

pac

e

Wir

e

I

nte

rfac

e m

ay

be o

p

e

ra

te

d

i

n t

hr

ee

way

s:

B

y i

t

s

o

p

e

ra

to

r fr

om t

h

e

ir c

om

p

ute

r k

e

y

bo

ar

d

,

u

s

i

n

g a

s

u

pp

l

i

e

d

pr

o

gra

m to

g

ene

ra

te

a

n

d

mon

i

to

r

S

pac

e

Wir

e t

raffic

m

a

nu

a

ll

y

;

Thr

ou

gh

t

h

e u

s

e o

f pr

e

-

d

e

s

ig

ne

d

c

omm

a

n

d s

crip

t

s

t

ha

t

r

un

s

t

a

n

d

ar

d s

et

s

o

f

te

s

t

s

a

n

d

a

n

a

l

y

s

e t

h

e

r

e

s

ult

s

a

utom

a

t

ica

ll

y

;

Us

i

n

g c

u

s

tome

r-cr

e

a

te

d s

o

f

t

war

e t

ha

t

i

nte

rac

t

s

wi

t

h

t

h

e

ir

S

pac

e

Wir

e net

w

o

rk

t

hr

ou

gh

t

h

e

E

t

h

e

r

S

pac

eL

i

n

k App

l

ica

t

i

on P

r

o

gra

mm

i

n

g i

nte

rfac

e (

A

P

I

) un

d

e

r pr

o

gra

m

c

ont

r

ol.

4Links Limited
www.4Links.co.uk
[email protected]

page 8 of 130

T +44 1908 642001; F +44 1908 363463

Milton Keynes MK3 6EB, UK

Suite EU2, Bletchley Park

Summary of Contents for Diagnostic SpaceWire Interface DSI-RG408

Page 1: ...y be modified for diagnostic purposes Concurrent outputs on several links may be synchronized Waveform captures of the SpaceWire link signals may be triggered by a very wide set of events The Ethernet port provides a galvanically isolated connection with a cable length of up to 100 m Attaching this to the Internet allows world scale connections Ethernet and TCP IP provide a standard interface mech...

Page 2: ...C P H Walker Added Multi unit synchronisation Delta Time Tags Packet Generator Checker Version 1 3 November 2006 B M Cook C P H Walker Initial version SVN revision 229 of 2013 09 17 Variant a4 RG408 Legal notice and disclaimer Copyright 2012 2013 4Links Limited all rights reserved The name 4Links and the accompanying device are registered as a Trademark in the European Union and in the United Stat...

Page 3: ...on 12 2 5 2 SpaceWire information 12 2 6 Communication Protocols 13 2 7 Programming API 13 3 Specification 14 3 1 SpaceWire Links 14 3 1 1 SpaceWire Receive Performance 14 3 1 2 SpaceWire Transmit Performance 14 3 1 3 SpaceWire Connectors 14 3 1 4 SpaceWire Time Codes 15 3 2 The Ethernet Connection 15 3 2 1 ICMP Echo ping Support 15 3 2 2 Full Duplex Ethernet 15 3 3 SMA Synchronization Connectors ...

Page 4: ...olled Outputs 39 14 Options OD and OE Output Disable and Output Enable 40 15 Unit to Unit Time Tag Synchronisation 41 15 1 Setting the Synchronisation Source 42 16 Software 44 16 1 Files Supplied with the DSI 44 16 2 Controlling the DSI using the SpWIO Program 45 16 3 The RMAP plugin for the SpWIO Program 45 16 4 C language Application Programming Interface 45 16 5 Waveform Handling 45 17 C langua...

Page 5: ...d_packet_special_callback 82 17 6 14 EtherSpaceLink_read_packet_extension_callback 84 17 6 15 EtherSpaceLink_callback_packet_type 86 17 6 16 EtherSpaceLink_read_packet_full 87 17 6 17 EtherSpaceLink_read_packet_full_nowait 92 17 6 18 EtherSpaceLink_read_packet_status 95 17 6 19 EtherSpaceLink_read_packet_wait_for_completion 96 17 6 20 EtherSpaceLink_set_speed 97 17 6 21 EtherSpaceLink_set_speed_do...

Page 6: ...tice 124 21 Product Limitations and Features 124 21 1 Ethernet 124 21 2 SpaceWire 124 22 Regulatory Information 125 22 1 Electromagnetic Compatibility 125 22 2 Product Safety 125 22 3 Equipment Recycling 125 22 4 Restriction of Hazardous Substances 125 23 RG408 Product Drawings 126 23 1 Plan views 126 23 2 Front views 128 23 3 Rear views 129 4Links Limited www 4Links co uk support 4Links co uk pag...

Page 7: ...Links for advice Do not operate in wet or damp conditions Do not operate in an explosive atmosphere Keep product surfaces clean and dry Provide proper ventilation The air inlet and outlet on the rear panel must not be obstructed 1 1 Terms in this Manual CAUTION Caution statements identify conditions or practices that could result in damage to this product or to other property 1 2 Symbols on the Pr...

Page 8: ...ink There is no limitation on the size of packet transfers in each direction not even as a result of finite buffer sizes The user has complete control over the SpaceWire packet content and structure a packet may be sent or received in segments The host program can also control the transmission speed of the SpaceWire links The transmit speed can be changed at any time including in the middle of a p...

Page 9: ...1 From there it will be returned to the host computer displayed and recorded java jar SpWIO jar u 192 168 3 42 4Links SpWIO v24 20111201 v33 20110920 on Fri Sep 14 14 48 04 BST 2012 u 192 168 3 42 Attached 192 168 3 42 is DSI RG40x 8 v1 9 EI EW ER TT SO 8 ports link mode is normal at 10 0Mb s Log file is SpWIO_20120914_144809 log Input from console 1 2 4 6 8 eop Tx 1 02 04 06 08 EOP Rx 1 02 04 06 ...

Page 10: ... the user Correct but normally hidden tokens such as flow control tokens can also be transferred to the user 2 4 2 EW Event Error Waveforms Each SpaceWire port has an associated waveform store that captures transmit and receive wire signals for that port Waveform captures can be triggered on a wide variety of events on that and or other ports It is possible for example to capture wire signals for ...

Page 11: ...he usual absolute time tag Delta time tags are coded using 2 bytes instead of the usual 8 bytes and thus considerably reduce traffic when time tags are used with high speed data 2 4 5 SO Synchronized Outputs In order to test functions such as the arbitration in a routing switch it is necessary to present inputs to the device under test that are synchronized with each other The Synchronized Outputs...

Page 12: ...tions indicate 3S on the DSI unit s front panel when its SpaceWire outputs are tri stated 2 5 Front Panel Display The front panel display continuously monitors and displays the states of the Ethernet and SpaceWire links The top line of the display shows the product number the current IP address of the EtherSpaceLink unit and the name 4Links on the right Figure 2 2 The DSI display 2 5 1 Ethernet in...

Page 13: ... over Ethernet calls Native Interface Link SpaceWire API function Application Program on host computer Programming API on host computer ESL Family unit SpaceWire endpoint or device under test Figure 2 3 Connection of a SpaceWire device to a computer using an EtherSpaceLink unit In the event of an EtherSpaceLink unit being powered down the computer will continue to expect the connection to be resto...

Page 14: ...of 1 Mb s or less dependent on the speed range as shown in the following table Lower speed Mb s increment Mb s Higher speed Mb s 40 0 1 0 400 0 4 0 0 1 39 9 1 00 0 01 3 99 3 1 3 SpaceWire Connectors Eight standard 9 way Micro miniature D type SpaceWire socket connectors are mounted either on the front panel on RG hardware platforms or on the rear panel on RG R platforms The connectors are labelled...

Page 15: ... to an ICMP echo request as provided on many operating systems via the ping command This can provide a simple test to check that the unit is accessible on the network 3 2 2 Full Duplex Ethernet Only full duplex Ethernet connections are supported 3 3 SMA Synchronization Connectors Synchronization to other 4Links units or to external devices is achieved using SMA connectors on units with the S model...

Page 16: ...rnet MAC address 4Links EtherSpaceLink unit serial numbers are of the form Annn e g A202 The least significant bits of the Ethernet Media Access Control MAC address of a unit are directly related to its serial number Serial numbers MAC addresses A1 to A4095 00 50 C2 21 20 01 to 00 50 C2 21 2F FF 3 4 2 Installed Product Options When viewing the serial number of a running unit as above the installed...

Page 17: ...Imperial Maximum height 45 mm 1 75 inches Maximum width 483 mm 19 inches Maximum depth overall 335 mm 405 mm with mated power connector 13 25 inches 16 inches with mated power connector Maximum depth inside rack 290 mm 360 mm with mated power connector 11 5 inches 14 25 inches with mated power connector Weight Approximately 2 8 kg Approximately 6 lb Heat output power consumption Approximately 25 W...

Page 18: ...ction at its mains voltage input and should be used where surge protection is required CAUTION The AC DC adapter supplied with the unit provides mains isolation to UL60950 EN60950 If an alternative power source is used it must have an equivalent rating 3 5 3 2 Power Consumption Total power consumption depends on the number of active ports and options up to around 25W 3 5 3 3 Power Connector Power ...

Page 19: ...contact 4Links CAUTION There are no user serviceable parts inside this equipment 3 5 4 Handling and Transportation The 4Links RG platform products are designed to be robust and are capable of being transported to support SpaceWire testing Units should be packaged in protective foam or similar material to prevent them from being subjected to excessive shocks during handling Units should not be subj...

Page 20: ...d by pressing the eject button on the right hand side of the card slot with a non conductive device CAUTION Do not attempt to remove the memory card using a conductive object e g a pen or a screwdriver Memory cards are configured for a particular 4Links hardware platform and are only intended for use with that unit If one attempts to boot a 4Links unit with a memory card that was built for another...

Page 21: ...Front panel display memory card connector in SFP module Micro D SpaceWire connectors monitoring and thermal control Removable Front panel switch Ethernet TCP IP interface SpaceWire Link interfaces Transmit and receive buffers SMA synchronisation connectors S units only Figure 4 1 EtherSpaceLink family unit block diagram 4Links Limited www 4Links co uk support 4Links co uk page 21 of 130 T 44 1908 ...

Page 22: ...ws the state of the SpaceWire and Ethernet connections and any activity on these interfaces Figure 5 2 The DSI status display The top line of the display shows Ethernet information The IP address of this unit Ethernet status The SFP module see section 3 2 The Ethernet Connection is not present X The SFP module is present but the Ethernet cable is not connected L The Ethernet is connected and the D...

Page 23: ...as recently been received X A timeout has recently occurred P A parity error has recently occurred Each of these status indication characters is displayed for a brief duration to make them visible to the human eye Some common SpaceWire conditions may be easily recognised e g NX nulls and timeouts will be seen coming from a link that is trying but failing to establish a connection N is shown contin...

Page 24: ...rial number A260 with all options that its clock is not yet synchronised to other EtherSpaceLink units that it is connected to a 100 Mb s Ethernet and that no user program is connected to it Figure 6 1 The DSI serial number and configuration display The chart below shows how to navigate the settings menus The current state is shown as a box with three sections The top section shows a label that in...

Page 25: ...on display and pushing it again in the same direction will return to the main status display Selecting the Settings display with two operations of the switch in opposite directions and doing nothing will result in all the settings being displayed in turn and then the display will return to its normal status display mode Selecting the Settings display and then pushing the switch down Change allows ...

Page 26: ...alled Synch option if Time Detail Status Display Configuration Display Configuration Display IP Address Display IP Address Synch Method Time Synch Display Health Display Temp Voltage Display Summary Status Fan on auto Figure 6 4 DSI front panel states 4Links Limited www 4Links co uk support 4Links co uk page 26 of 130 T 44 1908 642001 F 44 1908 363463 Milton Keynes MK3 6EB UK Suite EU2 Bletchley P...

Page 27: ...herSpaceLink units Synchronise to another unit s reference time Provide the time reference source for other units Remain isolated and generate time tags locally For further details see section 15 Unit to Unit Time Tag Synchronisation Figure 6 6 The time synchronisation display 6 3 Health Display The Health Display provides a frequently updated view of the important temperatures and voltages in thi...

Page 28: ...dden some because they cause error conditions and result in the link being reset and possibly also generating an EEP character This option allows selected events to be seen by the user for diagnostic purposes In the case of error events further action may be taken if the EI Error Injection option is also installed Events reported by this option are when Time codes are received Flow control tokens ...

Page 29: ...uch traffic as for the packet alone this can soon saturate the Ethernet connection and should be used with caution Time tagging the first data byte and the end of packet marker gives useful information with a much lower overhead and is recommended for normal use DSI Version 1 0 introduced an optional delta time tag which is used when the interval between time tags is short 6 5µs reducing the Ether...

Page 30: ...red this allows links to be tested with a shortage of FCTs and with an excess The link may be set so that data is transmitted regardless of whether there is sufficient flow credit ECSS errors normally cause the link to reset and restart It is possible to set the links in a DSI to continue operating by ignoring some or all of these errors Parity error ESC EOP ESC EEP ESC ESC Timeout Additionally th...

Page 31: ...error being observed on port 1 of a DSI The erroneous parity bit is shown in red When the link engine detected the parity error it disconnected the link and this may also be seen in the waveform An error waveform is displayed automatically by the SpWIO program when it is generated and the pop up window allows the user to inspect the signal waveforms at various magnifications It is also possible to...

Page 32: ...5 Recorder 4 Recorder 3 Recorder 2 Recorder 1 Waveform Waveform Waveform Waveform Waveform Waveform Waveform Waveform SMA J5 6 pulse waveform display waveform display waveform display waveform display waveform display waveform display waveform display waveform display OR OR OR Figure 11 2 Option EW triggering waveform capture and external signals Selected events on the SpaceWire ports as well as t...

Page 33: ...e API function See the respective SpWIO or C language Application Programming Interface manual for details The trigger selections for the waveform recorder and pulse generator modules are thus SpWIO es flag DSI Option Description 1 Trigger on events from SpaceWire port 1 2 Trigger on events from SpaceWire port 2 3 Trigger on events from SpaceWire port 3 4 Trigger on events from SpaceWire port 4 5 ...

Page 34: ...ceived packets arrive e The end of packet marker EOP is received g The error end of packet marker EEP is received t Time codes are received a ER The ECSS error ESC ESC is observed b ER The ECSS error ESC EOP is observed c ER The ECSS error ESC EEP is observed f ER Flow control tokens are received p ER The ECSS Parity error is observed v ER More data is received than flow control credit permits w E...

Page 35: ...en on port 1 or port 4 By using the inline versions of the ew and es commands we can adjust the event generation for individual ports and the selection of triggers to generate waveforms on individual recorders For example we could write 1 ew e An event is generated when an EEP is seen on SpaceWire port 1 1 ew et A port 1 event is output when time codes and end of packet markers arrive 1 es 12 Gene...

Page 36: ...t an EtherSpaceLink_RESIGN character Having joined the port is sent data which is transmitted normally until a EtherSpaceLink_BARRIER character reaches the head of the queue At this time the port sends NULLs whilst waiting for the other ports to reach the barrier When the number of ports waiting on the barrier equals the number of ports that JOINed the barrier the barrier is lifted all of the wait...

Page 37: ...onnections from ports 2 to 1 and 7 to 8 around the loopback connectors back from ports 1 to 2 and 8 to 7 and eventually back to ports 1 and 3 on the DSI Upon receipt the DSI was instructed to time tag the returning packets java jar SpWIO jar s 200 w se u 192 168 3 42 4Links SpWIO v24 20111201 v33 20110920 s 200 w se u 192 168 3 42 Attached 192 168 3 42 is DSI RG40x 8 v1 9 EI EW ER TT SO 8 ports li...

Page 38: ... 159 3 Mb s 1680 481 093 372 0s 7 8 Data 0000 07 08 09 7 8 EOP at 1680 481 093 521 3s SOP 0 149us 160 8 Mb s 1680 481 093 378 7s 7 8 Data 0000 07 08 09 7 8 EOP at 1680 481 093 528 0s SOP 0 149us 160 8 Mb s 1680 481 093 378 7s 1 2 Data 0000 01 02 03 1 2 EOP at 1680 481 093 529 3s SOP 0 151us 159 4 Mb s This recording corroborates the measurements made by the DSI above 4Links Limited www 4Links co u...

Page 39: ... at one pulse per second from the IRIG source The DSI had a loopback connector on port 4 and the port 4 transmit speed was 100 Mb s The controlling software was SpWIO In this first example there is a synchronisation to the external clock at the start of each packet 4 w s 5 hold 0 0 0 0 eop Tx 4 w s HOLD 00 00 00 00 EOP Tx 4 HOLD 00 00 00 00 EOP Tx 4 HOLD 00 00 00 00 EOP Tx 4 HOLD 00 00 00 00 EOP T...

Page 40: ...level input signal is present on SMA connector pair J3 J4 making it fail safe in the face of a broken enable signal connection The drawback to this option is that the DSI will appear inert unless J3 J4 is driven high which is a non standard behaviour With the OE option the existing J3 J4 functions may be used with reversed polarity the DSI triggers an event waveform capture when the input signal f...

Page 41: ...nnectors J7 and J8 are interchangeable Units to be synchronised are connected together by SMA SMA cables and 50 Ω terminators must be added at each end of the chain The two connectors in a pair are simply wired to each other and may be used as a loop through connection or a resistor may be inserted into one of the connectors so that the other forms a terminated connection Power Connector SMA J1 Po...

Page 42: ...onise their timetags to that unit Notice that if the power to a unit is cycled or if its memory card is unplugged and then reinserted and it was the time reference for a chain of EtherSpaceLink units then this capacity must be set again on the unit s front panel Figure 15 2 Time synchronisation display Synchronisation status is shown on the normal status display immediately before the Ethernet sta...

Page 43: ...nnection An EtherSpaceLink Absolute Time Interface ATI that synchronises time tags to an IRIG B00x source is available from 4Links It should be included as one of the units in the chain above If there is an ATI in the chain it is by default the synchronisation master All other EtherSpaceLink units should then be set to Synchronise to reference 4Links Limited www 4Links co uk support 4Links co uk p...

Page 44: ... replaying link traffic java jar SpWIO jar parameters See the SpWIO User Manual for full usage instructions waveform jar A Java based analysis tool that interprets the Event Waveform files that are generated by the SpWIO program when an event error waveform is triggered ProtocolRx_RMAP class ProtocolTx_RMAP class Java plug ins that the SpWIO program uses to interpret the SpaceWire RMAP protocol Et...

Page 45: ...tion Programming Interface 16 5 Waveform Handling Blocks of waveform data are embedded in the EtherSpaceLink protocol stream at the points where events were detected by the DSI When the SpWIO program is run a pop up graphical window will show each waveform as it is encountered This window shows the time tag of the event that triggered the waveform capture an indication of the type of event and the...

Page 46: ... User Manual Figure 16 1 SpaceWire waveform capture of a Link changing speed from 10 Mb s to 100 Mb s 4Links Limited www 4Links co uk support 4Links co uk page 46 of 130 T 44 1908 642001 F 44 1908 363463 Milton Keynes MK3 6EB UK Suite EU2 Bletchley Park ...

Page 47: ...t under test A user program will normally interface with a 4Links EtherSpaceLink family unit by using the Application Programming Interface API that is described in this manual 17 1 1 Principles of Operation The EtherSpaceLink family SpaceWire interface products primarily support the transmission of concurrent streams of traffic from their Ethernet connection to one or more SpaceWire ports one for...

Page 48: ... bridge or sometimes portal is a device that transfers data from one medium to another In our case the 4Links EtherSpaceLink interfaces are Ethernet to SpaceWire bridges 17 1 3 Protocol Hierarchy The C language API interfaces to a Native Interface which communicates over Ethernet via a TCP IP socket connection The EtherSpaceLink unit then converts the received data stream to SpaceWire This may be ...

Page 49: ... The EtherSpaceLink Protocol that runs on this TCP IP stream carries Data packets that will be transmitted on SpaceWire Data packets received from SpaceWire Lots of extra control information all multiplexed together and flow controlled but with some timing constraints Several formats of packets are carried by the EtherSpaceLink protocol Complete SpaceWire data packets with an EOP or EEP terminator...

Page 50: ...be used a link will never start if both ends are configured for autostart 17 3 Compiling Programs that use the EtherSpaceLink API Before we can start writing any code to drive our 4Links unit we need to check the compilation route At the top of our program we must include the EtherSpaceLink h file that provides all of the constant and function declarations that it requires When we compile the prog...

Page 51: ...I char rx_buffer 4096 receive buffer int bytes_received the size of the packet returned int terminator the native interface terminator int loop_index status misc storage unsigned char HWA 6 Ethernet hardware address if argc 2 fprintf stderr Usage s IP address n argv 0 exit 1 DSI_unit EtherSpaceLink_open argv 1 if DSI_unit 0 fprintf stderr Unable to open connection to s n argv 1 exit 1 Get static D...

Page 52: ...k_EOP EOP EEP EtherSpaceLink_close DSI_unit return 0 This program accepts the IP address of an EtherSpaceLink family product or hostname if it will be recognised on your computer from the command line and opens a TCP IP connection to it interrogates the device for its product details sets up link 1 for transmission at the default speed of 10 Mbps and waits for it to connect sends a 4 byte EOP term...

Page 53: ...the EtherSpaceLink_EOP terminator Writing a single extension character can be performed by EtherSpaceLink_write_EXTN while longer sequences of extension characters may be transmitted using EtherSpaceLink_write_packet with a terminator of EtherSpaceLink_EXTN Sending multiple extension characters of a length that is not consistent with the selected extension sequence will break the EtherSpaceLink pr...

Page 54: ...t_special_callback or EtherSpaceLink_read_packet_extension_callback When a special packet or extension sequence has been received the corresponding function is called to deliver it Programming the reception of special and extension data using callbacks helps to isolate the handling of this information from the SpaceWire data These techniques may be used with many combinations of callbacks reports ...

Page 55: ...from the receive thread back to the transmit thread This must be done using semaphores or other forms of mutual exclusion to ensure that race conditions and concurrent writes to variables are not possible Transferring simple status information from the receiving thread back to the transmitting thread is usually straightforward SpW c and the example in section 17 5 6 An Advanced API Example contain...

Page 56: ...rleaved fashion if necessary When this program is run on a DSI unit a loop back connection may be used on port 1 alternatively a SpaceWire cable may be used to join port 1 to any other available port The times shown are collected in the receiving thread SpaceWire time code 2 is sent by the transmitting thread to initialise the timer and time code 3 is sent to stop the timer and report the results ...

Page 57: ...in blocks of 1024 while feof infile int length fread txdata 1 sizeof txdata infile status EtherSpaceLink_write_packet DSI_unit txdata length EtherSpaceLink_EOP total_sent length EtherSpaceLink_flush DSI_unit send SpaceWire time code 3 to end timing timereq 0 EtherSpaceLink_TimeCode 255 timereq 1 3 EtherSpaceLink_write_packet DSI_unit timereq 2 EtherSpaceLink_EXTN EtherSpaceLink_flush DSI_unit send...

Page 58: ...N_EXTENSION_DATA EtherSpaceLink_RETURN_SPECIAL_DATA EXTENSION packet returned by DSI unit if terminator EtherSpaceLink_EXTN extension int rxbuf 0 255 256 if EtherSpaceLink_PortSelect extension extension EtherSpaceLink_PortSelect_max printf data received on port d n extension EtherSpaceLink_PortSelect else if extension EtherSpaceLink_TimeCode unsigned int code int rxbuf 1 255 if code 2 total_receiv...

Page 59: ...d Special bytes_received for ii 0 ii bytes_received ii printf 02x int rxbuf ii 0xff printf n else partial data packets if terminator EtherSpaceLink_PART_EOP_EEP terminator EtherSpaceLink_PART_EXTN terminator EtherSpaceLink_PART_SPECIAL fwrite rxbuf 1 bytes_received rec 0 total_received bytes_received else normal SpaceWire data if terminator EtherSpaceLink_EOP terminator EtherSpaceLink_EEP fwrite r...

Page 60: ... EtherSpaceLink_get_product_string DSI_unit printf i ports n EtherSpaceLink_get_number_of_links DSI_unit printf Serial number s EtherSpaceLink_HWA_to_serial_number_string HWA printf at 2 2X 2 2X 2 2X 2 2X 2 2X 2 2X HWA 0 HWA 1 HWA 2 HWA 3 HWA 4 HWA 5 printf n n for i 1 i ports i int status status EtherSpaceLink_set_active_link DSI_unit i tx_link EtherSpaceLink_set_speed DSI_unit 100 Global speed f...

Page 61: ...42 100MB Connecting to 192 168 3 42 OK 4Links Limited DSI RG40x 8 v1 9 8 ports Serial number A260 at 00 50 C2 21 21 04 Starting data received on port 2 Transmitter finished Receiver finished 100000000 bytes written in 10 066000 secs 9934432 758950 bytes sec For a considerably more extensive example see SpW c which is included in the software bundle with your 4Links product 4Links Limited www 4Link...

Page 62: ...ctions Notice that some functions and some parameter values are only available for particular EtherSpaceLink family products or for products that have been purchased with particular optional features 4Links Limited www 4Links co uk support 4Links co uk page 62 of 130 T 44 1908 642001 F 44 1908 363463 Milton Keynes MK3 6EB UK Suite EU2 Bletchley Park ...

Page 63: ... EtherSpaceLink to an internal buffer for use by procedures accessing status and module information When opened the SpaceWire link will be in the disabled state and its default speed will be 10Mb s Module and link parameters can be set immediately but the link must be started using EtherSpaceLink_set_mode before data can be transferred over the SpaceWire link Input parameters ip_address a pointer ...

Page 64: ...ndle error and exit else Use the connection EtherSpaceLink_close DSI_unit Example If suitable host name associations are available we could use DSI_unit EtherSpaceLink_open a202 or DSI_unit EtherSpaceLink_open dsi A202 4links co uk 4Links Limited www 4Links co uk support 4Links co uk page 64 of 130 T 44 1908 642001 F 44 1908 363463 Milton Keynes MK3 6EB UK Suite EU2 Bletchley Park ...

Page 65: ...ess the unit then becomes free to accept another connection Input parameters DSI_unit the handle returned by a successful open command Returns None See Also EtherSpaceLink_open Example include EtherSpaceLink h EtherSpaceLink DSI_unit DSI_unit EtherSpaceLink_open 192 168 3 101 EtherSpaceLink_close DSI_unit 4Links Limited www 4Links co uk support 4Links co uk page 65 of 130 T 44 1908 642001 F 44 190...

Page 66: ...n Entries in the log file will begin with the text Rx p for data received on port p Tx p for data transmitted on port p Alternatively if a SpaceWire link id has been set for a particular EtherSpaceLink unit Rx id p for data received on port p Tx id p for data transmitted on port p Input parameters DSI_unit the handle returned by a successful EtherSpaceLink_open command file_name 0 or pointer to na...

Page 67: ...log_file Input parameters DSI_unit the handle returned by a successful EtherSpaceLink_open command id a pointer to a text string Returns None Example include EtherSpaceLink h EtherSpaceLink DSI_unit DSI_unit EtherSpaceLink_open 192 168 3 101 EtherSpaceLink_set_id DSI_unit Camera EtherSpaceLink_set_log_file DSI_unit Experiment_1205 4Links Limited www 4Links co uk support 4Links co uk page 67 of 130...

Page 68: ...e provided for special link operating conditions EtherSpaceLink_LINK_mode_fixed_speed The link speed remains at its default startup speed 10 Mb s nominal actually within the range 9 8 to 10 2 Mb s EtherSpaceLink_LINK_mode_long_timeout Extends the timeout period in the link state machine to provide a potentialy more reliable link start at very low data rates i e for slow low power links near to 2 M...

Page 69: ...ity on the link is seen Use with SMCS TSS901 devices EtherSpaceLink_LINK_mode_fixed_speed See the note above Link speed remains at its default startup speed 10Mb s nominal EtherSpaceLink_LINK_mode_slow_speed See the note above For 2Mb s start and run EtherSpaceLink_LINK_mode_long_timeout See the note above Extend the timeout period in the link state machine Returns 0 the request has been sent 1 an...

Page 70: ..._link DSI_unit 1 EtherSpaceLink_set_mode DSI_unit EtherSpaceLink_LINK_mode_normal EtherSpaceLink_set_active_link DSI_unit 2 EtherSpaceLink_set_mode DSI_unit EtherSpaceLink_LINK_mode_normal Example For 2 Mb s operation on port 5 use on a DSI or SRR EtherSpaceLink_set_active_link DSI_unit 5 EtherSpaceLink_set_speed DSI_unit 2 EtherSpaceLink_set_mode DSI_unit EtherSpaceLink_LINK_mode_normal EtherSpac...

Page 71: ...gth of 60 bytes EtherSpaceLink_SPECIAL This is a complete special packet EEP would not normally be used to terminate a packet but is available here to assist with testing where an erroneous packet may usefully be generated Data is queued in buffers in the API in order to make best use of the TCP IP stream and may not be sent immediately EtherSpaceLink_flush should be used to ensure the immediate t...

Page 72: ...INK_mode_normal EtherSpaceLink_write_packet DSI_unit ABCD 4 EtherSpaceLink_EOP initialise buffer before sending it EtherSpaceLink_write_packet DSI_unit buffer 15 EtherSpaceLink_EOP EtherSpaceLink_flush DSI_unit Example To send an ECSS SpaceWire time code unsigned char timereq 16 EtherSpaceLink DSI_unit timereq 0 EtherSpaceLink_TimeCode 255 timereq 1 2 time code 2 EtherSpaceLink_write_packet DSI_un...

Page 73: ...EtherSpaceLink_EOP End of packet EtherSpaceLink_EEP Error end of packet EtherSpaceLink_STORE Store flag part of a store and forward sequence EtherSpaceLink_FORWARD Forward flag part of a store and forward sequence EtherSpaceLink_port_select to EtherSpaceLink_port_select 15 Select this SpaceWire port for data transmission subsequent data transmitted will be sent to port n where EtherSpaceLink_port_...

Page 74: ... Synchronisation point EtherSpaceLink_DELAY to EtherSpaceLink_DELAY 15 EI SO Insert delays values 0 to 15 represent 1 to 16 4 bits additional time at the selected transmit speed for which D and S do not change 1 to 16 4 1 bits total EtherSpaceLink_HOLD CO Hold the following characters until a low to high transition on SMA J1 J2 is observed EtherSpaceLink_TimeCode EI To send an ECSS time code a sec...

Page 75: ...I_unit EtherSpaceLink_port_select 2 Example Sends ECSS time code 34 char tcode EtherSpaceLink_TimeCode 255 34 result EtherSpaceLink_write_packet DSI_unit tcode sizeof tcode EtherSpaceLink_EXTN EtherSpaceLink_flush DSI_unit 4Links Limited www 4Links co uk support 4Links co uk page 75 of 130 T 44 1908 642001 F 44 1908 363463 Milton Keynes MK3 6EB UK Suite EU2 Bletchley Park ...

Page 76: ...eturned by a successful EtherSpaceLink_open command Returns 0 Data is waiting to be transmitted 1 There is no data waiting to be transmitted 1 An error occurred Note Be aware that EtherSpaceLink_write_buffer_empty consumes SpaceWire data from the TCP IP connection to the EtherSpaceLink unit while it is waiting for a successful response If the unit under test generates asynchronous traffic this mig...

Page 77: ...ters DSI_unit the handle returned by a successful EtherSpaceLink_open command Returns zero The request was data was successful non zero An error occurred data may not have been sent to the EtherSpaceLink unit Example EtherSpaceLink DSI_unit char buffer 1024 DSI_unit EtherSpaceLink_open Rosetta EtherSpaceLink_set_mode DSI_unit EtherSpaceLink_LINK_mode_normal EtherSpaceLink_write_packet DSI_unit ABC...

Page 78: ...ximum period of waiting after the last received data not a delay from issuing the EtherSpaceLink_read_packet command Input parameters DSI_unit the handle returned by a successful EtherSpaceLink_open command ms the timeout period in milli seconds Returns None Example This function call causes future EtherSpaceLink_read_packet calls to return partial received packets after 500 ms even if an EtherSpa...

Page 79: ...paceLink_EOP This is the last part or all of a packet an end of packet EOP was received EtherSpaceLink_EEP This is the last part or all of a packet containing an error an error end of packet EEP was received EtherSpaceLink_PART_EOP_EEP The packet was larger than the available buffer Another read will retrieve more data from the same packet Input parameters DSI_unit the handle returned by a success...

Page 80: ...aceLink_LINK_mode_normal n EtherSpaceLink_read_packet DSI_unit buffer 1024 EOP switch EOP case EtherSpaceLink_PART_EOP_EEP more of the packet is available break case EtherSpaceLink_EOP complete good packet break case EtherSpaceLink_EEP packet with error break 4Links Limited www 4Links co uk support 4Links co uk page 80 of 130 T 44 1908 642001 F 44 1908 363463 Milton Keynes MK3 6EB UK Suite EU2 Ble...

Page 81: ... DSI_unit void callback_buffer int callback_buffer_length void callback int length int complete int data_buffer_position Description This function is DEPRECATED Please use EtherSpaceLink_read_packet_special_callback instead 4Links Limited www 4Links co uk support 4Links co uk page 81 of 130 T 44 1908 642001 F 44 1908 363463 Milton Keynes MK3 6EB UK Suite EU2 Bletchley Park ...

Page 82: ...t 0 The packet will be incomplete only if it is larger than the callback buffer in which case returning from the callback procedure will result in that procedure being called again with the next segment or the rest of the special packet data_buffer_position indicates the index of the next data byte that will be written to the normal data buffer and thus serves to indicate the relative position of ...

Page 83: ...ser Manual Returns None Note See EtherSpaceLink_read_packet_full and SpW c for examples of this function 4Links Limited www 4Links co uk support 4Links co uk page 83 of 130 T 44 1908 642001 F 44 1908 363463 Milton Keynes MK3 6EB UK Suite EU2 Bletchley Park ...

Page 84: ...is complete 1 or not 0 The packet will be incomplete only if it is larger than the callback buffer in which case returning from the callback procedure will result in that procedure being called again with the next segment or the rest of the special packet data_buffer_position indicates the index of the next data byte that will be written to the normal data buffer and thus serves to indicate the re...

Page 85: ...paceLink family User Manual Returns None Note See SpW c for an example of this function 4Links Limited www 4Links co uk support 4Links co uk page 85 of 130 T 44 1908 642001 F 44 1908 363463 Milton Keynes MK3 6EB UK Suite EU2 Bletchley Park ...

Page 86: ...s Input parameters DSI_unit the handle returned by a successful EtherSpaceLink_open command Returns int EtherSpaceLink_SPECIAL or EtherSpaceLink_EXTN Example EtherSpaceLink DSI_unit char callback_buffer 1024 void callback int length int complete int data_buffer_position int type EtherSpaceLink_callback_packet_type DSI_unit if type EtherSpaceLink_SPECIAL handle Special callback else if type EtherSp...

Page 87: ...eived EtherSpaceLink_PART_EOP_EEP The packet was larger than the available buffer another read will retrieve more data from the same packet EtherSpaceLink_EXTN DSI SRR Data is from the extended character set EtherSpaceLink_PART_EXTN DSI SRR Data is from the extended character set but the buffer provided was not big enough and only that part of the returned data fitting in the buffer is supplied Mo...

Page 88: ...ROR1 EtherSpaceLink_PERROR2 EI A parity error was detected EtherSpaceLink_EVENT EW A waveform was captured See the EW description for details of how to retrieve the waveform EtherSpaceLink_TimeTag TT A time tag was received This is presented as 9 bytes in the buffer EtherSpaceLink_TimeTag followed by eight further bytes of time value EtherSpaceLink_TimeTag_delta TT A time tag delta was received Th...

Page 89: ...he packet containing one byte whose value is EtherSpaceLink_PortSelect P where P is the port number 1 2 8 Special packets Special packets are used to return status information from an EtherSpaceLink unit module It is possible that these received packets may be delivered in segments to allow interleaving within the EtherSpaceLink protocol stream you are more likely to see terminator values of Ether...

Page 90: ...ion data packet in a buffer and report its length EtherSpaceLink_ RETURN_EXTENSION_DATA Deliver any extension data in the given buffer EtherSpaceLink_ CALLBACK_EXTENSION_DATA Call the registered callback procedure to handle the extension data buffer If no such callback procedure has been registered then discard the extension data packet See EtherSpaceLink_read_packet_ extension_callback Output par...

Page 91: ...e Separating normal and special data EtherSpaceLink DSI_unit char buffer 1024 char special 1024 int n int EOP DSI_unit EtherSpaceLink_open 192 168 3 40 EtherSpaceLink_set_mode DSI_unit EtherSpaceLink_LINK_mode_normal n EtherSpaceLink_read_packet_full DSI_unit buffer 1024 EOP EtherSpaceLink_REPORT_SPECIAL_DATA if n 0 1 if an error or else s EtherSpaceLink_read_packet_full DSI_unit special 1024 EOP ...

Page 92: ...buffer a buffer to contain received data length the size of the receive buffer special_action what to do if a special packet is received This parameter should be set to the logical OR combination of one selection from the SPECIAL actions below and one from the EXTENSION actions If one of each set of actions is not specified those packets will be discarded EtherSpaceLink_ DISCARD_SPECIAL_DATA Ignor...

Page 93: ...red then discard the extension data packet See EtherSpaceLink_read_packet_ extension_callback Output parameters terminator indicates what terminator if any was received Returns 0 The read request was successfully queued 1 An error occurred See Also EtherSpaceLink_read_packet_full Example An asynchronous packet read with later a blocking wait EtherSpaceLink_read_packet_full_nowait DSI_unit buffer b...

Page 94: ... same time as the packet is being received The status of the transfer can be tested for example with while read_length EtherSpaceLink_read_packet_status DSI_unit 0 A negative value from read_packet_status indicates that the transfer is not yet complete printf waiting n usleep 500000 A read length 0 from read_packet_status indicates that the transfer has completed 4Links Limited www 4Links co uk su...

Page 95: ..._read_packet_full_nowait request Input parameters DSI_unit the handle returned by a successful EtherSpaceLink_open command Returns 0 the read has not yet completed 0 the read has completed and this is the number of bytes in the packet Note See EtherSpaceLink_read_packet_full_nowait for an example of this function 4Links Limited www 4Links co uk support 4Links co uk page 95 of 130 T 44 1908 642001 ...

Page 96: ...ceLink_read_packet_full_nowait request to complete Input parameters DSI_unit the handle returned by a successful EtherSpaceLink_open command Returns 0 the read completed with an error 0 the read has completed and this is the number of bytes in the packet Note See EtherSpaceLink_read_packet_full_nowait for an example of this function 4Links Limited www 4Links co uk support 4Links co uk page 96 of 1...

Page 97: ...his are links set with the additional mode modifier EtherSpaceLink_LINK_mode_fixed_speed which remain at their start up speed of 10 Mb s See section 17 6 5 EtherSpaceLink_set_mode for examples of this technique Input parameters DSI_unit the handle returned by a successful EtherSpaceLink_open command speed the required link transmit speed in Mb s Returns zero the request was successful non zero an ...

Page 98: ... are set using EtherSpaceLink_set_mode to EtherSpaceLink_LINK_mode_normal run at the same speed The only exception to this are links set with the additional mode modifier EtherSpaceLink_LINK_mode_fixed_speed which remain at their start up speed of 10 Mb s See section 17 6 5 EtherSpaceLink_set_mode for examples of this technique Input parameters DSI_unit the handle returned by a successful EtherSpa...

Page 99: ...from the TCP IP connection until it receives a successful response If the unit under test generates asynchronous traffic while this polling takes place that SpaceWire traffic might be discarded EtherSpaceLink_link_connected returns a result code of 1 if any SpaceWire data is lost See section 17 5 3 Asynchronous Issues during Status Polling Example EtherSpaceLink DSI_unit Open a TCP IP link to the ...

Page 100: ...ink_open command Returns 1 The number of ports on this unit 1 An error occurred Note Be aware that EtherSpaceLink_get_number_of_links should only be called at the start of an API program before the SpaceWire link s are enabled See section 17 5 3 Asynchronous Issues during Status Polling Example int Nlinks EtherSpaceLink DSI_unit DSI_unit EtherSpaceLink_open 192 168 3 40 Nlinks EtherSpaceLink_get_n...

Page 101: ...ve transmissions but remain powered up and capable of receiving SpaceWire traffic or error reports and therefore do not need to be disabled before a new one is activated Input parameters DSI_unit the handle returned by a successful EtherSpaceLink_open command port_number the number of the port to be made active The requested port should be in the range 1 to the number of ports on the unit Returns ...

Page 102: ...l EtherSpaceLink_open command Returns char This is a pointer to the memory area containing a zero terminated string of 8 bit characters A null pointer 0 is returned if an error occurred while obtaining the data Note Be aware that EtherSpaceLink_get_manufacturer_string should only be called at the start of an API program before the SpaceWire link s are enabled See section 17 5 3 Asynchronous Issues...

Page 103: ...rSpaceLink_open command Returns char This is a pointer to the memory area containing a zero terminated string of 8 bit characters A null pointer 0 is returned if an error occurred while obtaining the data Note Be aware that EtherSpaceLink_get_product_string should only be called at the start of an API program before the SpaceWire link s are enabled See section 17 5 3 Asynchronous Issues during Sta...

Page 104: ...tput parameters HWA a pointer to an array of 6 bytes to receive the address Returns 0 if successful 1 if an error occurred while getting data Note Be aware that EtherSpaceLink_get_HWA should only be called at the start of an API program before the SpaceWire link s are enabled See section 17 5 3 Asynchronous Issues during Status Polling Example EtherSpaceLink DSI_unit unsigned char HWA 6 DSI_unit E...

Page 105: ...ler MAC address Input parameters HWA a pointer to an array of 6 bytes containing the address Returns char This is a pointer to the memory area containing a zero terminated string of 8 bit characters Example EtherSpaceLink DSI_unit unsigned char HWA 6 DSI_unit EtherSpaceLink_open 192 168 3 40 EtherSpaceLink_get_HWA DSI_unit HWA printf Serial number s EtherSpaceLink_HWA_to_serial_number_string HWA 4...

Page 106: ...ch the first byte is the value EtherSpaceLink_TimeTag 0xFF Input parameters DSI_unit the handle returned by a successful EtherSpaceLink_open command buffer an area containing a control packet such as that returned by EtherSpaceLink_get_control_packet Returns double the value of the time tag in the packet Example bytes_received EtherSpaceLink_read_packet_full DSI_unit rxbuf sizeof rxbuf terminator ...

Page 107: ...othing Disable all event error reporting EtherSpaceLink_ER_report_first_null Report when a disconnected link receives a null character a key event in establishing a connection EtherSpaceLink_ER_report_running_error Report any errors when the link is running i e when the SpaceWire state machine is in the Run state On the DSI this combines several errors that could be selected individually see the s...

Page 108: ...uence escape error end of packet is received EtherSpaceLink_ER_report_ESC_ESC DSI Report when the sequence escape escape is received EtherSpaceLink_ER_report_timeout DSI Report when the link receiver sees no activity for at least the timeout period Input parameters DSI_unit the handle returned by a successful EtherSpaceLink_open command what a set of bits indicating which events are to be reported...

Page 109: ...ition EtherSpaceLink_EW_capture_nothing Disable all event error waveform reporting EtherSpaceLink_EW_capture_first_null Report when an idle link receives a null character a key event in establishing a connection EtherSpaceLink_EW_capture_running_error Report any errors when the link is running i e when the SpaceWire state machine is in the Run state On the DSI this combines several errors that cou...

Page 110: ...eived than is permitted by the ECSS standard EtherSpaceLink_EW_capture_excess_data DSI Report when more data has been received than is permitted by the current flow control credit In addition to the above triggers a non maskable EVENT in the DSI transmit data stream can also trigger a waveform capture Each port of a DSI has a waveform capture circuit Each capture circuit can be triggered by events...

Page 111: ...ser Manual Example EtherSpaceLink_EW_enable_reporting DSI_unit EtherSpaceLink_EW_capture_running_error 4Links Limited www 4Links co uk support 4Links co uk page 111 of 130 T 44 1908 642001 F 44 1908 363463 Milton Keynes MK3 6EB UK Suite EU2 Bletchley Park ...

Page 112: ... on events from port 5 EtherSpaceLink_EW_Source_port_6 Trigger on events from port 6 EtherSpaceLink_EW_Source_port_7 Trigger on events from port 7 EtherSpaceLink_EW_Source_port_8 Trigger on events from port 8 EtherSpaceLink_EW_Source_SMA_12 LS MS platforms Trigger on a rising edge on SMA connectors 1 2 The threshold level is 0 5 V EtherSpaceLink_EW_Source_SMA_34 LS MS platforms Trigger on a rising...

Page 113: ... whenever an error occurs on any one or more int all_ports EtherSpaceLink_EW_source_port_1 EtherSpaceLink_EW_source_port_2 EtherSpaceLink_EW_source_port_3 EtherSpaceLink_EW_source_port_4 EtherSpaceLink_EW_source_port_5 EtherSpaceLink_EW_source_port_6 EtherSpaceLink_EW_source_port_7 EtherSpaceLink_EW_source_port_8 int port for port 1 port 8 port EtherSpaceLink_set_active_link DSI_unit port EtherSpa...

Page 114: ...be created with logical OR not numerical addition EtherSpaceLink_TT_report_nothing Disable all time tag reporting EtherSpaceLink_TT_report_first_byte Generate a time tag on the first byte of a packet EtherSpaceLink_TT_report_intermediate_bytes Generate a time tag on all bytes of a packet between the first byte and the end of a packet Warning this can produce a lot of information EtherSpaceLink_TT_...

Page 115: ...ort_ESC_EOP DSI Generate a time tag when the escape end of packet sequence is received EtherSpaceLink_TT_report_ESC_EEP DSI Generate a time tag when the escape error end of packet sequence is received EtherSpaceLink_TT_report_ESC_ESC DSI Generate a time tag when the escape escape sequence is received EtherSpaceLink_TT_report_timeout DSI Generate a time tag when a timeout is detected Input paramete...

Page 116: ...rSpaceLink_EI_ignore_timeout Ignore timeouts EtherSpaceLink_EI_ignore_excess_FCT Ignore flow control credit that has been received in excess of that permitted by the ECSS standard EtherSpaceLink_EI_ignore_excess_data Ignore data that has been received in excess of that permitted by the current flow control credit Input parameters DSI_unit the handle returned by a successful EtherSpaceLink_open com...

Page 117: ...Example EtherSpaceLink_EI_ignore_events DSI_unit EtherSpaceLink_EI_ignore_timeout EtherSpaceLink_EI_ignore_ESC_ESC 4Links Limited www 4Links co uk support 4Links co uk page 117 of 130 T 44 1908 642001 F 44 1908 363463 Milton Keynes MK3 6EB UK Suite EU2 Bletchley Park ...

Page 118: ...ow control tokens can be suppressed by the DSI leaving the user to explicitly issue flow control tokens see EtherSpaceLink_write_EXTN Also the transmission of data can be allowed by the DSI despite there being no available credit in order to test a receiver s behaviour The initial_fcts parameter of EtherSpaceLink_EI_flow_control sets the number of flow control tokens that are sent when the link st...

Page 119: ...rred Note It will be necessary to enable error reporting for many of these events using EtherSpaceLink_ER_enable_reporting before they will be reported back to the application software Example This example sets the unit to issue no flow control tokens when the link is started and none automatically thereafter EtherSpaceLink_EI_flow_control DSI_unit 0 EtherSpaceLink_EI_no_automatic_FCT 4Links Limit...

Page 120: ...g SpWIO to check the DSI unit s hardware Then plug in the equipment under test and probe this Does the DSI unit s front panel display show that the link s are connected Are the R and or the T indicators flashing for this link If just the N and X indicators are lit continuously one side of the link is trying to connect repeatedly without success see section 19 The SpaceWire State Machine Have you s...

Page 121: ... Synchronized Outputs for further information Check for clean Output Enable Output Disable control signals on SMA connector pair J5 J6 if the OD or OE options are installed My API program hangs at start up Did your program open the EtherSpaceLink connection successfully Check the EtherSpaceLink_open result code How many ports are supported on your ESL or DSI unit Don t try to use ports that are no...

Page 122: ...ormation Re read that section for some suggestions or re cast your program as in the example in section 17 5 6 An Advanced API Example Has your device under test livelocked or deadlocked In a multithreaded API application the synchronisation of information between the SpaceWire receive thread and the SpaceWire transmit thread might have been programmed incorrectly and thus has livelocked or deadlo...

Page 123: ... the link responds correctly through Connecting to the Run state Disconnected The link is actively trying to make a connection by periodically sending sequences of Nulls If there is no response from the other end of the link the state machine will cycle through ErrorReset ErrorWait Ready and Started states A suitable response from the other end of the link will allow Started to lead to Connecting ...

Page 124: ...it 20 2 Security Notice The configuration files stored on the memory card define the function of the unit These are encrypted and can be used only with the specific unit they were created for The data on the card cannot be used to configure any other unit 21 Product Limitations and Features 21 1 Ethernet The TCP IP packet re transmission timeout is set at a fixed period of 1 second it should be st...

Page 125: ...e following specifications as listed in the Official Journal of the European Union and by the International Electrotechnical Commission IEC IEC 61010 1 2010 3rd Edition and EN 61010 1 2010 3rd Edition with US Canada National Deviations 22 3 Equipment Recycling The symbol shown in figure 22 1 indicates that this product complies with the European Union s requirements according to EU Directive 2002 ...

Page 126: ... connectors not to scale Figure 23 1 RG408 plan view with rear SMA connectors Plan view with front SpaceWire connectors and no SMA connectors not to scale Figure 23 2 RG408 plan view without rear SMA connectors 4Links Limited www 4Links co uk support 4Links co uk page 126 of 130 T 44 1908 642001 F 44 1908 363463 Milton Keynes MK3 6EB UK Suite EU2 Bletchley Park ...

Page 127: ...re 23 3 RG408 R plan view with rear SMA connectors Plan view with rear SpaceWire connectors and no SMA connectors not to scale Figure 23 4 RG408 R plan view without SMA connectors 4Links Limited www 4Links co uk support 4Links co uk page 127 of 130 T 44 1908 642001 F 44 1908 363463 Milton Keynes MK3 6EB UK Suite EU2 Bletchley Park ...

Page 128: ...t SpaceWire connectors not to scale Figure 23 5 RG408 front view Front view with rear SpaceWire connectors not to scale Figure 23 6 RG408 R front view 4Links Limited www 4Links co uk support 4Links co uk page 128 of 130 T 44 1908 642001 F 44 1908 363463 Milton Keynes MK3 6EB UK Suite EU2 Bletchley Park ...

Page 129: ...t to scale Figure 23 7 RG408 rear view with SMA connectors With front SpaceWire connectors and no SMA connectors not to scale Figure 23 8 RG408 rear view with no SMA connectors 4Links Limited www 4Links co uk support 4Links co uk page 129 of 130 T 44 1908 642001 F 44 1908 363463 Milton Keynes MK3 6EB UK Suite EU2 Bletchley Park ...

Page 130: ...gure 23 9 RG408 R rear view with SMA connectors With rear SpaceWire connectors and no SMA connectors not to scale Figure 23 10 RG408 R rear view without SMA connectors 4Links Limited www 4Links co uk support 4Links co uk page 130 of 130 T 44 1908 642001 F 44 1908 363463 Milton Keynes MK3 6EB UK Suite EU2 Bletchley Park ...

Reviews:

No comments