Skip to content
Projects
Groups
Snippets
Help
Loading...
Sign in
Toggle navigation
W
White Rabbit Switch - Software
Project
Project
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
86
Issues
86
List
Board
Labels
Milestones
Merge Requests
4
Merge Requests
4
CI / CD
CI / CD
Pipelines
Schedules
Wiki
Wiki
image/svg+xml
Discourse
Discourse
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Commits
Issue Boards
Open sidebar
Projects
White Rabbit Switch - Software
Commits
f49c4253
Commit
f49c4253
authored
Dec 13, 2016
by
Grzegorz Daniluk
Committed by
Adam Wujek
Dec 13, 2016
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
doc: some more fixes after re-reading the user-manual
parent
3aea91e2
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
194 additions
and
184 deletions
+194
-184
wrs-user-manual.in
doc/wrs-user-manual.in
+194
-184
No files found.
doc/wrs-user-manual.in
View file @
f49c4253
...
@@ -97,15 +97,15 @@ This is the current set of manuals that accompany the @sc{wrs}:
...
@@ -97,15 +97,15 @@ This is the current set of manuals that accompany the @sc{wrs}:
@item @i
{
White Rabbit Switch: Developer's Manual
}
: it describes the
@item @i
{
White Rabbit Switch: Developer's Manual
}
: it describes the
build procedure and how internals work; use of scripts and
build procedure and how internals work; use of scripts and
@sc
{
wrs
}
-specific programs
and so on
. The manual is by developers
@sc
{
wrs
}
-specific programs
etc
. The manual is by developers
and for developers. This is the
and for developers. This is the
document to check if you need to customize your @i
{
wrs
}
rebuild
document to check if you need to customize your @i
{
wrs
}
rebuild
software from new repository commits that are not an official release
software from new repository commits that are not an official release
point, or just install your @i
{
wrs
}
with custom configuration values.
point, or just install your @i
{
wrs
}
with custom configuration values.
@item @i
{
White Rabbit Switch: Failures and Diagnostics
}
: describe various
@item @i
{
White Rabbit Switch: Failures and Diagnostics
}
: describe
s
various
failure scenarios of a switch and ways how to recognize them.
failure scenarios of a switch and ways how to recognize them.
Additionally
describe
SNMP exports of a switch (@t
{
WR-SWITCH-MIB
}
).
Additionally
, it describes
SNMP exports of a switch (@t
{
WR-SWITCH-MIB
}
).
@end itemize
@end itemize
...
@@ -150,10 +150,9 @@ If you run version 4.1 or later please copy @t{wrs-firmware.tar} file into
...
@@ -150,10 +150,9 @@ If you run version 4.1 or later please copy @t{wrs-firmware.tar} file into
the @t
{
/update
}
partition via @t
{
scp
}
or web-interface and restart your switch.
the @t
{
/update
}
partition via @t
{
scp
}
or web-interface and restart your switch.
When the running version during the update is at least v5.0, then update script
When the running version during the update is at least v5.0, then update script
performs the check of md5sums of all files inside @t
{
wrs-firmware.tar
}
.
performs the check of md5 sums of all files inside the @t
{
wrs-firmware.tar
}
.
In case at least one checksum is wrong then update is aborted.
If at least one checksum is incorrect, the update is aborted and an error is
When occurs, the checksum error is reported via SNMP (object
reported via SNMP (object @t
{
wrsFwUpdateStatus
}
) until the next successful update.
@t
{
wrsFwUpdateStatus
}
) until the next successful update.
Additionally, the @t
{
wrs-firmware.tar
}
containing corrupted file is renamed to
Additionally, the @t
{
wrs-firmware.tar
}
containing corrupted file is renamed to
@t
{
wrs-firmware.tar.checksum
_
error
}
. This file is automatically removed during
@t
{
wrs-firmware.tar.checksum
_
error
}
. This file is automatically removed during
the next successful update.
the next successful update.
...
@@ -197,15 +196,14 @@ includes the MAC addresses for the management Ethernet and the
...
@@ -197,15 +196,14 @@ includes the MAC addresses for the management Ethernet and the
@i
{
hwinfo
}
, using the @sc
{
sdb
}
file format. @sc
{
sdb
}
is defined in the
@i
{
hwinfo
}
, using the @sc
{
sdb
}
file format. @sc
{
sdb
}
is defined in the
@t
{
fpga-configuration-space
}
within @t
{
ohwr.org
}
. Before using
@t
{
fpga-configuration-space
}
within @t
{
ohwr.org
}
. Before using
@sc
{
sdb
}
we used to edit the boot loader's configuration at flash
@sc
{
sdb
}
we used to edit the boot loader's configuration at flash
time
, a bad practice developed in a hurry
.
time.
The @i
{
hwinfo
}
structure is now written to @i
{
dataflash
}
by the
The @i
{
hwinfo
}
structure is written to @i
{
dataflash
}
by the manufacturer. It is
manufacturer, and never changed even when performing a complete re-flash
never changed even when performing a complete re-flash of the device, because
of the device, because the flashing scripts preserve the @i
{
hwinfo
}
the flashing scripts preserve the @i
{
hwinfo
}
memory area.
memory area.
When upgrading from a pre-4.1 switch software, you need to create this
When upgrading from a pre-4.1 switch software, you need to create this
@i
{
hwinfo
}
data structure. Th
is
procedure is mostly automatic, but you
@i
{
hwinfo
}
data structure. Th
e
procedure is mostly automatic, but you
need to be aware of the steps involved, in case something goes wrong.
need to be aware of the steps involved, in case something goes wrong.
@c ==========================================================================
@c ==========================================================================
...
@@ -221,9 +219,9 @@ cable is not plugged, the upgrade procedure blocks.
...
@@ -221,9 +219,9 @@ cable is not plugged, the upgrade procedure blocks.
This latter problem happens because messages are written to the
This latter problem happens because messages are written to the
management USB port, to help people flashing from scratch, and the
management USB port, to help people flashing from scratch, and the
write is a blocking one by default: if nobody collects the USB data,
write is a blocking one by default: if nobody collects the USB data,
the system waits for a recipient. With version 4.1.1
we fixed the
the system waits for a recipient. With version 4.1.1
the problem was fixed using
problem, using non-blocking operations; we'd better loose messages
non-blocking operations (it is better to loose messages than to block the
than block installation because nobody is reading
.
installation because nobody is reading)
.
Thus, there are two different ways to upgrade; which one
Thus, there are two different ways to upgrade; which one
you prefer we can't tell. Both work, each with its own drawbacks.
you prefer we can't tell. Both work, each with its own drawbacks.
...
@@ -313,7 +311,7 @@ especially if you want to preserve your MAC addresses.
...
@@ -313,7 +311,7 @@ especially if you want to preserve your MAC addresses.
One possible path is flashing version 4.0 (please refer to v4.0
One possible path is flashing version 4.0 (please refer to v4.0
manuals) and then proceed as described in @ref
{
Upgrading from v4.0
}
.
manuals) and then proceed as described in @ref
{
Upgrading from v4.0
}
.
When flashing version 4.0 you'll need to pass your MAC addresses on
When flashing version 4.0 you'll need to pass your MAC addresses on
the command line of the flasher, so please take not of what they are.
the command line of the flasher, so please take not
e
of what they are.
Another option is flashing the latest firmware version and then build
Another option is flashing the latest firmware version and then build
your own @i
{
hwinfo
}
structure by specifying your MAC addresses.
your own @i
{
hwinfo
}
structure by specifying your MAC addresses.
...
@@ -406,17 +404,17 @@ sources are implemented in current version:
...
@@ -406,17 +404,17 @@ sources are implemented in current version:
Get a network location of a @t
{
dot-config
}
file from a DHCP server.
Get a network location of a @t
{
dot-config
}
file from a DHCP server.
Server can be configured in a way to provide the entire URL to
Server can be configured in a way to provide the entire URL to
the @t
{
dot-config
}
in the ``@t
{
filename
}
'' configuration field of the
the @t
{
dot-config
}
in the ``@t
{
filename
}
'' configuration field of the
DHCP server. In this case
the
provided URL has to be in the same form
DHCP server. In this case
,
provided URL has to be in the same form
as @t
{
CONFIG
_
DOTCONF
_
URL
}
.
as @t
{
CONFIG
_
DOTCONF
_
URL
}
.
As an alternative, ``@t
{
filename
}
'' can be configured only as a
As an alternative, ``@t
{
filename
}
'' can be configured only as a
path. It will be then interpreted as a path on a
tftp
server, which IP
path. It will be then interpreted as a path on a
TFTP
server, which IP
address is taken from the configuration field
address is taken from the configuration field
``@t
{
The BOOTP next server option
}
'' of a DHCP server.
``@t
{
The BOOTP next server option
}
'' of a DHCP server.
@item CONFIG
_
DOTCONF
_
SOURCE
_
TRY
_
DHCP
@item CONFIG
_
DOTCONF
_
SOURCE
_
TRY
_
DHCP
The same as @t
{
CONFIG
_
DOTCONF
_
SOURCE
_
FORCE
_
DHCP
}
, but this option does
The same as @t
{
CONFIG
_
DOTCONF
_
SOURCE
_
FORCE
_
DHCP
}
, but this option does
not cause errors in SNMP's objects if
the
switch fails to retrieve the
not cause errors in SNMP's objects if switch fails to retrieve the
URL to the @t
{
dot-config
}
via DHCP. Note that syntax and download
URL to the @t
{
dot-config
}
via DHCP. Note that syntax and download
errors of @t
{
dot-config
}
are notified in the same way as for other
errors of @t
{
dot-config
}
are notified in the same way as for other
choices.
choices.
...
@@ -425,14 +423,14 @@ sources are implemented in current version:
...
@@ -425,14 +423,14 @@ sources are implemented in current version:
If the selected option triggers @sc
{
wrs
}
to download a new @t
{
dot-config
}
If the selected option triggers @sc
{
wrs
}
to download a new @t
{
dot-config
}
file and it passes the validation process, the new @t
{
dot-config
}
will replace
file and it passes the validation process, the new @t
{
dot-config
}
will replace
the copy in the local storage
. In case there are errors or unknown
a local copy
. In case there are errors or unknown
configuration entries in the retrieved file, the old one will be used.
configuration entries in the retrieved file, the old one will be used.
The URL (stored in @t
{
CONFIG
_
DOTCONF
_
URL
}
or retrieved via DHCP) is of the form
The URL (stored in @t
{
CONFIG
_
DOTCONF
_
URL
}
or retrieved via DHCP) is of the form
``@i
{
protocol
}
@t
{
://
}
@i
{
host
}
@t
{
/
}
@i
{
pathname
}
''. The special upper-case
``@i
{
protocol
}
@t
{
://
}
@i
{
host
}
@t
{
/
}
@i
{
pathname
}
''. The special upper-case
strings @t
{
HOSTNAME
}
, @t
{
IPADDR
}
and @t
{
MACADDR
}
are substituted with the
strings @t
{
HOSTNAME
}
, @t
{
IPADDR
}
and @t
{
MACADDR
}
are substituted with the
current hostname, IP address
es
or MAC address of the management port of the
current hostname, IP address or MAC address of the management port of the
switch. By this the same configuration string can be used to set up a batch
switch. By this
,
the same configuration string can be used to set up a batch
of switches with different configurations.
of switches with different configurations.
The three parts of the URL are as follows:
The three parts of the URL are as follows:
...
@@ -468,10 +466,9 @@ For example this is a valid configuration for run-time update:
...
@@ -468,10 +466,9 @@ For example this is a valid configuration for run-time update:
CONFIG
_
DNS
_
DOMAIN="i.gnudd.com"
CONFIG
_
DNS
_
DOMAIN="i.gnudd.com"
@end smallexample
@end smallexample
And it results, in my case, in @t
{
wrs-config-192.168.16.9
}
being
It results in @t
{
wrs-config-192.168.16.9
}
being served to the @sc
{
wrs
}
.
served to the @sc
{
wrs
}
.
Please remember that the new @t
{
dot-config
}
should include a valid
Please remember
,
that the new @t
{
dot-config
}
should include a valid
@t
{
CONFIG
_
DOTCONF
_
SOURCE
_
*
}
setting, or you won't be able to update the
@t
{
CONFIG
_
DOTCONF
_
SOURCE
_
*
}
setting, or you won't be able to update the
configuration at the next boot. In any case, you can always copy a
configuration at the next boot. In any case, you can always copy a
configuration file using @i
{
ssh
}
, or use the web interface to change the
configuration file using @i
{
ssh
}
, or use the web interface to change the
...
@@ -588,7 +585,7 @@ appropriate way, before the respective service is started.
...
@@ -588,7 +585,7 @@ appropriate way, before the respective service is started.
The DNS server (as an IP address) and default domain. The values
The DNS server (as an IP address) and default domain. The values
end up in @t
{
/etc/resolv.conf
}
of the runtime filesystem.
end up in @t
{
/etc/resolv.conf
}
of the runtime filesystem.
By default the two strings are empty. If @t
{
CONFIG
_
ETH0
_
DHCP
}
or
By default the two strings are empty. If @t
{
CONFIG
_
ETH0
_
DHCP
}
or
@t
{
CONFIG
_
ETH0
_
DHCP
_
ONCE
}
is used
file @t
{
/etc/resolv.conf
}
will be
@t
{
CONFIG
_
ETH0
_
DHCP
_
ONCE
}
is used
, @t
{
/etc/resolv.conf
}
file
will be
populated with DNS settings received from the DHCP server.
populated with DNS settings received from the DHCP server.
If configuration items for static (@t
{
CONFIG
_
DNS
_
*
}
) and dynamic
If configuration items for static (@t
{
CONFIG
_
DNS
_
*
}
) and dynamic
(@t
{
CONFIG
_
ETH0
_
DHCP
}
) DNS configuration are used simultaneously
(@t
{
CONFIG
_
ETH0
_
DHCP
}
) DNS configuration are used simultaneously
...
@@ -612,28 +609,28 @@ appropriate way, before the respective service is started.
...
@@ -612,28 +609,28 @@ appropriate way, before the respective service is started.
@t
{
CONFIG
_
WRS
_
LOG
_
OTHER
}
is currently used by:
@t
{
CONFIG
_
WRS
_
LOG
_
OTHER
}
is currently used by:
@itemize
@itemize
@item @t
{
wrs
_
watchdog
}
daemon
@item @t
{
wrs
_
watchdog
}
daemon
@item @t
{
wrs
_
throttling
}
executed at boot up
@item @t
{
wrs
_
throttling
}
executed
once
at boot up
@item @t
{
wrs
_
auxclk
}
executed at boot up
@item @t
{
wrs
_
auxclk
}
executed
once
at boot up
@item @t
{
wrs
_
custom
_
boot
_
script.sh
}
executed at boot up
@item @t
{
wrs
_
custom
_
boot
_
script.sh
}
executed
once
at boot up
@item Setting VLANs with @t
{
vlan.sh
}
at boot up
@item Setting VLANs with @t
{
vlan.sh
}
at boot up
@end itemize
@end itemize
Each value
Each value
can be a pathname,
to select logging to file (and
@t
{
/dev/kmsg
}
can be a pathname,
either to a file (e.g.
@t
{
/dev/kmsg
}
is a possible ``file'' target) or a @i
{
facility
}
.@i
{
level
}
string,
is a possible ``file'' target) or a @i
{
facility
}
.@i
{
level
}
string,
like @t
{
daemon.debug
}
, for syslog-based logging.
like @t
{
daemon.debug
}
, for syslog-based logging.
An empty strings selects no logging at all. Please note that
An empty strings selects no logging at all. Please note
,
that
unknown facility names will generate a runtime error on the switch.
unknown facility names will generate a runtime error on the switch.
All four strings default to ``@t
{
daemon.info
}
''.
All four strings default to ``@t
{
daemon.info
}
''.
@item CONFIG
_
WRS
_
LOG
_
SNMPD
@item CONFIG
_
WRS
_
LOG
_
SNMPD
Value can be a pathname,
to select logging to file (and
Value can be a pathname,
either to a file (e.g.
@t
{
/dev/kmsg
}
is a possible ``file'' target) or a valid snmpd log
@t
{
/dev/kmsg
}
is a possible ``file'' target) or a valid snmpd log
option (without -L).
option (without -L).
Allowed strings are in the format ``@t
{
S
}
@i
{
level
}
@i
{
facility
}
'' (e.g.
Allowed strings are in the format ``@t
{
S
}
@i
{
level
}
@i
{
facility
}
'' (e.g.
``@t
{
S 2 daemon
}
''). For example, ``@t
{
s daemon
}
'' will forward
``@t
{
S 2 daemon
}
''). For example, ``@t
{
s daemon
}
'' will forward
messages to syslog with daemon as facility. To set level (i.e. 5) use
messages to syslog with daemon as facility. To set level (i.e. 5) use
``@t
{
S 5 daemon
}
''. For details please check
``man snmpcmd''
. An empty
``@t
{
S 5 daemon
}
''. For details please check
@t
{
man snmpcmd
}
. An empty
strings selects no logging at all. Please note that unknown facility
strings selects no logging at all. Please note that unknown facility
names will generate a runtime error on the switch. NOTE: It looks
names will generate a runtime error on the switch. NOTE: It looks
like @t
{
Notice
}
is not a default logging priority as written in
like @t
{
Notice
}
is not a default logging priority as written in
...
@@ -643,8 +640,8 @@ appropriate way, before the respective service is started.
...
@@ -643,8 +640,8 @@ appropriate way, before the respective service is started.
The string can be a pathname (e.g. @t
{
/dev/kmsg
}
) or a @t
{
syslog
}
The string can be a pathname (e.g. @t
{
/dev/kmsg
}
) or a @t
{
syslog
}
string.
string.
An empty string is used to represent no logging. If it is needed to
An empty string is used to represent no logging. If it is needed to
select facility and level please leave
here empty string
and change
select facility and level please leave
an empty string here
and change
@t
{
/etc/monitrc
}
or @t
{
/usr/
/
etc/monitrc
}
file directly.
@t
{
/etc/monitrc
}
or @t
{
/usr/etc/monitrc
}
file directly.
Please note that unknown facility names will generate a runtime error
Please note that unknown facility names will generate a runtime error
on the switch.
on the switch.
...
@@ -653,8 +650,8 @@ appropriate way, before the respective service is started.
...
@@ -653,8 +650,8 @@ appropriate way, before the respective service is started.
@itemx ...
@itemx ...
@itemx CONFIG
_
PORT18
_
PARAMS
@itemx CONFIG
_
PORT18
_
PARAMS
These configuration items are used to set up
ports' parameters;
These configuration items are used to set up
timing parameters of the
this takes the following parameter
s:
WR port
s:
@itemize
@itemize
@item @t
{
name
}
-- the name of a given interface
@item @t
{
name
}
-- the name of a given interface
...
@@ -668,22 +665,22 @@ appropriate way, before the respective service is started.
...
@@ -668,22 +665,22 @@ appropriate way, before the respective service is started.
@item @t
{
rx
}
-- RX delay of a port in picoseconds
@item @t
{
rx
}
-- RX delay of a port in picoseconds
@item @t
{
role
}
-- PTP role of a port; possible values:
@item @t
{
role
}
-- PTP role of a port; possible values:
@itemize
@itemize
@item @t
{
master
}
-- configure port as
a
master
@item @t
{
master
}
-- configure port as
WR
master
@item @t
{
slave
}
-- configure port as
a
slave
@item @t
{
slave
}
-- configure port as
WR
slave
@item @t
{
auto
}
-- when a port is connected to master
@item @t
{
auto
}
-- when a port is connected to master
behave as a slave, otherwise behave
behave as a slave, otherwise behave
as master
as master
@item @t
{
non-wr
}
--
don't report problems with this
@item @t
{
non-wr
}
--
for this port don't report SNMP
port via SNMP like
SFP not in DB,
errors like:
SFP not in DB,
copper SFP connected, non 1GB
copper SFP connected, non 1GB
SFP etc.
SFP etc. This role should be used
for synchronizing regular IEEE-1588
slaves.
@item @t
{
none
}
-- disable White Rabbit and PTP on a
@item @t
{
none
}
-- disable White Rabbit and PTP on a
port
port
@end itemize
@end itemize
@item @t
{
fiber
}
-- describes which fiber type
@item @t
{
fiber
}
-- fiber index from @t
{
CONFIG
_
FIBERXX
_
PARAMS
}
(@t
{
CONFIG
_
FIBERXX
_
PARAMS
}
)
that is connected to this port
should be used for a fiber connected to
a particular port
@end itemize
@end itemize
Most likely the default values work for you.
Most likely the default values work for you.
...
@@ -693,9 +690,9 @@ appropriate way, before the respective service is started.
...
@@ -693,9 +690,9 @@ appropriate way, before the respective service is started.
@itemx ...
@itemx ...
@itemx CONFIG
_
SFP09
_
PARAMS
@itemx CONFIG
_
SFP09
_
PARAMS
Configuration for @sc
{
sfp
}
models. You should fill
values for
Configuration for @sc
{
sfp
}
models. You should fill
all @sc
{
sfp
}
models
you are using in your @sc
{
wrs
}
and all
all @sc
{
sfp
}
models and all
wavelengths you are using
.
wavelengths you are using
in your @sc
{
wrs
}
@itemize
@itemize
@item @t
{
vn
}
(@i
{
optional
}
) -- Vendor Name of an SFP
@item @t
{
vn
}
(@i
{
optional
}
) -- Vendor Name of an SFP
@item @t
{
pn
}
-- Part Number of an SFP
@item @t
{
pn
}
-- Part Number of an SFP
...
@@ -705,7 +702,9 @@ appropriate way, before the respective service is started.
...
@@ -705,7 +702,9 @@ appropriate way, before the respective service is started.
@item @t
{
rx
}
-- RX delay of an SFP in picoseconds
@item @t
{
rx
}
-- RX delay of an SFP in picoseconds
@item @t
{
wl
_
txrx
}
-- Tx wavelength separated by "+" with Rx
@item @t
{
wl
_
txrx
}
-- Tx wavelength separated by "+" with Rx
wavelength of an SFP;
wavelength of an SFP;
for example @t
{
wl
_
txrx=1490+1310
}
for example @t
{
wl
_
txrx=1490+1310
}
(for
1490nm Tx wavelength and 1310nm Rx
wavelength)
@end itemize
@end itemize
See @ref
{
Timing Configuration
}
for details.
See @ref
{
Timing Configuration
}
for details.
...
@@ -713,7 +712,7 @@ appropriate way, before the respective service is started.
...
@@ -713,7 +712,7 @@ appropriate way, before the respective service is started.
@itemx ...
@itemx ...
@itemx CONFIG
_
FIBER03
_
PARAMS
@itemx CONFIG
_
FIBER03
_
PARAMS
This parameter specif
y
the physical features of used fiber types.
This parameter specif
ies
the physical features of used fiber types.
Specify the alpha value for each pair of used wavelengths.
Specify the alpha value for each pair of used wavelengths.
This parameter follows a format:
This parameter follows a format:
...
@@ -738,29 +737,29 @@ appropriate way, before the respective service is started.
...
@@ -738,29 +737,29 @@ appropriate way, before the respective service is started.
The type of PTP clock this switch is. Only one of the three
The type of PTP clock this switch is. Only one of the three
items should be set (e.g. running ``@t
{
make menuconfig
}
'' offers
items should be set (e.g. running ``@t
{
make menuconfig
}
'' offers
them as an exclusive choice). The options select
a grand-master
them as an exclusive choice). The options select
: a grand-master (GM)
with external reference,
from GPS or Cesium or both
; a free-running
with external reference,
e.g. GPS or Cesium
; a free-running
master, used for isolated acquisition networks, without an
master
(FM)
, used for isolated acquisition networks, without an
external reference; or a normal ``boundary-clock'' device that
external reference; or a normal ``boundary-clock''
(BC)
device that
is slave on some ports and master on other ports.
is slave on some ports and master on other ports.
@item CONFIG
_
PTP
_
PORT
_
PARAMS
@item CONFIG
_
PTP
_
PORT
_
PARAMS
@itemx CONFIG
_
PTP
_
CUSTOM
@itemx CONFIG
_
PTP
_
CUSTOM
@itemx CONFIG
_
PTP
_
REMOTE
_
CONF
@itemx CONFIG
_
PTP
_
REMOTE
_
CONF
By default, P
PSi
configuration file is assembled based on role and
By default, P
TP daemon (PPSi)
configuration file is assembled based on role and
protocol parameters stored in @t
{
PORTxx
_
PARAMS
}
. If VLANs are
protocol parameters stored in @t
{
PORTxx
_
PARAMS
}
. If VLANs are
configured
via @t
{
dot-config
}
additionally configuration
items
configured
, the
items
@t
{
CONFIG
_
VLANS
_
PORTXX
_
VID
}
are used.
@t
{
CONFIG
_
VLANS
_
PORTXX
_
VID
}
are used
as well
.
Parameters @t
{
clock-class
}
and @t
{
clock-accuracy
}
can be changed
Parameters @t
{
clock-class
}
and @t
{
clock-accuracy
}
can be changed
or new global PPSi settings can be added by editing file
or new global PPSi settings can be added by editing file
@t
{
/wr/etc/ppsi-pre.conf
}
, which is used as beg
g
ing of final
@t
{
/wr/etc/ppsi-pre.conf
}
, which is used as beg
inn
ing of final
pps
i configuration file.
PPS
i configuration file.
Alternatively
PPSi can use
custom user file for configuration
Alternatively
, PPSi can use a
custom user file for configuration
(@t
{
CONFIG
_
PTP
_
CUSTOM
}
).
(@t
{
CONFIG
_
PTP
_
CUSTOM
}
).
Finally, you can choose @t
{
PTP
_
REMOTE
_
CONF
}
and be able
to
Finally, you can choose @t
{
PTP
_
REMOTE
_
CONF
}
to
specify an URL whence the switch will download the @t
{
ppsi.conf
}
at
specify an URL whence the switch will download the @t
{
ppsi.conf
}
at
boot time.
boot time.
...
@@ -794,7 +793,7 @@ appropriate way, before the respective service is started.
...
@@ -794,7 +793,7 @@ appropriate way, before the respective service is started.
Configuration for the @sc
{
snmp
}
agent. Addresses can be IP addresses
Configuration for the @sc
{
snmp
}
agent. Addresses can be IP addresses
or names (if DNS is configured and working), they are unset by
or names (if DNS is configured and working), they are unset by
default. Community values are strings and they default to
default. Community values are strings and they default to
@t
{
public
}
and @t
{
private
}
.
@t
{
public
}
(@t
{
RO
_
COMMUNITY
}
) and @t
{
private
}
(@t
{
RW
_
COMMUNITY
}
)
.
@item CONFIG
_
SNMP
_
TEMP
_
THOLD
_
FPGA
@item CONFIG
_
SNMP
_
TEMP
_
THOLD
_
FPGA
@itemx CONFIG
_
SNMP
_
TEMP
_
THOLD
_
PLL
@itemx CONFIG
_
SNMP
_
TEMP
_
THOLD
_
PLL
...
@@ -802,20 +801,23 @@ appropriate way, before the respective service is started.
...
@@ -802,20 +801,23 @@ appropriate way, before the respective service is started.
@itemx CONFIG
_
SNMP
_
TEMP
_
THOLD
_
PSR
@itemx CONFIG
_
SNMP
_
TEMP
_
THOLD
_
PSR
Threshold levels for FPGA, PLL, Power Supply Left (PSL) and Power
Threshold levels for FPGA, PLL, Power Supply Left (PSL) and Power
Supply Right (PSR) temperature sensors. When any temperature exceeds
Supply Right (PSR) temperature sensors. When any temperature exceeds
threshold level SNMP object @t
{
WR-SWITCH-MIB::tempWarning
}
will change
threshold level
,
SNMP object @t
{
WR-SWITCH-MIB::tempWarning
}
will change
accordingly.
accordingly.
@item CONFIG
_
SNMP
_
SWCORESTATUS
_
HP
_
FRAME
_
RATE
@item CONFIG
_
SNMP
_
SWCORESTATUS
_
HP
_
FRAME
_
RATE
Error via SNMP if rate of HP frames on any port exceed given value.
Error via SNMP if the rate of HP frames on any port exceed given value.
(currently not implemented)
@item CONFIG
_
SNMP
_
SWCORESTATUS
_
RX
_
FRAME
_
RATE
@item CONFIG
_
SNMP
_
SWCORESTATUS
_
RX
_
FRAME
_
RATE
Error via SNMP if rate of RX frames on any port exceed given value.
Error via SNMP if rate of RX frames on any port exceed given value.
(currently not implemented)
@item CONFIG
_
SNMP
_
SWCORESTATUS
_
RX
_
PRIO
_
FRAME
_
RATE
@item CONFIG
_
SNMP
_
SWCORESTATUS
_
RX
_
PRIO
_
FRAME
_
RATE
Error if frame rate of any RX priority exceed given value.
Error if frame rate of any RX priority exceed given value.
(currently not implemented)
@item CONFIG
_
WRSAUXCLK
_
FREQ
@item CONFIG
_
WRSAUXCLK
_
FREQ
@itemx CONFIG
_
WRSAUXCLK
_
DUTY
@itemx CONFIG
_
WRSAUXCLK
_
DUTY
...
@@ -823,7 +825,8 @@ appropriate way, before the respective service is started.
...
@@ -823,7 +825,8 @@ appropriate way, before the respective service is started.
@itemx CONFIG
_
WRSAUXCLK
_
SIGDEL
@itemx CONFIG
_
WRSAUXCLK
_
SIGDEL
@itemx CONFIG
_
WRSAUXCLK
_
PPSHIFT
@itemx CONFIG
_
WRSAUXCLK
_
PPSHIFT
Set of parameters passed to @t
{
wrs
_
auxclk
}
at boot time.
Set of parameters passed to @t
{
wrs
_
auxclk
}
at boot time to generate
WR-synchronized 10MHz clock on the @i
{
clk2
}
output.
For more information please check @ref
{
wrs
_
auxclk
}
.
For more information please check @ref
{
wrs
_
auxclk
}
.
@item CONFIG
_
NIC
_
THROTTLING
_
ENABLED
@item CONFIG
_
NIC
_
THROTTLING
_
ENABLED
...
@@ -860,7 +863,7 @@ appropriate way, before the respective service is started.
...
@@ -860,7 +863,7 @@ appropriate way, before the respective service is started.
Disable monitoring of running processes by @i
{
Monit
}
. @i
{
Monit
}
by
Disable monitoring of running processes by @i
{
Monit
}
. @i
{
Monit
}
by
default
default
re-spawns processes that have died. This option
is useful most
ly during
re-spawns processes that have died. This option
should be used on
ly during
development.
development.
@item CONFIG
_
FAN
_
HYSTERESIS
@item CONFIG
_
FAN
_
HYSTERESIS
...
@@ -868,23 +871,26 @@ appropriate way, before the respective service is started.
...
@@ -868,23 +871,26 @@ appropriate way, before the respective service is started.
@itemx CONFIG
_
FAN
_
HYSTERESIS
_
T
_
ENABLE
@itemx CONFIG
_
FAN
_
HYSTERESIS
_
T
_
ENABLE
@itemx CONFIG
_
FAN
_
HYSTERESIS
_
PWM
_
VAL
@itemx CONFIG
_
FAN
_
HYSTERESIS
_
PWM
_
VAL
Use hysteresis to control
switch's
fans. Enable fans with PWM value
Use hysteresis to control fans. Enable fans with PWM value
@t
{
CONFIG
_
FAN
_
HYSTERESIS
_
PWM
_
VAL
}
when PLL's temperature exceeds
@t
{
CONFIG
_
FAN
_
HYSTERESIS
_
PWM
_
VAL
}
when PLL's temperature exceeds
@t
{
CONFIG
_
FAN
_
HYSTERESIS
_
T
_
ENABLE
}
. Disable fans when temperature drops
@t
{
CONFIG
_
FAN
_
HYSTERESIS
_
T
_
ENABLE
}
. Disable fans when temperature drops
below @t
{
CONFIG
_
FAN
_
HYSTERESIS
_
T
_
DISABLE
}
. These options are intended to
below @t
{
CONFIG
_
FAN
_
HYSTERESIS
_
T
_
DISABLE
}
. These options are intended to
be used during development to reduce noise generated by a switch.
be used during development to reduce noise generated by a switch.
Don't use in production as this may affect the synchronization
performance.
@item CONFIG
_
READ
_
SFP
_
DIAG
_
ENABLE
@item CONFIG
_
READ
_
SFP
_
DIAG
_
ENABLE
Let HAL to read @i
{
Diagnostic Monitoring
}
(DOM) from SFP's eeprom
like
Let HAL to read @i
{
Diagnostic Monitoring
}
(DOM) from SFP's eeprom
,
temperature, TX/RX power etc.
like:
temperature, TX/RX power etc.
@item CONFIG
_
RTU
_
HP
_
MASK
_
ENABLE
@item CONFIG
_
RTU
_
HP
_
MASK
_
ENABLE
@itemx CONFIG
_
RTU
_
HP
_
MASK
_
VAL
@itemx CONFIG
_
RTU
_
HP
_
MASK
_
VAL
Set the mask which VLAN priorities are considered High Priority (this
Set the mask which VLAN priorities are considered High Priority traffic
(this
only concerns the traffic which is fast-forwarded).
only concerns the traffic which is fast-forwarded).
To enable
the apply of the
custom mask please set
To enable
a
custom mask please set
@t
{
CONFIG
_
RTU
_
HP
_
MASK
_
ENABLE
}
.
@t
{
CONFIG
_
RTU
_
HP
_
MASK
_
ENABLE
}
.
@t
{
CONFIG
_
RTU
_
HP
_
MASK
_
VAL
}
shall contain the mask to be used.
@t
{
CONFIG
_
RTU
_
HP
_
MASK
_
VAL
}
shall contain the mask to be used.
...
@@ -898,38 +904,40 @@ appropriate way, before the respective service is started.
...
@@ -898,38 +904,40 @@ appropriate way, before the respective service is started.
@itemx CONFIG
_
VLANS
_
PORTXX
_
MODE
_
DISABLED
@itemx CONFIG
_
VLANS
_
PORTXX
_
MODE
_
DISABLED
@itemx CONFIG
_
VLANS
_
PORTXX
_
MODE
_
UNQUALIFIED
@itemx CONFIG
_
VLANS
_
PORTXX
_
MODE
_
UNQUALIFIED
VLANs mode configuration for ports 1..18.
VLANs
port
mode configuration for ports 1..18.
It can be one of: Access, Trunk, Disabled or Unqualified.
It can be one of: Access, Trunk, Disabled or Unqualified.
For details please refer to the @ref
{
VLANs Configuration
}
For details please refer to the @ref
{
VLANs Configuration
}
@item CONFIG
_
VLANS
_
PORTXX
_
UNTAG
_
ALL
@item CONFIG
_
VLANS
_
PORTXX
_
UNTAG
_
ALL
@itemx CONFIG
_
VLANS
_
PORTXX
_
UNTAG
_
NONE
@itemx CONFIG
_
VLANS
_
PORTXX
_
UNTAG
_
NONE
Define whether to remove a
tag from VLAN frames on a
port 1..18.
Define whether to remove a
VLAN tag from egress frames on
port 1..18.
@item CONFIG
_
VLANS
_
PORTXX
_
PRIO
@item CONFIG
_
VLANS
_
PORTXX
_
PRIO
Priority value used when tagging frames or to override priority
Priority value used when tagging incoming frames or to locally override
passed to RTU. -1 disables the priority overwrite. Valid values are
the priority (in Unqualified and Disabled modes).
-1 disables the priority overwrite. Valid values are
from -1 to 7.
from -1 to 7.
@item CONFIG
_
VLANS
_
PORTXX
_
VID
@item CONFIG
_
VLANS
_
PORTXX
_
VID
This value based on the port's mode is used as:
The meaning of this value and whether it is mandatory or optional,
depends on the port mode:
@itemize
@itemize
@item @t
{
MODE
_
ACCESS
}
-- (mandatory) use as VID for tagging incoming
@item @t
{
MODE
_
ACCESS
}
-- (mandatory) use as VID for tagging incoming
frames and notify
the PPSI which VLAN shall it use
for
frames and notify
PPSi which VLAN shall be used
for
synchronization; only one VLAN number shall be used in this mode
synchronization; only one VLAN number shall be used in this mode
@item @t
{
MODE
_
TRUNK
}
- (optional) notify
the PPSI
which VLAN(s) shall
@item @t
{
MODE
_
TRUNK
}
- (optional) notify
PPSi
which VLAN(s) shall
it use for synchronization; semicolon separated list is allowed
it use for synchronization; semicolon separated list is allowed
@item @t
{
MODE
_
DISABLED
}
- (optional) notify
the PPSI
which VLAN(s)
@item @t
{
MODE
_
DISABLED
}
- (optional) notify
PPSi
which VLAN(s)
shall it use for synchronization; semicolon separated list is allowed
shall it use for synchronization; semicolon separated list is allowed
@item @t
{
MODE
_
UNQUALIFIED
}
- (optional) notify
the PPSI
which VLAN(s)
@item @t
{
MODE
_
UNQUALIFIED
}
- (optional) notify
PPSi
which VLAN(s)
shall it use for synchronization; semicolon separated list is allowed
shall it use for synchronization; semicolon separated list is allowed
@end itemize
@end itemize
The range of a valid VID is from 0 to 4094.
The range of a valid VID is from 0 to 4094.
Please note that in th
e v5.0 it is not possible to set via
@b
{
Note:
}
In firmwar
e v5.0 it is not possible to set via
@t
{
dot-config
}
an override of VLAN tag for @t
{
UNQUALIFIED
}
mode.
@t
{
dot-config
}
an override of VLAN tag for @t
{
UNQUALIFIED
}
mode.
For details please refer to the @ref
{
VLANs Configuration
}
For details please refer to the @ref
{
VLANs Configuration
}
...
@@ -939,30 +947,32 @@ appropriate way, before the respective service is started.
...
@@ -939,30 +947,32 @@ appropriate way, before the respective service is started.
Provide a configuration for VLAN from the range 0000-4094.
Provide a configuration for VLAN from the range 0000-4094.
This option is a comma separated string in the following format:
This option is a comma separated string in the following format:
@t
{
fid=<0..4094>,prio=<-1|0..7>,drop=<y|n>,ports=<1
>;<2>;...;<...-...>;<
18>
}
@t
{
fid=<0..4094>,prio=<-1|0..7>,drop=<y|n>,ports=<1
;2;...;...-...;
18>
}
Where:
Where:
@itemize
@itemize
@item @t
{
fid
}
is a associated Filtering ID (FID) number. One FID can be
@item @t
{
fid
}
is a associated Filtering ID (FID) number. This parameter
may be useful for complex VLAN configurations. In simple cases it can
be omitted. One FID can be
associated with many VIDs. RTU learning is performed per-FID.
associated with many VIDs. RTU learning is performed per-FID.
Associating many VIDs with a single FID allowed shared-VLANs
Associating many VIDs with a single FID allowed shared-VLANs
learning.
learning.
@item @t
{
prio
}
is a priority of a VLAN; can take values between -1 and
@item @t
{
prio
}
is a priority of a VLAN; can take values between -1 and
7;
7;
-1 disables priority override, any other valid
value
takes
-1 disables priority override, any other valid
number
takes
precedence over port priority
precedence over
the
port priority
@item If @t
{
drop
}
is set to @t
{
y
}
, @t
{
yes
}
or @t
{
1
}
, all frames
@item If @t
{
drop
}
is set to @t
{
y
}
, @t
{
yes
}
or @t
{
1
}
, all frames
belonging to this VID are dropped (note that frame can belong to a
belonging to this VID are dropped (note that frame can belong to a
VID as a consequence of per-port Endpoint configuration); can take
VID as a consequence of per-port Endpoint configuration); can take
values @t
{
y
}
, @t
{
yes
}
, @t
{
1
}
, @t
{
n
}
, @t
{
no
}
, @t
{
0
}
values @t
{
y
}
, @t
{
yes
}
, @t
{
1
}
, @t
{
n
}
, @t
{
no
}
, @t
{
0
}
@item @t
{
ports
}
is a list of ports separated with a semicolon sign
@item @t
{
ports
}
is a list of ports separated with a semicolon sign
(";"); ports ranges are supported (with a
minus sign
)
(";"); ports ranges are supported (with a
dash character
)
@end itemize
@end itemize
Example:
Example:
@t
{
fid=4,prio=2,drop=n,ports=1;3-5;15
}
@t
{
fid=4,prio=2,drop=n,ports=1;3-5;15
}
It sets
fid
as 4, priority 2, don't drop frames belonging to this VLAN,
It sets
FID
as 4, priority 2, don't drop frames belonging to this VLAN,
assign ports 1, 3-5 and 15 to this VLAN.
assign ports 1, 3-5 and 15 to this VLAN.
For more details about VLANs configuration please refer to the
For more details about VLANs configuration please refer to the
...
@@ -1001,21 +1011,21 @@ values depend on trace length and other hardware-specific details
...
@@ -1001,21 +1011,21 @@ values depend on trace length and other hardware-specific details
and are determined by a calibration procedure. These values are
and are determined by a calibration procedure. These values are
used as constant delays in the @i
{
tx
}
and @i
{
rx
}
directions.
used as constant delays in the @i
{
tx
}
and @i
{
rx
}
directions.
@item The port is also configured as slave (@i
{
role
}
) using raw whiterabbit
@item The port is also configured as
WR
slave (@i
{
role
}
) using raw whiterabbit
protocol (@i
{
proto
}
) and is deployed using fiber type 2 -- this number
protocol (@i
{
proto
}
) and is deployed using fiber type 2 -- this number
is just a local enumeration of fiber types; most likely you'll be
is just a local enumeration of fiber types; most likely you'll be
using type ``0'' in every port.
using type ``0'' in every port.
@item The transceiver installed uses 1310nm light for tx
@item The transceiver installed uses 1310nm light for tx
and 1490nm light for rx (this is part of the specification of the
and 1490nm light for rx (this is part of the specification of the
transceiver,
but
cannot be auto-detected). Moreover it has 0 constant
transceiver,
and
cannot be auto-detected). Moreover it has 0 constant
delay in both tx and rx, determined by
calibration
.
delay in both tx and rx, determined by
the calibration procedure
.
@item The fiber type being used (type 2 here), when driven
@item The fiber type being used (type 2 here), when driven
with 1310nm and 1490nm wavelengths, features an @i
{
alpha
}
parameter of
with 1310nm and 1490nm wavelengths, features an @i
{
alpha
}
parameter of
0.00026787 (i.e. a ratio of 1.00026787) between the speed of light in
0.00026787 (i.e. a ratio of 1.00026787) between the speed of light in
the two directions. This value depends on both the fiber type and
the two directions. This value depends on both the fiber type and
wavelength, and is determined, again, by
calibration
.
wavelength, and is determined, again, by
the calibration procedure
.
@end itemize
@end itemize
...
@@ -1024,42 +1034,42 @@ opposite one (@t{alpha_1490_1310}) is calculated by software.
...
@@ -1024,42 +1034,42 @@ opposite one (@t{alpha_1490_1310}) is calculated by software.
@subheading SFP name matching
@subheading SFP name matching
SFP matching is based on vendor name (@i
{
vn
}
), part number (@i
{
pn
}
) and vendor
SFP matching is based on
the
vendor name (@i
{
vn
}
), part number (@i
{
pn
}
) and vendor
serial (@i
{
vs
}
). During
matching SFP's value
s are compared with values stored
serial (@i
{
vs
}
). During
the matching, SFP parameter
s are compared with values stored
in @t
{
CONFIG
_
SFPxx
_
PARAMS
}
.
in @t
{
CONFIG
_
SFPxx
_
PARAMS
}
.
The first try is to match all SFP identifiers (@i
{
vn
}
, @i
{
pn
}
and @i
{
vs
}
) with
The first try is to match all SFP identifiers (@i
{
vn
}
, @i
{
pn
}
and @i
{
vs
}
) with
those
stored in @t
{
dot-config
}
. If match is not successful, @i
{
vn
}
and @i
{
pn
}
of
stored in @t
{
dot-config
}
. If
the
match is not successful, @i
{
vn
}
and @i
{
pn
}
of
a SFP are compared only with @t
{
dot-config
}
entries that are without vendor
a
n
SFP are compared only with @t
{
dot-config
}
entries that are without vendor
serial. If
match is still not found SFP's value
s are compared with
serial. If
the match is still not found, SFP parameter
s are compared with
@t
{
dot-config
}
entries, which ha
s
defined only
@t
{
dot-config
}
entries, which ha
ve
defined only
a part number. Such approach prevents matching SFPs to @t
{
dot-config
}
entries
a part number. Such approach prevents matching SFPs to @t
{
dot-config
}
entries
with defined vendor serial.
with defined vendor serial.
Below are shown matching examples:
Below are shown
some
matching examples:
@smallexample
@smallexample
CONFIG
_
SFP00
_
PARAMS="vn=Axcen Photonics,pn=AXGE-3454-0531,vs=AX12390009629,tx=0,rx=0,..."
CONFIG
_
SFP00
_
PARAMS="vn=Axcen Photonics,pn=AXGE-3454-0531,vs=AX12390009629,tx=0,rx=0,..."
@end smallexample
@end smallexample
Above config
may be matched only to one SFP.
CONFIG
_
SFP00
_
PARAMS
may be matched only to one SFP.
@smallexample
@smallexample
CONFIG
_
SFP01
_
PARAMS="vn=Axcen Photonics,pn=AXGE-3454-0531,tx=0,rx=0,wl
_
txrx=1310+1490"
CONFIG
_
SFP01
_
PARAMS="vn=Axcen Photonics,pn=AXGE-3454-0531,tx=0,rx=0,wl
_
txrx=1310+1490"
@end smallexample
@end smallexample
Above config
may be matched only to SFP with vendor name "Axcen Photonics" and
CONFIG
_
SFP01
_
PARAMS
may be matched only to SFP with vendor name "Axcen Photonics" and
part number "AXGE-3454-0531", with exception to these SFPs that were matched to
part number "AXGE-3454-0531", with exception to these SFPs that were matched to
example like above
(with vendor serial defined).
CONFIG
_
SFP00
_
PARAMS
(with vendor serial defined).
@smallexample
@smallexample
CONFIG
_
SFP02
_
PARAMS="pn=AXGE-3454-0531,tx=0,rx=0,wl
_
txrx=1310+1490"
CONFIG
_
SFP02
_
PARAMS="pn=AXGE-3454-0531,tx=0,rx=0,wl
_
txrx=1310+1490"
@end smallexample
@end smallexample
C
onfig above
will be matched to all SFPs with part number "AXGE-3454-0531",
C
ONFIG
_
SFP02
_
PARAMS
will be matched to all SFPs with part number "AXGE-3454-0531",
that were not matched by configs above.
that were not matched by
any of the
configs above.
@subheading Other Deployments
@subheading Other Deployments
The example above matches
the choices we make at CERN, where our
Examples above match
the choices we make at CERN, where our
White Rabbit networks are all run with a single mono-modal fiber
White Rabbit networks are all run with a single mono-modal fiber
and 1310/1490 light.
and 1310/1490
nm
light.
If you are using dual-fiber transceivers, which is acceptable for
If you are using dual-fiber transceivers, which is acceptable for
short links, you use the same wavelength in both direction, over two
short links, you use the same wavelength in both direction
s
, over two
fibers of the same length. In this case you may choose to avoid
fibers of the same length. In this case you may choose to avoid
writing the @t
{
wl
_
txrx
}
parameter in @sc
{
sfp
}
configuration and the
writing the @t
{
wl
_
txrx
}
parameter in @sc
{
sfp
}
configuration and the
@t
{
alpha
_
XX
_
XX
}
parameter in fiber configuration. The missing
@t
{
alpha
_
XX
_
XX
}
parameter in fiber configuration. The missing
...
@@ -1078,19 +1088,15 @@ less than 10ps.
...
@@ -1078,19 +1088,15 @@ less than 10ps.
@subheading Calibration
@subheading Calibration
Calibration of per-port and per-@sc
{
sfp
}
delays is described in the
Calibration of per-port and per-@sc
{
sfp
}
delays as well as alpha is described in the
White Rabbit wiki:
White Rabbit Calibration procedure:
@url
{
http://www.ohwr.org/projects/white-rabbit/wiki/Calibration
}
. The
@url
{
http://www.ohwr.org/projects/white-rabbit/wiki/Calibration
}
.
procedure can measure the total constant delays, but splitting between
the what depends on the port and what depends on the transceiver is
The delays used in the examples come from values listed in the calibration wiki
arbitrary (also, the split between the tx and rx paths is arbitrary).
page, and you should not be surprised by the fact that the
transceiver (SFP) specifies the delays as zero. By performing the
The delays used in this example come from values listed in the above
calibration procedure using this very transceiver type, the whole delay is
web page, and you should not be surprised by the fact that the
assigned to the port. Other transceiver
transceiver specifies the delays as zero. By performing the
calibration procedure using this very transceiver type, the hardware
engineers decided to assign the whole of the delay to the port (any
split of the measured value is equally right). Other transceiver
types can be calibrated to either positive or negative values, to cope
types can be calibrated to either positive or negative values, to cope
with the @i
{
difference
}
between them and the @t
{
AXGE
}
devices.
with the @i
{
difference
}
between them and the @t
{
AXGE
}
devices.
...
@@ -1098,7 +1104,7 @@ with the @i{difference} between them and the @t{AXGE} devices.
...
@@ -1098,7 +1104,7 @@ with the @i{difference} between them and the @t{AXGE} devices.
@node VLANs Configuration
@node VLANs Configuration
@section VLANs Configuration
@section VLANs Configuration
The
VLANs are handled at two levels:
VLANs are handled at two levels:
@itemize
@itemize
@item Per-port configuration of the Endpoint. It allows to:
@item Per-port configuration of the Endpoint. It allows to:
...
@@ -1142,7 +1148,7 @@ VLAN-tag in the received frame.
...
@@ -1142,7 +1148,7 @@ VLAN-tag in the received frame.
priority that are configured in @t
{
pvid
}
and @t
{
pprio
}
priority that are configured in @t
{
pvid
}
and @t
{
pprio
}
respectively
respectively
@item @i
{
priority tag
}
: are admitted, their tag is unchanged, the value
@item @i
{
priority tag
}
: are admitted, their tag is unchanged, the value
of VID provided to the RTU is overridden with the
of VID provided to the RTU is overridden with the
one
configured in @t
{
pvid
}
. If @t
{
pprio
}
is not -1, the
configured in @t
{
pvid
}
. If @t
{
pprio
}
is not -1, the
value of priority provided to RTU is overridden with
value of priority provided to RTU is overridden with
the configured @t
{
pprio
}
the configured @t
{
pprio
}
...
@@ -1183,7 +1189,8 @@ VLAN-tag in the received frame.
...
@@ -1183,7 +1189,8 @@ VLAN-tag in the received frame.
configured in @t
{
pvid
}
. If @t
{
pprio
}
is not -1, the
configured in @t
{
pvid
}
. If @t
{
pprio
}
is not -1, the
value of priority provided to RTU is overridden with
value of priority provided to RTU is overridden with
the configured @t
{
pprio
}
the configured @t
{
pprio
}
NOTE: For version v5.0 providing a VID for this mode
@b
{
Note:
}
For version v5.0 providing a VID for this mode
is not supported in the dot-config
is not supported in the dot-config
@item @i
{
VLAN tag
}
: are admitted; if @t
{
pprio
}
is not -1, the value of
@item @i
{
VLAN tag
}
: are admitted; if @t
{
pprio
}
is not -1, the value of
priority provided to RTU is overridden with
priority provided to RTU is overridden with
...
@@ -1196,7 +1203,7 @@ Modes and their behaviour are summarized in the table below:
...
@@ -1196,7 +1203,7 @@ Modes and their behaviour are summarized in the table below:
@center @image
{
VLAN
_
modes, 14cm,, VLAN
_
modes
}
@center @image
{
VLAN
_
modes, 14cm,, VLAN
_
modes
}
From the
version
5.0, it is possible to configure VLANs in the
From the
firmware v
5.0, it is possible to configure VLANs in the
@t
{
dot-config
}
file (for an example configuration please see
@t
{
dot-config
}
file (for an example configuration please see
@ref
{
Example VLAN configuration by dot-config
}
).
@ref
{
Example VLAN configuration by dot-config
}
).
...
@@ -1204,16 +1211,16 @@ As an alternative it is possible to use @i{wrs_vlans} tool
...
@@ -1204,16 +1211,16 @@ As an alternative it is possible to use @i{wrs_vlans} tool
described in @ref
{
wrs
_
vlans
}
together with a custom config file for @i
{
PPSi
}
.
described in @ref
{
wrs
_
vlans
}
together with a custom config file for @i
{
PPSi
}
.
Another alternative working on pre-v5.0 to set VLANs is to use the web
Another alternative working on pre-v5.0 to set VLANs is to use the web
interface. However, as it is in v5.0 the web-interface is not capable to store
interface. However, as it is in v5.0
,
the web-interface is not capable to store
a VLAN
configuration into a @t
{
dot-config
}
.
VLANs
configuration into a @t
{
dot-config
}
.
To have
a synchronization working with VLANs, please
provide proper VIDs to
To have
synchronization working with VLANs, the preferred way is to
provide proper VIDs to
configuration options like @t
{
CONFIG
_
VLANS
_
PORTXX
_
VID
}
. As an alternative
configuration options like @t
{
CONFIG
_
VLANS
_
PORTXX
_
VID
}
. As an alternative
you can
write a custom @i
{
PPSi
}
configuration file with VLANs specified per-port.
write a custom @i
{
PPSi
}
configuration file with VLANs specified per-port.
You can simply copy the file generated in the WRS filesystem
You can simply copy the file generated in the WRS filesystem
(@i
{
/etc/ppsi.conf
}
) to a central @t
{
tftp
}
/@t
{
http
}
/@t
{
ftp
}
server where
(@i
{
/etc/ppsi.conf
}
) to a central @t
{
tftp
}
/@t
{
http
}
/@t
{
ftp
}
server where
@t
{
dot-config
}
files for your switches are stored and fetched on boot time or
@t
{
dot-config
}
files for your switches are stored and fetched on boot time or
permanently store it in the
switch's flash (for details, please check
permanently store it in the
flash (for details, please check the
configuration options @t
{
CONFIG
_
PTP
_
*
}
in the
configuration options @t
{
CONFIG
_
PTP
_
*
}
in the
@ref
{
Configuration Items that Apply at Run Time
}
).
@ref
{
Configuration Items that Apply at Run Time
}
).
...
@@ -1231,19 +1238,20 @@ For an example configuration please see
...
@@ -1231,19 +1238,20 @@ For an example configuration please see
@node Example VLAN configuration
@node Example VLAN configuration
@subsection Example VLAN configuration
@subsection Example VLAN configuration
This s
ubs
ection describes how to configure VLANs on a switch using the
This section describes how to configure VLANs on a switch using the
@t
{
dot-config
}
and available command line tools.
@t
{
dot-config
}
and available command line tools.
An example configuration of VLANs for ports (@t
{
wri
}
) 1-3 is provided below.
An example configuration of VLANs for ports (@t
{
wri
}
) 1-3 is provided in
The descriptions assume, for simplicity, that switch has only this 3 ports.
@ref
{
Example VLAN configuration by dot-config
}
.
The description assumes, that switch has only these 3 ports.
In this configuration, port 1 is synchronised to an upstream WR device. This
In this configuration, port 1 is synchronised to an upstream WR device. This
device does not need to have any VLAN configuration. Port 1 is in @t
{
ACCESS
}
mode,
device does not need to have any VLAN configuration. Port 1 is in @t
{
ACCESS
}
mode,
thus it tags the ingress Ethernet frames.
A
VLAN-tags with VID 1 and priority
thus it tags the ingress Ethernet frames. VLAN-tags with VID 1 and priority
4
is
added so that frames received at this port belong to VLAN 1. Port 1 also
4
are
added so that frames received at this port belong to VLAN 1. Port 1 also
untags the egress frames. In this configuration,
it is only the port 1 that
untags the egress frames. In this configuration,
only port 1
belongs to VLAN 1 which means that none of the traffic received on port 1 is
belongs to VLAN 1
,
which means that none of the traffic received on port 1 is
forwarded to other ports. The only traffic received
at
port 1 that is not
forwarded to other ports. The only traffic received
on
port 1 that is not
dropped are the PTP messages which are forwarded to the PTP daemon (@i
{
PPSi
}
). Such
dropped are the PTP messages which are forwarded to the PTP daemon (@i
{
PPSi
}
). Such
an arrangement can be useful if the synchronisation is to be propagated through
an arrangement can be useful if the synchronisation is to be propagated through
WR network, i.e. between the upstream and this switch, but the data needs to be
WR network, i.e. between the upstream and this switch, but the data needs to be
...
@@ -1259,7 +1267,7 @@ The traffic from port 3 is forwarded only to port 2. This port is in @t{TRUNK}
...
@@ -1259,7 +1267,7 @@ The traffic from port 3 is forwarded only to port 2. This port is in @t{TRUNK}
mode. It does not untag egress frames which means that the device connected to
mode. It does not untag egress frames which means that the device connected to
it (a switch or a node) must be VLAN-aware. Port 2 accepts only frames that are
it (a switch or a node) must be VLAN-aware. Port 2 accepts only frames that are
already tagged with the VLAN-tag. Out of the frames received at port 2, only
already tagged with the VLAN-tag. Out of the frames received at port 2, only
the
frames
with VID=2 are forwarded, all the other frames are dropped. The
the
se
with VID=2 are forwarded, all the other frames are dropped. The
frames with VID=2 are forwarded to PTP daemon and to port 3.
frames with VID=2 are forwarded to PTP daemon and to port 3.
@c =-------------------------------------------------------------------------
@c =-------------------------------------------------------------------------
...
@@ -1307,7 +1315,7 @@ Clear the current configuration:
...
@@ -1307,7 +1315,7 @@ Clear the current configuration:
# wrs
_
vlans --rvid 0 --del
# wrs
_
vlans --rvid 0 --del
@end smallexample
@end smallexample
Set ports' configuration by using the @t
{
wrs
_
vlans
}
:
Set ports' configuration by using the @t
{
wrs
_
vlans
}
tool
:
@smallexample
@smallexample
# wrs
_
vlans
\
# wrs
_
vlans
\
--port 1 --pmode 0 --pprio 4 --pvid 1 --puntag 1
\
--port 1 --pmode 0 --pprio 4 --pvid 1 --puntag 1
\
...
@@ -1315,7 +1323,7 @@ Set ports' configuration by using the @t{wrs_vlans}:
...
@@ -1315,7 +1323,7 @@ Set ports' configuration by using the @t{wrs_vlans}:
--port 3 --pmode 0 --pprio 7 --pvid 2 --puntag 1
--port 3 --pmode 0 --pprio 7 --pvid 2 --puntag 1
@end smallexample
@end smallexample
Set VID configuration by using
@t
{
wrs
_
vlans
}
:
Set VID configuration by using
the @t
{
wrs
_
vlans
}
tool
:
@smallexample
@smallexample
# wrs
_
vlans
\
# wrs
_
vlans
\
--rvid 1 --rprio 4 --rdrop 0 --rmask 0x00001
\
--rvid 1 --rprio 4 --rdrop 0 --rmask 0x00001
\
...
@@ -1352,21 +1360,21 @@ vlan 2
...
@@ -1352,21 +1360,21 @@ vlan 2
@node Front panel's LEDs
@node Front panel's LEDs
@section Front panel's LEDs
@section Front panel's LEDs
There are two LEDs on
front panel describing switch's
status and two LEDs for
There are two LEDs on
the front panel describing switch
status and two LEDs for
each
switch's port. Each LED can be off, light with green or orange color, or
each
WR port. Each LED can be off, green or orange color, or the
combination of both giving yellow.
combination of both giving yellow.
For more details please refer to following
sub
sections.
For more details please refer to following
the
sections.
@c =-------------------------------------------------------------------------
@c =-------------------------------------------------------------------------
@node Status LEDs
@node Status LEDs
@subsection Status LEDs
@subsection Status LEDs
The status LED is placed together with power indicator LED on the left side of
The status LED is placed together with power indicator LED on the left side of
switch's
front panel. The status LED is the right one.
the
front panel. The status LED is the right one.
During barebox/kernel boot the status LED is off. When @t
{
startup-mb.sh
}
starts
During barebox/kernel boot the status LED is off. When @t
{
startup-mb.sh
}
starts
the LED is set to yellow. If the HAL starts successfully then the LED is set to
the LED is set to yellow. If the HAL starts successfully then the LED is set to
green. If the HAL caught a SIGNAL sent by other process, HAL sets the status
green. If the HAL caught a SIGNAL
(error)
sent by other process, HAL sets the status
LED to orange.
LED to orange.
When the regular reboot is performed status LED is turned off. In case of
When the regular reboot is performed status LED is turned off. In case of
a kernel crash the LED remains unchanged.
a kernel crash the LED remains unchanged.
...
@@ -1375,10 +1383,14 @@ a kernel crash the LED remains unchanged.
...
@@ -1375,10 +1383,14 @@ a kernel crash the LED remains unchanged.
@node Ports' LEDs
@node Ports' LEDs
@subsection Ports' LEDs
@subsection Ports' LEDs
Under each switch's port there are two LEDs. The left LED is on when particular
Under each WR port there are two LEDs. The left LED is on when particular
port is populated with an SFP and the link is up. Its color is dependent on
port is populated with an SFP and the link is up. Its color depends on
the statuses of PTP instances. For slave status the LED is green, for
the role of PTP instances:
master the LED is yellow. For ports with other statuses the left LED is orange.
@itemize
@item @i
{
green
}
: WR slave role
@item @i
{
yellow
}
: WR master role
@item @i
{
orange
}
: all other roles
@end itemize
If there are multiple instances on a particular port the slave state (green)
If there are multiple instances on a particular port the slave state (green)
takes precedence over master (orange). Master takes precedence over other
takes precedence over master (orange). Master takes precedence over other
states (yellow).
states (yellow).
...
@@ -1615,7 +1627,7 @@ The following tools and scripts are provided:
...
@@ -1615,7 +1627,7 @@ The following tools and scripts are provided:
@itemx wmapper
@itemx wmapper
The former reads from a file using @i
{
mmap
}
The former reads from a file using @i
{
mmap
}
(usually you run it on @i
{
/dev/mem
}
) and writes to @i
{
stdout
}
.
(usually you run it on @i
{
/dev/mem
}
) and writes to @i
{
stdout
}
.
The latter read from @i
{
stdin
}
and writes using @i
{
mmap
}
.
The latter read
s
from @i
{
stdin
}
and writes using @i
{
mmap
}
.
They are classic tools distributed in the @i
{
Linux Device Drivers
}
They are classic tools distributed in the @i
{
Linux Device Drivers
}
examples since 1998.
examples since 1998.
...
@@ -1629,10 +1641,10 @@ The following tools and scripts are provided:
...
@@ -1629,10 +1641,10 @@ The following tools and scripts are provided:
A simple monitor of White Rabbit status. It prints to @i
{
stdout
}
A simple monitor of White Rabbit status. It prints to @i
{
stdout
}
using the standard escape sequences for color output. Please check
using the standard escape sequences for color output. Please check
@t
{
wr
_
mon
}
's help (@t
{
--help
}
parameter) for further information.
@t
{
wr
_
mon
}
's help (@t
{
--help
}
parameter) for further information.
This is probably the most important diagnostic tool on the switch.
(This is probably the most important diagnostic tool on the switch.)
@item wrs
_
pps
_
control
@item wrs
_
pps
_
control
A tool to switch the PPS output on and off. Usage ``@t
{
wrs
_
pps
_
control
A tool to switch the PPS output on and off. Usage
:
``@t
{
wrs
_
pps
_
control
on
}
'' switches the PPS output on, and ``@t
{
wrs
_
pps
_
control off
}
''
on
}
'' switches the PPS output on, and ``@t
{
wrs
_
pps
_
control off
}
''
switches the PPS output off. Switching the output on/off is independent
switches the PPS output off. Switching the output on/off is independent
of the PPSi process, but PPSi switches the PPS output back on when a
of the PPSi process, but PPSi switches the PPS output back on when a
...
@@ -1657,17 +1669,17 @@ The following tools and scripts are provided:
...
@@ -1657,17 +1669,17 @@ The following tools and scripts are provided:
are not synced to NTP at boot.
are not synced to NTP at boot.
@item wrs
_
version
@item wrs
_
version
Print information about the
SW
&
HW version of the WRS. Please
Print information about the
software, gateware, hardware version of the WRS.
check the help message.
Please
check the help message.
@item shw
_
ver
@item shw
_
ver
A symbolic link to @t
{
wrs
_
version
}
, to be compatible with
A symbolic link to @t
{
wrs
_
version
}
, to be compatible with
older versions that used this tool name. The name is
older versions that used this tool name. The name is
inconsistent with anything else in the switch, so it
is being
inconsistent with anything else in the switch, so it
was
replaced.
replaced.
@item wrs
_
vlans
@item wrs
_
vlans
The tool allows to configure
and unconfigure the
VLAN settings
The tool allows to configure VLAN settings
for each port and for the RTU daemon. The @t
{
--help
}
option
for each port and for the RTU daemon. The @t
{
--help
}
option
lists all configuration items of the tool. For details please
lists all configuration items of the tool. For details please
refer to the @ref
{
wrs
_
vlans
}
.
refer to the @ref
{
wrs
_
vlans
}
.
...
@@ -1675,7 +1687,7 @@ The following tools and scripts are provided:
...
@@ -1675,7 +1687,7 @@ The following tools and scripts are provided:
@item apply
_
dot-config
@item apply
_
dot-config
The script is used to apply @t
{
dot-config
}
settings to the
The script is used to apply @t
{
dot-config
}
settings to the
current configuration files. It is run at boot time before
current configuration files. It is run at boot time before
any service is started and by web interface to apply changes in
any service is started and by
the
web interface to apply changes in
the local @t
{
dot-config
}
.
the local @t
{
dot-config
}
.
The @t
{
dot-config
}
mechanism is documented in @ref
{
Configuration of the
The @t
{
dot-config
}
mechanism is documented in @ref
{
Configuration of the
Device
}
.
Device
}
.
...
@@ -1699,7 +1711,7 @@ The following tools and scripts are provided:
...
@@ -1699,7 +1711,7 @@ The following tools and scripts are provided:
@item wrs
_
auxclk
@item wrs
_
auxclk
The tool allows to setup the parameters of a clock generated on the @i
{
clk2
}
The tool allows to setup the parameters of a clock generated on the @i
{
clk2
}
SMC.
SMC
output on the front panel
.
@item wrs
_
sfp
_
dump
@item wrs
_
sfp
_
dump
Dump the content of SFPs internal memory. This tool can read SFP info
Dump the content of SFPs internal memory. This tool can read SFP info
...
@@ -1713,7 +1725,7 @@ The following tools and scripts are provided:
...
@@ -1713,7 +1725,7 @@ The following tools and scripts are provided:
be used to fix SFPs reporting i.e. wrong checksum. Use this option with
be used to fix SFPs reporting i.e. wrong checksum. Use this option with
care.
care.
For more details please refer to tool's help.
For more details please refer to t
he t
ool's help.
@item wrs
_
throttling
@item wrs
_
throttling
The tool is used to control Rx bandwidth throttling of the traffic that
The tool is used to control Rx bandwidth throttling of the traffic that
...
@@ -1721,7 +1733,7 @@ The following tools and scripts are provided:
...
@@ -1721,7 +1733,7 @@ The following tools and scripts are provided:
maximum allowed bandwidth in KB/s. Throttling can be enabled to prevent
maximum allowed bandwidth in KB/s. Throttling can be enabled to prevent
Linux using 100
% of the processing power to receive Ethernet frames
Linux using 100
% of the processing power to receive Ethernet frames
coming from WR ports to the CPU. This tool is executed by default at
coming from WR ports to the CPU. This tool is executed by default at
switch's boot with parameters saved in
the dot-config. For more
boot time with parameters from
the dot-config. For more
information, please refer to the
information, please refer to the
@ref
{
Configuration Items that Apply at Run Time
}
.
@ref
{
Configuration Items that Apply at Run Time
}
.
...
@@ -1809,11 +1821,11 @@ The following option flags are supported:
...
@@ -1809,11 +1821,11 @@ The following option flags are supported:
The @i
{
wrs
_
vlans
}
shell tool can be used to setup VLANs in the switch.
The @i
{
wrs
_
vlans
}
shell tool can be used to setup VLANs in the switch.
The configuration can be read from the @t
{
dot-config
}
file pointed by @t
{
-f
}
or
The configuration can be read from the @t
{
dot-config
}
file pointed by @t
{
-f
}
or
@t
{
--file
}
parameter (for @t
{
dot-config
}
config options'
details please check
@t
{
--file
}
parameter (for @t
{
dot-config
}
details please check
the
@ref
{
Configuration Items that Apply at Build Time
}
).
@ref
{
Configuration Items that Apply at Build Time
}
).
Additionally the configuration can be specified using parameters below.
Additionally
,
the configuration can be specified using parameters below.
The details of VLANs configuration are discussed in
the section and subsections
The details of VLANs configuration are discussed in
of the
@ref
{
VLANs Configuration
}
.
@ref
{
VLANs Configuration
}
.
The @i
{
wrs
_
vlans
}
configuration is divided into two parts:
The @i
{
wrs
_
vlans
}
configuration is divided into two parts:
...
@@ -1828,7 +1840,7 @@ The @i{wrs_vlans} configuration is divided into two parts:
...
@@ -1828,7 +1840,7 @@ The @i{wrs_vlans} configuration is divided into two parts:
@item wrs
_
vlans --rvid <vid> [options]
@item wrs
_
vlans --rvid <vid> [options]
Per-VLAN configuration of the Routing Table Unit, used to configure port mask
Per-VLAN configuration of the Routing Table Unit, used to configure port mask
describing which port belong to a given VLAN. RTU uses this information to be
describing which port
s
belong to a given VLAN. RTU uses this information to be
able to forward incoming frames only to ports inside the VLAN.
able to forward incoming frames only to ports inside the VLAN.
@end table
@end table
...
@@ -1861,7 +1873,7 @@ To configure each Endpoint the following options may be used:
...
@@ -1861,7 +1873,7 @@ To configure each Endpoint the following options may be used:
@table @code
@table @code
@item --pmode <0..3>
@item --pmode <0..3>
Sets
q
mode for a port (@t
{
0
}
-- @t
{
ACCESS
}
, @t
{
1
}
-- @t
{
TRUNK
}
,
Sets
VLAN
mode for a port (@t
{
0
}
-- @t
{
ACCESS
}
, @t
{
1
}
-- @t
{
TRUNK
}
,
@t
{
2
}
-- @t
{
DISABLED
}
, @t
{
3
}
-- @t
{
UNQUALIFIED
}
)
@t
{
2
}
-- @t
{
DISABLED
}
, @t
{
3
}
-- @t
{
UNQUALIFIED
}
)
@item --pvid <0..4094>
@item --pvid <0..4094>
...
@@ -1942,7 +1954,7 @@ with these parameters:
...
@@ -1942,7 +1954,7 @@ with these parameters:
@section wrs
_
auxclk
@section wrs
_
auxclk
The @i
{
wrs
_
auxclk
}
shell tool can be used to configure parameters of a clock
The @i
{
wrs
_
auxclk
}
shell tool can be used to configure parameters of a clock
signal generated on the @i
{
clk2
}
SMC connector.
signal generated on the @i
{
clk2
}
SMC connector
on the front panel
.
@b
{
Note:
}
you need to have WRS hardware at least in version 3.4 to have @i
{
clk2
}
@b
{
Note:
}
you need to have WRS hardware at least in version 3.4 to have @i
{
clk2
}
output.
output.
...
@@ -2014,7 +2026,7 @@ There is currently no support for traps.
...
@@ -2014,7 +2026,7 @@ There is currently no support for traps.
This section contain a summary of the @t
{
WR-SWITCH-MIB
}
, for details please
This section contain a summary of the @t
{
WR-SWITCH-MIB
}
, for details please
refer to the document @i
{
White Rabbit Switch: Failures and Diagnostics
}
.
refer to the document @i
{
White Rabbit Switch: Failures and Diagnostics
}
.
Objects from @t
{
96.100.2
}
to @t
{
96.100.5
}
are obsolete, they were used during early
Objects from @t
{
96.100.2
}
to @t
{
96.100.5
}
are obsolete, they were used during early
implementation of
switch's
snmp.
implementation of
the WRS
snmp.
@table @code
@table @code
...
@@ -2026,7 +2038,7 @@ implementation of switch's snmp.
...
@@ -2026,7 +2038,7 @@ implementation of switch's snmp.
@item 96.100.6
@item 96.100.6
@b
{
wrsStatus
}
-- MIB's branch with collective statuses of entire
@b
{
wrsStatus
}
-- MIB's branch with collective statuses of
the
entire
switch.
switch.
@item 96.100.7
@item 96.100.7
...
@@ -2054,9 +2066,7 @@ is an environment variable pointing to this package:
...
@@ -2054,9 +2066,7 @@ is an environment variable pointing to this package:
Using SNMP version
1
instead of
2
c is fine as well, but you won't receive
Using SNMP version
1
instead of
2
c is fine as well, but you won't receive
the
64
-
bit values for slave
/
tracking information.
the
64
-
bit values for slave
/
tracking information.
The output you will get back is something like the following. Clearly
The output you will get, is something like the following:
the software commit in this example is my own development version while writing
this section:
@smallexample
@smallexample
WR
-
SWITCH
-
MIB::wrsScalar.
0
=
INTEGER:
1
WR
-
SWITCH
-
MIB::wrsScalar.
0
=
INTEGER:
1
...
@@ -2108,7 +2118,7 @@ WR-SWITCH-MIB::wrsPstatsHCRXFrames.2 = Counter64: 544
...
@@ -2108,7 +2118,7 @@ WR-SWITCH-MIB::wrsPstatsHCRXFrames.2 = Counter64: 544
@end smallexample
@end smallexample
Another example is to print all objects exported by switch.
Another example is to print all objects exported by
the
switch.
@smallexample
@smallexample
snmpwalk
-
c public
-
v
2
c wrs
-
m all
\
snmpwalk
-
c public
-
v
2
c wrs
-
m all
\
-
M
${
WRS
_
OUTPUT
_
DIR
}
/build/buildroot-2016.02/output/build/netsnmp-5.7.3/mibs/
\
-
M
${
WRS
_
OUTPUT
_
DIR
}
/build/buildroot-2016.02/output/build/netsnmp-5.7.3/mibs/
\
...
@@ -2203,14 +2213,14 @@ characters per line can be limited by switch @t{Cw}, in example was set to 80.
...
@@ -2203,14 +2213,14 @@ characters per line can be limited by switch @t{Cw}, in example was set to 80.
Even if the package is already released and used in production,
Even if the package is already released and used in production,
some details can be
some details can be
suboptimal, while some procedures may be tricky and need more explanation.
suboptimal, while some procedures may be tricky and need more explanation.
We are collecting all those issues in our project pages. Please visit:
We are collecting all those issues in the @i
{
wiki
}
page of th
e
@itemiz
e
project, to avoid frequent updates to this manual to just collect
@item Frequently Asked Questions: @url
{
http://www.ohwr.org/projects/white-rabbit/wiki/FAQswitch
}
those details. So please visit
@item Issues for WR Switch SW project: @url
{
http://www.ohwr.org/projects/wr-switch-sw/issues
}
@url
{
www.ohwr.org/projects/wr-switch-sw/wiki/Bugs
}
and
@item Issues for WR Switch HDL project: @url
{
http://www.ohwr.org/projects/wr-switch-hdl/issues
}
@
url
{
www.ohwr.org/projects/wr-switch-sw/wiki/Troubleshooting
}
@
end itemize
if you have any problem with this package, but feel free to reach us
If you have any problem with this firmware and you don't find help in the above links,
on the mailing list if you don't find help there
.
feel free to reach us on the @i
{
white-rabbit-dev
}
mailing list
.
@c ##########################################################################
@c ##########################################################################
@bye
@bye
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment