Vous êtes sur la page 1sur 28

Ericssonwide Internal

FUNCTION DESCRIPTION
Uppgjord (ven faktaansvarig om annan) - Prepared (also subject responsible if other)

Nr - No.

EAB/UKH/FX Mikael Lejerkrans

10/155 16-CRX 901 52/1 Uen

Dokansv/Godknd - Doc respons/Approved

Kontr - Checked

EAB/FX [Olle Sivars]

Datum - Date

Rev

2005-01-27

D1

1(28)

File

Miscellaneous function
Contents

Page

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.1

Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2

Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

SPAS Container parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

ELGI log identity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Switch throughput optimization, TPO. . . . . . . . . . . . . . . . . . . 5

Network synchronisation support. . . . . . . . . . . . . . . . . . . . . . . 6

SPIC Buffer Configuration functions. . . . . . . . . . . . . . . . . . . . 6

6.1

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

6.2

Switch Access Configuration function. . . . . . . . . . . . . . . . . . . . . 7

6.3

SILI egress buffer control function . . . . . . . . . . . . . . . . . . . . . . . 7

SPAS SW characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

7.1

Process priorities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

7.2

Times and timer-values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

7.3

Memory usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Command Line Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

8.1

File Control commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

8.2

Configuration Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

8.3

Execution Control Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 20

8.4

Testing Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

8.5

PBOOT Manager & Flash File System Commands . . . . . . . . . 20

8.6

Miscellaneous Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Identity

10/FD_MISCELLANEOUS-CELLO:SPAS_SUBSYS

Template doc.no: 70/00201-2/FEA 214 530 Uen Rev A

FUNCTION DESCRIPTION

2(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

LOG Identity used in ELGI . . . . . . . . . . . . . . . . . . . . . . . . . . 27

10

Abbreviations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

11

References. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

FUNCTION DESCRIPTION

3(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen

Datum - Date

Rev

2005-01-27

D1

File

Introduction
This document describes some functions and characteristics of the Space
Switching subsystem.

1.1

Scope
The scope of this document is primarily to describe Cello SPAS functions that
are not described in any other SPAS FD. Functions not included in this document can be found in other FD:s describing the SPAS subsystem.

1.2

Revision History
Revision

Date

Description

030521

This document is based on FD_MISCELLANEOUSCELLO:SPAS_SUBSYS, PC9. The document


number and Identity has been changed in order to be
unique.

030703

Changed fro filter time

040308

Updated for CBU.

041210

Updated for Cello5. CR UABtr21939. PBOOT


parameter SPIC_CACHE_ENABLE added, ELGI log
identity information added.

D1

050211

Added a new timeout description in 7.2, page 10.

4(28)

FUNCTION DESCRIPTION
Nr - No.

10/155 16-CRX 901 52/1 Uen

Datum - Date

Rev

2005-01-27

D1

File

SPAS Container parameters


There is a container file at all boards where it is possible to specify parameters
that can be used in run-time to specify behaviour of a board.
Table 1. shows SPAS related parameters. More information about these parameters can be found in [7].

Table 1. SPAS container parameters


Parameter

Format

Typical Values

Boards

Comment

SPAS_BOARD_HW

[nISL,][CORE,]nSAI

SCB:
4ISL,CORE,1SAI

Exists on all
boards.

Read by the ID, LED


and HWDRV objects,
see ref. [12], ref. [13]

Parameter exists
on boards with
internal links.

This value gives the


total data rate (spas
header excluded).

n is an integer

CBU:
CORE,1SAI
SXB: 4ISL,1SAI
Other: 1SAI
SILI_RATE

sili_rate

SCB, SXB: 620*

sili_rate in Mbit/s

Read by the silipRo


object, see ref. [14].
SILIx_PORT_INFO

port_rate, port_label

x is an integer 0..7

port_rate in Mbit/s

SCB, SXB: 320, B

Parameter exists
on boards with
internal links.

port_label is a
character

The port rate value gives


the total data rate (spas
header excluded).
The port label specifies
the label on the front of
the board.
There exists one
parameter for each
physical ISL port on the
board.
Read by the silipRo
object, see ref. [14].

SPAS_ASCC_RESET

General IO reset pin


number that is
connected to ASCC.

Parameter exists
on boards where
SPAS is
responsible for
ASCC reset.

Read by Start at cold


restart.

SPAS_SPIC_RESET

General IO reset pin


number that is
connected to SPIC.

Parameter exists
on boards where
SPAS is
responsible for
SPIC reset.

Read by Start at cold


restart.

5(28)

FUNCTION DESCRIPTION
Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

Table 1. SPAS container parameters


Parameter

Format

Typical Values

Boards

Comment

SPIC_CACHE_ENABLE

INGRESS, EGRESS

INGRESS and/or
EGRESS

Exists on all
boards where
cache shall be
enabled

Makes it possible to
enable ingress and or
egress cache(s) for
different boards.

Indicates if the
ingress and/or egress
cache shall be
enabled.

Read by HWDRV

*) For more information about these figures, see [10]. The values used in the
table is the applicable rounded off worst case values.
The parameters are accessed through the NVPI interface.

ELGI log identity


The log identity is used to identify a log entry in the HW Fault Log. For more
information about the HW fault log, see ref. [18].
Log identity K00 - KZZ have been reserved for Spas. The following identities
are used:
Table 2. Spas ELGI log identities
Log Identity

Loadmodule, object

Comment

K00

Basic, Start

Spic fault.
It is not possible to initialise the Spic.

K01

Basic, Start

Ascc fault.
It is not possible to initialise the ASCC.
This is only logged on SCB2 boards.

Switch throughput optimization, TPO


When a board starts, it will be configured according to ref. [17]. The switch
module should then be configured for maximum throughput.
The Switch module and Sai objects in the resource view will optimise the performance of each switch module. The operating frequencies of the switch
ports in a switch module are compared and the RCU Data Rate registers in
the ASCCs are set for optimum performance.
1

If the frequency of portm > the frequency of portn then RCU Data
Rate register of portm should be set to 1.

FUNCTION DESCRIPTION

6(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

If the frequency of portm < the frequency of portn then RCU Data
Rate register of portm should be set to 0.

If the frequency relation between portm and portn is unknown then


RCU Data Rate registers of portm and portn should be set to 0.

The result from the TPO calculation is sent to the SaiRo object that handles
the RCU Data Rate registers. The SaiRo object also handles the ASCI rate.
The ASCI rate is read from the SAI_speed register in SPIC.

Network synchronisation support.


SPAS supports the NSS sub-system by implementing the server side of the
SSI interface. The interface is used to control and monitor the system clocks
and the SPIC internal clock. The interface has the following characteristics

The interface is a local interface.

The SPAS function are limited to supporting NSS in reading and


writing sync related registers in the SPIC, i.e. HW-driver related
functions.

The client subscribes to changes of clock source and clock status.

SPIC Buffer Configuration functions

6.1

Overview
When buffers are configured, this is performed on a Quality of Service (QoS)
basis. A description of the QoS concept can be found in [4].
Note that the ASCI RATE parameter is not included in the calculation of buffer lengths. In the future, in order to make the calculation more accurate, the
ASCI RATE parameter should be taken into consideration.
Currently the maximum allowed delay times for the different QoS levels are
hard coded.
To improve the function in the future, the maximum allowed delay times
should be sent to the SaiRo object on each board. It should then be possible
for the saci server object and the ingress queue object to access these values
through a local interface. It should also be possible to change the QoS definition, either by using the MAO-FRO interface in the switchfabric object or by
using system parameters.

FUNCTION DESCRIPTION

7(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen

6.2

Datum - Date

Rev

2005-01-27

D1

File

Switch Access Configuration function


A client configure the egress buffers by using the SACI interface in the Basic
loadmodule. The function is implemented in the saci server object and in the
reply to the client, a SUPA value is returned. The SUPA value is calculated
by using the switch module number and the APN number. These numbers are
retrieved by using the SLTI interface.
The maximum queue length for a SUUA is calculated from the egressbandwidth if the DoCac parameter is set to TRUE. If DoCac is FALSE, maximum
queue length are set by the clients parameters.
If the DoCac parameter is set to TRUE, the queue lengths for QoS Gold and
Silver are calculated as follows:
maxqueuelength = bandwidth (cells/s) * maxdelayqos (ms) / 1000 +2 (+2 is
because cells are discrete)
For QoS Bronze and Iron, the queue lengths are set to unrestricted.

6.3

SILI egress buffer control function


The purpose of the SILI egress buffer control function is to control the buffers
towards the ISL, Internal Switch Links. Buffer queues for SILI egress are set
to a low value for ports with a protecting link and ports that are not used. The
queue length for ports connected to a working link are set to a higher value.
The configuration of the SILI egress queues are controlled by the ReliableGroupRo. The ReliableGroupRo orders SilipRo to set a value depending on
if the link is a working or a protecting link.
Figure 1. shows three different states, min size state, no ISL state and traffic
state that the ReliableGroupRo uses to control the queues.
After a cold restart the buffers are initialised to handle a minimum traffic load,
e.g. to take care of BP to BP signalling cells and link supervising cells. This
state is called "min size state. Buffer sizes are shown in Figure 1.
If the board doesnt contain any links, i.e. it is not a SCB or a SXB board, the
SILI buffer control function will be set to no ISL state. The buffers are set
to zero and the buffers are discarded.
The state traffic state is reached if the link is enabled, i.e. the link is configured and error free. If the link gets disabled for some reason, the SILI egress
buffers are set to min state values.
When the link redundancy is working in primitive mode the SILI egress
buffers are set to Min size state values.

FUNCTION DESCRIPTION

8(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

After a warm restart the software is restarted and all variables are initiated but
the hardware is untouched.

cold restart
Boardtype = OTHER

No ISL state

Min size state


Qos1= 10
QoS2= 10
QoS3= 100
QoS4= 10

link= enable

Qos1= 0
QoS2= 0
QoS3= 0
QoS4= 0

Traffic state
link= disable

Qos1= 100
QoS2= 500
QoS3= unrestricted
QoS4= unrestricted

warm restart
Figure 1. SILI buffer control function

SPAS SW characteristics

7.1

Process priorities
In Cello 4, process priorities are set to figures according to [5] and [6]. Since
SPAS is part of CORE, priorities are selected among following (from highest
to lowest priority):
H++

CELLO_CORE_PRIO_HIGH_PLUS_PLUS

H+

CELLO_CORE_PRIO_HIGH_PLUS

CELLO_CORE_PRIO_HIGH

M+

CELLO_CORE_PRIO_MEDIUM_PLUS

CELLO_CORE_PRIO_MEDIUM

L+

CELLO_CORE_PRIO_LOW_PLUS

CELLO_CORE_PRIO_LOW

FUNCTION DESCRIPTION

9(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

SPAS process priorities are specified in Table 3. For processes that have the
same name in backup_lm as in basic_lm the set process priority only applies
for basic_lm.
Table 3. Process priorities for Cello 4 and onwards.
Process

Prio

Motivation

Sys_Spas_metatag_proc

M+

server for CORE clients

Sys_Spas_mts_proc

H+

server for SPAS meta communication

Sys_Spas_ingressqueue_proc

hw-dependency but not urgent

Sys_Spas_smid_proc

server for SPAS clients

Sys_Spas_start_proc

ordinary

Sys_Spas_link_proc

link maintenance

Sys_Spas_silip_proc

ordinary

Sys_Spas_hwdrv_proc

H+

server for SPAS clients and hw-dependency

Sys_Spas_id_proc

server for SPAS clients

Sys_Spas_userport_proc

ordinary

Sys_Spas_plane_proc

hw-dependency but not urgent

Sys_Spas_led_proc

ordinary

Sys_Spas_mor_proc

ordinary

Sys_Spas_linktable_proc

link re-connection

Sys_Spas_seci_proc

M+

server for CORE clients

Sys_Spas_sync_proc

ordinary

Spas_sgt_proc

L+

server for CORE clients

Spas_sgtcoremgr_proc

L+

server for CORE clients

Spas_resourceview_proc

ordinary

Spas_relprogmgr_proc

ordinary

Spas_connection_proc

server for NCH clients

Spas_sci_proxy_proc

same as SCI server

Spas_sgl_proc

L+

server for sgt process

Spas_planemanager_proc

ordinary

FUNCTION DESCRIPTION

10(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen

7.2

Datum - Date

Rev

2005-01-27

D1

File

Times and timer-values


Various times and timers are used in SPAS SW to control different events.
This section is an overview, motivation and explanation of the timer values.
Some timer times are dependent of the Hwdrv polling time of SPIC and
ASCC these time are referred to as hwpt (hwpolltime) this time is currently 1s
Table 4. SPAS SW timers
Event

Start event

Enable a disabled Fault


link, primitive mode disappear

End event

Time

Supervisor 1s
send enabled
indication to
ReliableGro
upRo

Disable an enabled Fault appear Supervisor 165ms


link, primitive mode
send
disabled
indication to
ReliableGro
upRo
Enable a disabled
link, normal mode

Fault
disappear

Supervisor 20s
send enabled
indication to
ReliableGro
upRo

Disable an enabled Fault appear Supervisor 165ms


link, normal mode
send
disabled
indication to
ReliableGro
upRo
Enable a disabled
switch plane

Fault
disappear

Motivation and explanation


10 error free cells should be sent and
received before the link is considered
to be enabled, see [3]

3 cells that are lost is enough to


consider the link as disabled. see [3]

200 error free cells should be sent and


received before the link is considered
to be enabled, see [3]

3 cells that are lost is enough to


consider the link as disabled. see [3]

Planemanag <5s+hw A number of maintenance cells should


er receive
pt
be sent and received before the plane
tmo and
is considered to be enabled, see [2].
enables the
plane

Disabled an enabled Fault appear Planemanag <hwpt


switch plane
er receive
indication
from Hwdrv
about faulty
plane

After an error has occurred SW will


detect the faulty plane at the next
polling and set the plane to disabled.

Board registers to
SMINFO

If the board is a SCB or a SXB board,


a registration message is also sent out
on all connected ISLs.

Periodically

0,4s

FUNCTION DESCRIPTION

11(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

Table 4. SPAS SW timers


View of links is
frozen

Periodically

0,9s

Used for topology supervision of


links. Two registration message can be
received before the link view is
frozen.

View of boards is
frozen

Periodically

0,9s

Used for topology supervision of


boards. Two registration message can
be received before the link view is
frozen.

Detect a new
inserted board

Board is
inserted

New
1,3s
SM_MAP is
sent from
Sminfo

(Time for board registration) + (time


before view of boards is frozen)

Detect a restarting
board

Board is
restarted

New
1,3s
SM_MAP is
sent from
Sminfo

(Time for board registration) + (time


before view of boards is frozen)

Detect removed
board

Board is
removed

2,2s
New
SM_MAP is
sent from
Sminfo

(Time for board registration) + (2 *


time before view of boards is frozen)

Recalculation of
TPO after a
ASCCI_SPEED
value is changed

New ASCCI
speed is
received in
SAI

New TPO is 5 s
calculated
and sent
from SAI

Done to decrease the number of


simultaneous
ANNOUNCE_CONTROL_
REQUEST signals in the system

Update of
A board is
ingressqueues after removed
a board is inserted
or removed

The
<hwpt
ingressqueue
s has been
updated at all
other boards.

Detect a new
inserted link

SilipRo
<hwpt
receives
indication
from Hwdrv
about the
new inserted
link.

Link is
inserted

Info from Id to Smid Info sent

Info sent
next time

1s

Info from Smid


extension to Smid
main

Info sent

Info sent
next time

1s

Info from Id
Info sent
extension to id main

Info sent
next time

1s

LinkTable timeout

30s

Used for link supervision.

FUNCTION DESCRIPTION

12(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

Table 4. SPAS SW timers


FRO-MAO fault
notifications

Any cause
for MAOFRO
interactions
received

Notification 5-6s
sent

FRO resource
notifications

Announce
received

Notification 3s
sent

SILIP filter timeout Connect


status
received

Connect
10s
Status acted
on

Unpredictable signalling order to the


Resource View may cause spurious
FRO-MAO events. This concerns
alarm and resource notifications.

Short disturbances in connect status


should not lead to switch of working
link.

ReliableGroupRo
shall receive a
queue length update
confirmations from
SilipRo

2s

Meta signalling.

ReliableGroupRo
has timers for
changing, updating
or checking a link

5s

Meta signalling.

ReliableGroupRo
link status
indications to
linktable, primitive
mode

25s

Meta Signalling.

ReliableGroupRo
enters primitive
mode after lost
contact with the
resourceview

5min

To make sure that the MP really is lost


and is not only restarting.

All egress queues


that are not used are
set to 0 after a warm
restart.

10min

Used to make sure that the hardware


and the software is consistent after a
warm restart. All SACI clients should
have setup used queues after the
restart.

Reliable Group
possible fault
timeout.

A Reliable
Group view
object is in a
possible
fault state.

The view
8s
object is not
in this fault
state any
longer.

To make sure that at least one ISL link


will be configured as working, so
that an extension module can contact
the main module.
When a Reliable Group object only
has a main RgRo announced (no link
exist) a supervisor will anyway be
created on this RgRo Pid (working
OWN, supervising OWN). And if two
main RgRo Pids exist then the
supervisor will be alternated between
them with this 8 seconds timeout
event.

FUNCTION DESCRIPTION

13(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

Table 4. SPAS SW timers


The Connection
Server (SCI server)
is enough updated
with logical links.

The SCI
server has
got a first
logical link
update from
the Resource
View after a
connection
request.

A timeout
5s
signal is got
after the last
update from
the Resource
View.

To make sure that the SCI server


(Connection server) has been totally
updated with all current existing
logical links after a restart.
When a restart of the SCI server is
done a connection request to the
ResourceView will be done and when
getting the response with the first
logical links updates the timeout will
start.

Shut down of Data


Base setup
environment in
Resourceview.

When a
Trani store
event occur
the Timer
will be set.

5s
A timeout
signal is got
and no Trani
store event
call done
after the last
Timer was
set. If any
store event
done a new
timer will be
set.

To be able to shut down the


connection towards the Data Base
after usage (not used for tha last 5 s) in
the Resourceview.

If the
xs
Control
max 18s
Response
signal is
received by
the sender
within the
timeout time
the timeout
is cancelled.

To make sure that a send Ctrl Req


signal is received within a certain time
and a Ctrl Rsp signal is returned. (The
receiver might not exist any longer).
The timeout time depends on how
many other outstanding Ctrl Req
signals there are.
A timeout Ctrl Req signal will be
answered with a faked Ctrl Rsp signal
to the sender.

Control Request
Whenever a
signal timeout in the control
Announce protocol. request
signal has
been sent.

Timeout used when


filtering the changed
plane status.
Planemanager.
Timeout used when
sending
RO_ANNOUNCE
in Planemanager.

5s

Started when
RO_ANNO
UNCE is
sent.

End when
45s
RO_ANNO
UNCE is
cfm. If
timeout the
RO_ANNO
UNCE is
considered
to be lost and
a new
RO_ANNO
UNCE will
be sent.

Could probably be removed next time


the code is updated.

FUNCTION DESCRIPTION
Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

Table 4. SPAS SW timers


Timeout when
creating a Plane
manager.

Delete the
8s
Plane
Manager, i.e.
cancel
subscription
and initialise
attributes.
RO_ANNO
UNCE_CTR
L_CFM with
reject is sent.

Timer used when


Status is
Planemanager
requested
request PCC status. from Plane
Change
Control

Current PCC 2,5s


Status is
received

Meta signalling.

2,5s

Meta signalling.

Timer used when


Planemanager are
sending lock or
unlock request to
the PCC

Lock or
Unlock
request to all
boards is
sent to PCC.

CFM is
received
from all
PCCs.
As long as
all boards
has not yet
been heard
from a new
timeout will
be started.

The PCC will try to For every try


deactivate the SPIC a timer is
PCOC mechanism. started. If it
times out a
new
deactivation
request will
be sent to the
hwdrv.

The SPIC
PCOC
mechanism
is
deactivated

2s

Meta signalling.

The PCC will try to For every try


activate the SPIC
a timer is
PCOC mechanism. started. If it
times out a
new
activation
request will
be sent to the
hwdr.

The SPIC
PCOC
mechanism
is activated

2s

Meta signalling.

14(28)

FUNCTION DESCRIPTION

15(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

Table 4. SPAS SW timers


The handler
validates the plane
status and updates
the plane
operational status.

Plane status Plane status 5s


change is
has been
received
stable for 5s.
from hwdrv.

When a plane status tmo is received it


means that the plane status has been
stable for 5s.

Resourceannounce
proxy has a timer
which delays the
initialisation of a
resource.

2s

Could probably be removed next time


the code is updated.

In SaiRo there is a
timer to filter lost
maintenance cells
status indication
from hwdrv.

If there is a
change from
Bad to Good
indicated in
the
maintenance
cell start the
timer.

If the cell is 5s
still
indicating
good after 5s
then send
indication to
resourcevie
w.

The LAC request to


connect to the CRSserver but the
request is rejected.

Connection
request from
LAC to the
CRS-server
is rejected.

Timer times 20s


out. New
Connection
Request is
sent.

A timer to supervise A process


the CRS-update
restart has
flag.
occurred.
The CRS is
not yet
updated.
Start timer.

When time 5s
out. Set the
CRS updated
flag to
TRUE.

Timer for
GET_SUPA. In
Meta

Request for
SUPA

SUPA
received.

0,4s

Could probably be removed next time


the code is updated.

Get SMN

ID ask
SMN
SMinfo for received.
own SMN
from
SCB/CBU in
APN0 and 1

0.2s

Meta signalling.

FUNCTION DESCRIPTION

16(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

Table 4. SPAS SW timers

7.3

In order to detect the Info sent


case when two
extension SMs gets
the same SM
number, an
indication is sent
periodically
between the
SCBs/CBUs and
SXBs in Main that
are pared to give out
the same SM
number.

Info sent
next time

2s

For detection of cabling error in main


SM

SMID ask the other


SCB/CBU for
another opinion of
the SMN.

SMID ask
the other
SCB/CBU
for another
opinion on
the SMN.

SMN
received

0,66 s * max 3 retries.


number
of tries.

Number of restarts

Retrieve
from
restarted
boards no
restarts

All boards 2s
has
responded. If
not all
boards has
responded.,
the timer
restarts.

Meta signalling.

Subscription on
opState for
LinkGroup

Subscribe on
FRO_STAT
E. The
resource
view is not
ready.

Resource
0,2s
view ready
and
FRO_STAT
E is received,

Timer restarted at each try,

Memory usage
NOTE: The figures in this chapter describes Cello 4 software.

7.3.1

Load module sizes


The sizes of the SPAS load modules are specified in Table 5.
Table 5. Code size for SPAS load modules.
Load module
spas_resource*

Code Size (Kbytes)


1000

Distribution
MP/CBU

FUNCTION DESCRIPTION

17(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

Table 5. Code size for SPAS load modules.


Load module

Code Size (Kbytes)

Distribution

spas_connection**

76

MP/CBU

spas_link**

56

BP (SCB/CBU + SXB)

spas_sm**

93

BP (SCB/CBU)

* Valid for Cello 4.3-4


** Valid for Cello 4.3-1

The Code Size can be found in vobs/cello/spas/Spas_xxx_dm in file


XXX.map (there XXX is the load module name). In the XXX.map file is the
Code Size stated in the filed .text. The Code Size is in HEX.
7.3.2

Pool memory
The SPAS load module that uses the most memory is the spas_resource lm.
The theoretical pool memory consumption values in Table 6. are fetched from
the document Resource Consumption SPAS Resource LM, ref. [9].
Table 6. Pool memory usage by spas_resource lm.
Memory type

Theoretical Size (Kbytes)

Fixed size allocation1

49

Main SM

36

For each Extension SM

39

1. Fixed size allocation includes the stack


memory and other permanent allocated data.

Measurements have been performed on two different configurations using the


targetdata script, see ref. [11]. The script extracts Program size, Code size,
Pool allocation and usage and Heap allocation and usage for load modules on
target. The results of the measurements are shown in Table 7.
Table 7. Measured Pool size values.
Node size

Pool Size (Kbytes)

Minimum node (1 MP and


one SCB/CBU in Main
SM)

119

RNC_C node (Three SMs)

290

MGW (Six SMs)

Not measured

FUNCTION DESCRIPTION

18(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

Table 7. Measured Pool size values.


Node size

Pool Size (Kbytes)

RNC_F node (Six SMs)

Not measured

MGW_I node (Nine SMs)

Not measured

A graph describing the pool memory consumption as a function of the node


size is shown in Figure 2.
Figure 2. Pool memory consumption for spas_resource lm.

Pool Memory
400
350

kByte

300
250

Theoretical

200

Measured

150
100
50
0
0

Subracks

The measured values indicates that the values described in Table 6. are too
low. The difference might be explained for example by memory used by included proxies, memory used by other support processes in the load module
etc. In order to explain the differences in more detail, the work started in ref.
[9] should be finalized.
7.3.3

Heap memory
The theoretical values of heap memory used by the spas_resource load module is shown in Table 8.
Table 8. Heap memory usage by spas_resource lm
Memory type

Size (Kbytes)

Fixed size allocation1

Main SM

For each Extension SM

FUNCTION DESCRIPTION

19(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

1. Fixed size allocation includes the stack


memory and other permanent allocated data.

Measurements have been performed on two different configurations as described in chapter 7.3.2, page 17. The results of the measurements are shown
in Table 9.
Table 9. Measured heap size values.
Node size

Heap Size (Kbytes)

Minimum node (1 MP and


one SCB/CBU in Main SM)

49,4

RNC_C node (Three SMs)

52,5

MGW (Six SMs)

Not measured

RNC_F node (Six SMs)

Not measured

MGW_I node (Nine SMs)

Not measured

A graph describing the heap memory consumption as a function of the node


size is shown in Figure 3.
Figure 3. Heap memory consumption for spas_resource lm

Heap memory
60
50
kByte

40
Theoretical

30

Measured

20
10
0
0

Subracks

The measured values indicates that the values described in Table 8. are too
low. The difference might be explained for example by memory used by included proxies, memory used by other support processes in the load module
etc. Alignments has neither been considered.

FUNCTION DESCRIPTION

20(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

In order to explain the differences in more detail, the work started in ref. [9]
should be finalized.

Command Line Interface


This sub-chapter describes the shell commands, the administrative interface
that an operator can use when configure, managing and maintaining the SPAS
subsystem.
The interface is provided by a set of Cello Specific commands which are handled by a UNIX shell like command interpreter.

8.1

File Control commands


-

8.2

Configuration Command
-

8.3

Execution Control Commands


-

8.4

Testing Commands
-

8.5

PBOOT Manager & Flash File System Commands


-

8.6

Miscellaneous Commands

8.6.1

spashwinfo - SPAS Hardware Status Information (SPAS Internal Use)


Synopsis
spashwinfo [all|glt|ingrq|egrq<1/0>|red|silip|clk|sum|fs|cfs|help]
Description
This command is used for debugging of SPAS. The command retrieves and
presents the Spas HW status information.
Input parameters

FUNCTION DESCRIPTION

21(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

all

Snapshot of all Spas HW information

glt

Get link table, no option whole table or to smn

init

HW initiation status information

ingrq

Ingress queues lengths

egrq

Egress queues:
1-start recording
0-stop recording

red

Redundancy status

silip

Sili port status

sum

HW-driver status summary

clk

Clock status

fs

Fault record sending status

cfs

Clean fault sending counters

help

print help information

Limitations
Example
$ spashwinfo clk
HW Clock Status:
- Current clk: Internal
- Clk_A_stat: Error
- Clk_B_stat: Error
- Local_clk_stat: Ok

8.6.2

spaspccinfo - SPAS Plane Change Control Information (SPAS Internal


Use)
Synopsis
spaspccinfo
Description
This command is used for debugging of SPAS. The command retrieves and
presents the plane change control information.
Input parameters

FUNCTION DESCRIPTION

22(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

Limitations
Example
$ spaspccinfo
Plane Change Control Status:
- Active plane: A
- Ordered plane changes: 0 times
- Total plane changes: 0 times (Currently not working as it should)
- Control plane status: Enable
- Operational plane status: Enabled
- Armed plane status: Armed
- Plane A status: Ok
- Plane B status: Ok
- smAspStatusA: 1
- smAspStatusB: 0
8.6.3

spastopologyinfo - SPAS Topology Information (SPAS Internal Use)


Synopsis
spastopologyinfo
Description
This command is used for debugging of SPAS. The command retrieves and
presents the SPAS topology information
Input parameters
Limitations
Example
$ spastopologyinfo
Topology Info ID for board at APN APN 0 in SMN 0:
Active links are (smn1, apn1, port1 - smn2, apn2, port2):
(0, 0, 0 - 1, 0, 0)
(0, 0, 1 -2, 0, 0)
(0, 0, 2 -1, 0, 1)
(0, 0, 3 - 2, 0, 1)
Board map received from APN=1 indicates boards:
APN 0-31: 0 1 4 5 8 9 10 16 17 18 19 20

FUNCTION DESCRIPTION

23(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

APN 32-63:
Indicated restarting boards are:
APN 0-31:
APN 32-63:
Topology Info SMID:
SCB in Main SM
Connected links are (port - remote port):
(0 - 1)
(1 - 2)
(2 - 1)
(3 - 1)
8.6.4

spasrgroinfo - SPAS ReliableGroup Resource Object Information (SPAS


Internal Use)
Synopsis
spasrgroinfo
Description
This command is used for debugging of SPAS. The command retrieves and
presents the reliablegroup resource object information.
Input parameters
Limitations
Example
$ spasrgroinfo
Data for RgRo [0] is
Other APN 0, Other Port 0, Other EAPN0
ExtensionSm 1, Extension APN 1, ExtensionPort 0 LinkTableEntry 0
MainStatOwn 8, MainStatOther 8
Working 5, Supervise 5 (1=own, 2=Other, 3=Both)
MainStatOwnPhysLink 8, MainStatOtherPhysLink 8 (6=Enabled, 8=Disabled, 1=Unknown)
RelGrupRoState 3 (1=Init, 2=Announce, 3=Stopped, 4=Created, 5=InitStopped)
ModeFlag 2 (1=Primitive, 2=Normal)=
LinkTableError0-31 0x0, LinktableError32-63 0x0
Data for RgRo [1] is
Other APN 0, Other Port 1, Other EAPN0
ExtensionSm 1, Extension APN 1, ExtensionPort 1LinkTableEntry 0

FUNCTION DESCRIPTION

24(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

MainStatOwn 8, MainStatOther 8
Working 5, Supervise 5 (1=own, 2=Other, 3=Both)
MainStatOwnPhysLink 8, MainStatOtherPhysLink 8 (6=Enabled, 8=Disabled, 1=Unknown)
RelGrupRoState 3 (1=Init, 2=Announce, 3=Stopped, 4=Created, 5=InitStopped)
ModeFlag 2 (1=Primitive, 2=Normal)=
LinkTableError0-31 0x0, LinktableError32-63 0x0
Data for RgRo [2] is
Other APN 0, Other Port 0, Other EAPN0
ExtensionSm 256, Extension APN 256, ExtensionPort 256 LinkTableEntry 0
MainStatOwn 8, MainStatOther 8
Working 5, Supervise 5 (1=own, 2=Other, 3=Both)
MainStatOwnPhysLink 8, MainStatOtherPhysLink 8 (6=Enabled, 8=Disabled, 1=Unknown)
RelGrupRoState 5 (1=Init, 2=Announce, 3=Stopped, 4=Created, 5=InitStopped)
ModeFlag 2 (1=Primitive, 2=Normal)=
LinkTableError0-31 0x0, LinktableError32-63 0x0
Data for RgRo [3] is
Other APN 0, Other Port 0, Other EAPN0
ExtensionSm 256, Extension APN 256, ExtensionPort 256 LinkTableEntry 0
MainStatOwn 8, MainStatOther 8
Working 5, Supervise 5 (1=own, 2=Other, 3=Both)
MainStatOwnPhysLink 8, MainStatOtherPhysLink 8 (6=Enabled, 8=Disabled, 1=Unknown)
RelGrupRoState 5 (1=Init, 2=Announce, 3=Stopped, 4=Created, 5=InitStopped)
ModeFlag 2 (1=Primitive, 2=Normal)=
LinkTableError0-31 0x0, LinktableError32-63 0x0
8.6.5

spasislledinfo - SPAS ISL LED Information (SPAS Internal Use)


Synopsis
spasislledinfo
Description
This command is used for debugging of SPAS. The command prints the LED
status for the ISL LEDs in SPAS.
Input parameters
Limitations
-

FUNCTION DESCRIPTION

25(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

Example
$ spasislledinfo
Ledstatus ISL0 = ISL_LED_FLICKERING
Ledstatus ISL1 = ISL_LED_ON
Ledstatus ISL2 = ISL_LED_OFF
Ledstatus ISL3 = ISL_LED_SLOW
8.6.6

readAsccReg - Read ASCC Register (SPAS Internal Use)


Synopsis
readAsccReg <reg number in hex> <plane [a|A] or [b|B]>
Description
Please note: This command shall only be used by SPAS experts due to limitations in the implementation.
This command is used for debugging of SPAS. The command reads the
ASCC register and presents the results. For a list of available ASCC registers
and theire different meanings see ref. [16].
Input parameters
reg number in HEX

The register number to read in HEX

plane [a|A] or [b|B]

The plane from which the register is read.


a or A - Plane A
b or B - Plane B

Limitations
Please not that by using this command some of the register values are reset.
See ref. [16] for details.
Example
No example included. (Currently the command do not working as it should)
8.6.7

readSpicReg - Read SPIC Register (SPAS Internal Use)


Synopsis
readSpicReg <reg number in hex>[[-bit|-byte|-bb]<size>|list]
Description
Please note: This command shall only be used by SPAS experts due to limitations in the implementation.
This command is used for debugging of SPAS. The command reads a SPIC
register and presents the results. For a list of all available SPIC registers and
theire different meanings see ref. [8].

FUNCTION DESCRIPTION

26(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen


Datum - Date

Rev

2005-01-27

D1

File

Input parameters
reg number in HEX

The register number to read, in HEX

bit<size>

Presents the result in; <size> numbers of bits.


Default presentation mode.

byte<size>

Presents the result in; <size> number of bytes


each byte is presented in HEX.

bb<size>

Presents the result in; <size> number of bytes


each byte is presented in bits.

list

Provides a list of all SPIC registers with the


following format:
Reg|Name|Bits|R/W|Reset|Default|
Reg
Name
Bits
R/W
Reset

Default

- Register number in HEX


- Register name
- Number of Bits
- If the register is Read or Write or
Both
- Reset Mode possible values are:
Whole
- Reset whole register
Mask
- Reset bit by bit
None
- No reset
- Deafult value after reset

Limitations
Please not that by using this command some of the register values are reset.
Seeref. [8] for details.
Example
$ readSpicReg 3000 -bit 10
7
01

3
1111

0
0100

$ readSpicReg 3000 -byte 5


4
00

3
00

2
00

1
01

0
f4

0000 0000

0000 0001

1111 0100

$ readSpicReg 3000 -bb 5


I 4 II 3 II 2 II 1 II 0 I
0000 0000 0000 0000

FUNCTION DESCRIPTION

27(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen

Datum - Date

Rev

2005-01-27

D1

File

LOG Identity used in ELGI


When SPAS writes in the HW Fault Log via ELGI a message string shall be
provided containing the found fault. This message string begins with a Log
Identity. The Log Identity is a three character alpha numeric string. The string
is always 3 characters. SPAS shall use the range K00 - KZZ.
Table 10. Table over used Log Identities in SPAS

10

Log Identity

Usage

K00

SPIC Fault during HW


Start up Test

K01

ASCC Fault during HW


Start up Test

Abbreviations
ASCC

ATM Switch Core Circuit

ASCI

ATM Switch Core Circuit

CBU

Cello Basic Unit

DBM

Device Board Module

ELGI

Hardware Fault Log Interface

FRO

Facade Resource Object

ISL

Inter Subrack Link

LED

Light Emitting Diode

LM

Load Module

MAO

Management Adaptation Object

MGW

Media GateWay

MP

Main Processor

NVPI

Non Volantile Parameter Interface

RCU

Row Column Unit

RNC

Radio Network Controller

SAI

SPAS Access Interface

SCB

Switch Core Board

SILI

SPAS internal Link Interface

FUNCTION DESCRIPTION

28(28)

Nr - No.

10/155 16-CRX 901 52/1 Uen

11

Datum - Date

Rev

2005-01-27

D1

File

SM

Switch Module

SPAS

Space Switching

SPIC

Switch Port interface Circuit

SSI

Synchronization Support Interface

SXB

Switch Extension Board

SUPA

Space switch User Port Address

SUUA

SAI User Unit address

TPO

Switch Troughput Optimization

QoS

Quality of Service

References
[1]

FS-CELLO:EQUIPMENT_RESOURCES_SF

[2]

FD_SWITCH_REDUNDANCY-CELLO:SPAS:SPAS_SUBSYS

[3]

FD_LINK_REDUNDANCY-CELLO:SPAS:SPAS_SUBSYS

[4]

1/FD_CONNECTION-CELLO:SPAS_SUBSYS

[5]

20/DesignRules_ProcPrio-CELLO:SYSTEM

[6]

ERA/RL-00:1912

[7]

2/UserGuide-CELLO:CLS:DBM_PBA

[8]

IWD-CELLO:SPAS:BP-SPIU_IFU

[9]

ERA/FRL-01:1111, Rev PA1

[10] ERA/RL-00:1453
[11] target data script
The script can be found in clearcase in the
/vobs/cello/civ/test_utilities/scripts/targetdata directory.

[12] ObjSpec_SLT-CELLO:SPAS:TOPOLOGY_SWB
[13] 6/ObjSpec_LED-CELLO:SPAS:HWSUPPORT_SWB
[14] ObjSpec_SILIP-CELLO:SPAS:LINK_SWB
[15] 3/ObjSpec-CELLO:SPAS:USERPORT_SWB
[16] IWD-CELLO:SPAS:ASCI_IFU
[17] 6/FD_START-CELLO:SPAS_SUBSYS
[18] 23/DesignRules_HWTest-CELLO:SYSTEM