xref: /openbmc/linux/Documentation/hwmon/menf21bmc.rst (revision 9a87ffc99ec8eb8d35eed7c4f816d75f5cc9662e)
17ebd8b66SMauro Carvalho ChehabKernel driver menf21bmc_hwmon
27ebd8b66SMauro Carvalho Chehab=============================
37ebd8b66SMauro Carvalho Chehab
47ebd8b66SMauro Carvalho ChehabSupported chips:
57ebd8b66SMauro Carvalho Chehab
67ebd8b66SMauro Carvalho Chehab	* MEN 14F021P00
77ebd8b66SMauro Carvalho Chehab
87ebd8b66SMauro Carvalho Chehab	  Prefix: 'menf21bmc_hwmon'
97ebd8b66SMauro Carvalho Chehab
10*12087a36SRandy Dunlap	  Addresses scanned: -
117ebd8b66SMauro Carvalho Chehab
127ebd8b66SMauro Carvalho ChehabAuthor: Andreas Werner <andreas.werner@men.de>
137ebd8b66SMauro Carvalho Chehab
147ebd8b66SMauro Carvalho ChehabDescription
157ebd8b66SMauro Carvalho Chehab-----------
167ebd8b66SMauro Carvalho Chehab
177ebd8b66SMauro Carvalho ChehabThe menf21bmc is a Board Management Controller (BMC) which provides an I2C
187ebd8b66SMauro Carvalho Chehabinterface to the host to access the features implemented in the BMC.
197ebd8b66SMauro Carvalho Chehab
207ebd8b66SMauro Carvalho ChehabThis driver gives access to the voltage monitoring feature of the main
217ebd8b66SMauro Carvalho Chehabvoltages of the board.
227ebd8b66SMauro Carvalho ChehabThe voltage sensors are connected to the ADC inputs of the BMC which is
237ebd8b66SMauro Carvalho Chehaba PIC16F917 Mikrocontroller.
247ebd8b66SMauro Carvalho Chehab
257ebd8b66SMauro Carvalho ChehabUsage Notes
267ebd8b66SMauro Carvalho Chehab-----------
277ebd8b66SMauro Carvalho Chehab
287ebd8b66SMauro Carvalho ChehabThis driver is part of the MFD driver named "menf21bmc" and does
297ebd8b66SMauro Carvalho Chehabnot auto-detect devices.
307ebd8b66SMauro Carvalho ChehabYou will have to instantiate the MFD driver explicitly.
31ccf988b6SMauro Carvalho ChehabPlease see Documentation/i2c/instantiating-devices.rst for
327ebd8b66SMauro Carvalho Chehabdetails.
337ebd8b66SMauro Carvalho Chehab
347ebd8b66SMauro Carvalho ChehabSysfs entries
357ebd8b66SMauro Carvalho Chehab-------------
367ebd8b66SMauro Carvalho Chehab
377ebd8b66SMauro Carvalho ChehabThe following attributes are supported. All attributes are read only
387ebd8b66SMauro Carvalho ChehabThe Limits are read once by the driver.
397ebd8b66SMauro Carvalho Chehab
407ebd8b66SMauro Carvalho Chehab=============== ==========================
417ebd8b66SMauro Carvalho Chehabin0_input	+3.3V input voltage
427ebd8b66SMauro Carvalho Chehabin1_input	+5.0V input voltage
437ebd8b66SMauro Carvalho Chehabin2_input	+12.0V input voltage
447ebd8b66SMauro Carvalho Chehabin3_input	+5V Standby input voltage
457ebd8b66SMauro Carvalho Chehabin4_input	VBAT (on board battery)
467ebd8b66SMauro Carvalho Chehab
477ebd8b66SMauro Carvalho Chehabin[0-4]_min	Minimum voltage limit
487ebd8b66SMauro Carvalho Chehabin[0-4]_max	Maximum voltage limit
497ebd8b66SMauro Carvalho Chehab
507ebd8b66SMauro Carvalho Chehabin0_label	"MON_3_3V"
517ebd8b66SMauro Carvalho Chehabin1_label	"MON_5V"
527ebd8b66SMauro Carvalho Chehabin2_label	"MON_12V"
537ebd8b66SMauro Carvalho Chehabin3_label	"5V_STANDBY"
547ebd8b66SMauro Carvalho Chehabin4_label	"VBAT"
557ebd8b66SMauro Carvalho Chehab=============== ==========================
56