sonic-buildimage/platform/broadcom/sonic-platform-modules-juniper/qfx5200/utils/README
Ciju Rajan K 8418bd3df3
[Juniper] Updating platform documentation (#5478)
This patch set updates the documentation for
QFX5200 & QFX5210 Juniper switching platforms.

Signed-off-by: Ciju Rajan K <crajank@juniper.net>
2020-10-02 09:06:55 -07:00

153 lines
5.0 KiB
Plaintext
Executable File

Copyright (c) 2020, Juniper Networks, Inc.
All rights reserved.
Front panel LEDs
================
There are 4 system LEDs in the front panel. Master, System, Alarm, & Beacon.
LED controls can be found under /sys/class/leds. The sysfs interface &
colour mappings are as follows:
For master LED: /sys/class/leds/master/brightness
0 => off
1 => green
For system LED: /sys/class/leds/system/brightness
0 => off
1 => green
For alarm LED: /sys/class/leds/alarm/brightness
0 => off
1 => amber
2 => red
For beacon LED: /sys/class/leds/beacon/brightness
0 => off
1 => blue
For any of the above LEDs, max_brightness file can tell the maximum value
accepted.
System FANs
===========
There are 5 fans and each of the fan has 2 fan modules. Overall there are
10 fans in the system. These fans are controlled by ADT7470 driver.
Fan controls can be found in
/sys/bus/i2c/devices/7-002c
/sys/bus/i2c/devices/7-002e
/sys/bus/i2c/devices/7-002f
For example, the complete path to driver control files will be
/sys/bus/i2c/devices/7-002c/hwmon/hwmon12
Fan duty cycle can be controlled through 'pwm1', 'pwm2', 'pwm3', 'pwm4' sysfs files.
For example, these are the absolute paths to the control files
/sys/bus/i2c/devices/7-002c/hwmon/hwmon*/pwm1 7-002c controls 2 fan modules
/sys/bus/i2c/devices/7-002c/hwmon/hwmon*/pwm2
/sys/bus/i2c/devices/7-002c/hwmon/hwmon*/pwm3
/sys/bus/i2c/devices/7-002c/hwmon/hwmon*/pwm4
/sys/bus/i2c/devices/7-002e/hwmon/hwmon*/pwm1 7-002e controls 2 fan modules
/sys/bus/i2c/devices/7-002e/hwmon/hwmon*/pwm2
/sys/bus/i2c/devices/7-002e/hwmon/hwmon*/pwm3
/sys/bus/i2c/devices/7-002e/hwmon/hwmon*/pwm4
/sys/bus/i2c/devices/7-002f/hwmon/hwmon*/pwm1 7-002c controls only 1 fan module
/sys/bus/i2c/devices/7-002f/hwmon/hwmon*/pwm2
For convenience, it will be represented as
/sys/bus/i2c/devices/7-002[c/e/f]/hwmon/hwmon*/pwm[1-4]
Fan speed is given by
/sys/bus/i2c/devices/7-002[c/e/f]/hwmon/hwmon*/fan[1-4]_input
Fan module presence is given by
/sys/devices/pci0000:00/0000:00:1c.0/0000:0f:00.0/refpga-tmc.15/fan[0-4]_present
file. A value of '1' indicate that fan is present & a value of '0' otherwise.
Fan rotation direction is given by
/sys/devices/pci0000:00/0000:00:1c.0/0000:0f:00.0/refpga-tmc.15/fan[0-4]_type
A value of '1' indicate the direction is AFO (Front to back airflow) or Airflow
out. A value of '0' indicate that direction is AFI (Back to front airflow) or
Airflow in.
Temperature sensors
===================
There are 10 temperature sensors. Kernel driver tmp401 is used for
reading temeperature sensors.
The readings are available in
/sys/bus/i2c/devices/5-0048/hwmon/hwmon*/temp1_input
/sys/bus/i2c/devices/5-0049/hwmon/hwmon*/temp1_input
/sys/bus/i2c/devices/5-004a/hwmon/hwmon*/temp1_input
/sys/bus/i2c/devices/5-004b/hwmon/hwmon*/temp1_input
/sys/bus/i2c/devices/6-0048/hwmon/hwmon*/temp1_input
/sys/bus/i2c/devices/6-0049/hwmon/hwmon*/temp1_input
/sys/bus/i2c/devices/6-004a/hwmon/hwmon*/temp1_input
/sys/bus/i2c/devices/6-004b/hwmon/hwmon*/temp1_input
/sys/bus/i2c/devices/7-0048/hwmon/hwmon*/temp1_input
/sys/bus/i2c/devices/7-0049/hwmon/hwmon*/temp1_input
System PSUs
===========
There are two independent PSUs. These are controlled by TMC fpga.
PSU presence is given by jnx-tmc-psu dirver and is available at
/sys/devices/pci0000:00/0000:00:1c.0/0000:0f:00.0/psu-tmc.15/psu*_present
A value of '1' indicate PSU is present and a value of '0' otherwise.
PSU monitoring data is provided by jnx-psu-monitor driver and is available at
/sys/bus/i2c/devices/3-0058
/sys/bus/i2c/devices/4-0058
SFPs
====
There are 32 QSFP+ modules supported in qfx5200 platform. EEPORMs will be
mapped under /sys/bus/i2c/devices/[14-45]-0050/ sysfs directory.
FEC should be turned on for 100G SR4 & PSM4 optics and should
be turned off for 100G LR4 optics. If the FEC mode is not set
as per the optic type the port may not link up or work properly.
In some cases while interoperating between other NOSs & traffic
generators, FEC need to be enabled even for 100G DAC cables.
As an example, see this configuration for FEC for 100G SR4 optics in
/etc/sonic/config_db.json
"Ethernet4": {
"admin_status": "up",
"alias": "Ethernet4",
"fec": "rs",
"index": "1",
"lanes": "65,66,67,68",
"mtu": "9100",
"speed": "100000"
}
Sensor details
==============
LM75 supported sensor modules will be available under 'sensors' command.
Platform reboot
=================
Platform reboot sequences are in place for system reboot. The following
messages are displayed in the console when the system is rebooted:
[ 6053.163363] System restart: qfx5200_cpu_reset
Platform monitoring daemon
==========================
“juniper_qfx5200_monitor.py” is the platform monitoring script.
It implements the qfx5200 EM policy. This script will run as system service
and monitor the temperature sensors in every 20 seconds. Based on the EM
policy thresholds, it controls the fan rpm, manage alarm leds, and
shutdown the box in case of any over heating.