sysfs-class-fmc

# SPDX-License-Identifier: CC0-1.0
#
# SPDX-FileCopyrightText: 2019 CERN

What:		/sys/class/fmc/
Date:		July 2018
KernelVersion:	4.18
Contact:	Federico Vaga <federico.vaga@cern.ch>
Description:
		The fmc/ class sub-directory belongs to the FMC subsystem and
		provides general FMC information, per-FMC carrier and per-FMC
		mezzanine module.

What:		/sys/class/fmc-carrier-X/
Date:		July 2018
KernelVersion:	4.18
Contact:	Federico Vaga <federico.vaga@cern.ch>
Description:
		The /sys/class/fmc-carrier-0, /sys/class/fmc-carrier-1, etc
		directories describe FMC carriers (FMC carrier 0, 1, etc). They
		contain general FMC carrier information and per FMC slot
		information (each FMC carrier has one or more FMC slots)

What:		/sys/class/fmc-slot-X.Y/
Date:		July 2018
KernelVersion:	4.18
Contact:	Federico Vaga <federico.vaga@cern.ch>
Description:
		The /sys/class/fmc-slot-0.1, /sys/class/fmc-slot-0.2, etc
		directories describe FMC slots (FMC slot 1 on carrier 0,
		2 on carrier 0, etc). They contain general FMC slot
		information.

What:		/sys/class/fmc/fmc-slot-X.Y/fmc_ga
Date:		July 2018
KernelVersion:	4.18
Contact:	Federico Vaga <federico.vaga@cern.ch>
Description:
		The FMC geographical address assigned to the slot as described
		in the standard.

What:		/sys/class/fmc/fmc-slot-X.Y/present
Date:		July 2018
KernelVersion:	4.18
Contact:	Federico Vaga <federico.vaga@cern.ch>
Description:
		Tells if an FMC mezzanine module is plugged, or not, in the
		slot. It returns an integer number representing the presence
		status: 1 if an FMC mezzanine module is present, 0 when the
		slot is empty.

What:		/sys/class/fmc/fmc-slot-X.Y/fru_valid
Date:		July 2018
KernelVersion:	4.18
Contact:	Federico Vaga <federico.vaga@cern.ch>
Description:
		Tells if the FMC mezzanine module EEPROM contains a valid FRU.
		It returns an integer number representing the FRU status:
		1 if an FMC mezzanine module EEPROM has a valid FRU, 0 when the
		FRU is invalid or the FMC slot is empty (present = 0).

What:		/sys/class/fmc/fmc-slot-X.Y/eeprom_type
Date:		July 2018
KernelVersion:	4.18
Contact:	Federico Vaga <federico.vaga@cern.ch>
Description:
		Tells the EEPROM device driver to be used by the FMC framework
		to access the FMC mezzanine module EEPROM on the current slot.
		By standard, and by default, this is "24c02". But since the
		standard is unclear on this point, we must support other
		EEPROM types as well. The user can write here the I2C device
		name of the EEPROM in use.

What:		/sys/class/fmc/fmc-slot-X.Y/fru_eeprom
Date:		July 2018
KernelVersio:	4.18
Contact:	Federico Vaga <federico.vaga@cern.ch>
Description:
		A symbolic link to the EEPROM device driver sysfs instance
		that drives the access the FMC module EEPROM that contains
		the FRU information. This link exists only if the FMC module
		is present and it is possible to load an I2C driver for the
		EEPROM.