blob: 89274dc6621b2c9d0266ef00497de95b4262f72c [file] [log] [blame]
Matt Spinler015e3ad2017-08-01 11:20:47 -05001#pragma once
2
3#include <experimental/filesystem>
4#include <string>
5#include <vector>
6
7namespace witherspoon
8{
9namespace pmbus
10{
11
Brandon Wymanff5f3392017-08-11 17:43:22 -050012namespace fs = std::experimental::filesystem;
13
Brandon Wyman10295542017-08-09 18:20:44 -050014// The file name Linux uses to capture the STATUS_WORD from pmbus.
Matt Spinlere7e432b2017-08-21 15:01:40 -050015constexpr auto STATUS_WORD = "status0";
Brandon Wyman10295542017-08-09 18:20:44 -050016
Brandon Wyman253dc9b2017-08-12 13:45:52 -050017// The file name Linux uses to capture the STATUS_INPUT from pmbus.
18constexpr auto STATUS_INPUT = "status0_input";
Matt Spinlere7e432b2017-08-21 15:01:40 -050019
Brandon Wyman764c7972017-08-22 17:05:36 -050020// Voltage out status.
21// Overvoltage fault or warning, Undervoltage fault or warning, maximum or
22// minimum warning, ....
Matt Spinlere7e432b2017-08-21 15:01:40 -050023// Uses Page substitution
24constexpr auto STATUS_VOUT = "statusP_vout";
25
Matt Spinlerde16d052017-12-13 13:22:14 -060026namespace status_vout
27{
28// Mask of bits that are only warnings
29constexpr auto WARNING_MASK = 0x6A;
30}
31
Brandon Wyman764c7972017-08-22 17:05:36 -050032// Current output status bits.
33constexpr auto STATUS_IOUT = "status0_iout";
34
35// Manufacturing specific status bits
36constexpr auto STATUS_MFR = "status0_mfr";
37
Brandon Wyman12661f12017-08-31 15:28:21 -050038// Reports on the status of any fans installed in position 1 and 2.
39constexpr auto STATUS_FANS_1_2 = "status0_fans12";
40
41// Reports on temperature faults or warnings. Overtemperature fault,
42// overtemperature warning, undertemperature warning, undertemperature fault.
43constexpr auto STATUS_TEMPERATURE = "status0_temp";
44
Matt Spinlere7e432b2017-08-21 15:01:40 -050045namespace status_word
46{
47constexpr auto VOUT_FAULT = 0x8000;
Brandon Wyman764c7972017-08-22 17:05:36 -050048
49// The IBM CFF power supply driver does map this bit to power1_alarm in the
50// hwmon space, but since the other bits that need to be checked do not have
51// a similar mapping, the code will just read STATUS_WORD and use bit masking
52// to see if the INPUT FAULT OR WARNING bit is on.
53constexpr auto INPUT_FAULT_WARN = 0x2000;
54
55// The bit mask representing the POWER_GOOD Negated bit of the STATUS_WORD.
56constexpr auto POWER_GOOD_NEGATED = 0x0800;
57
Brandon Wyman12661f12017-08-31 15:28:21 -050058// The bit mask representing the FAN FAULT or WARNING bit of the STATUS_WORD.
59// Bit 2 of the high byte of STATUS_WORD.
60constexpr auto FAN_FAULT = 0x0400;
61
Brandon Wyman764c7972017-08-22 17:05:36 -050062// The bit mask representing the UNITI_IS_OFF bit of the STATUS_WORD.
63constexpr auto UNIT_IS_OFF = 0x0040;
64
Brandon Wymanab05c072017-08-30 18:26:41 -050065// Bit 5 of the STATUS_BYTE, or lower byte of STATUS_WORD is used to indicate
66// an output overvoltage fault.
67constexpr auto VOUT_OV_FAULT = 0x0020;
68
Brandon Wymanb165c252017-08-25 18:59:54 -050069// The bit mask representing that an output overcurrent fault has occurred.
70constexpr auto IOUT_OC_FAULT = 0x0010;
71
Brandon Wyman764c7972017-08-22 17:05:36 -050072// The IBM CFF power supply driver does map this bit to in1_alarm, however,
73// since a number of the other bits are not mapped that way for STATUS_WORD,
74// this code will just read the entire STATUS_WORD and use bit masking to find
75// out if that fault is on.
76constexpr auto VIN_UV_FAULT = 0x0008;
77
Brandon Wyman875b3632017-09-13 18:46:03 -050078// The bit mask representing the TEMPERATURE FAULT or WARNING bit of the
79// STATUS_WORD. Bit 2 of the low byte (STATUS_BYTE).
80constexpr auto TEMPERATURE_FAULT_WARN = 0x0004;
81
82}
83
84namespace status_temperature
85{
86// Overtemperature Fault
87constexpr auto OT_FAULT = 0x80;
Matt Spinlere7e432b2017-08-21 15:01:40 -050088}
89
Matt Spinler015e3ad2017-08-01 11:20:47 -050090/**
Matt Spinler4dc46782018-01-04 14:29:16 -060091 * Where the access should be done
Matt Spinler57868bc2017-08-03 10:07:41 -050092 */
93enum class Type
94{
Matt Spinler4dc46782018-01-04 14:29:16 -060095 Base, // base device directory
96 Hwmon, // hwmon directory
97 Debug, // pmbus debug directory
98 DeviceDebug, // device debug directory
99 HwmonDeviceDebug // hwmon device debug directory
Matt Spinler57868bc2017-08-03 10:07:41 -0500100};
101
102/**
Matt Spinler015e3ad2017-08-01 11:20:47 -0500103 * @class PMBus
104 *
105 * This class is an interface to communicating with PMBus devices
106 * by reading and writing sysfs files.
Matt Spinler57868bc2017-08-03 10:07:41 -0500107 *
108 * Based on the Type parameter, the accesses can either be done
109 * in the base device directory (the one passed into the constructor),
110 * or in the hwmon directory for the device.
Matt Spinler015e3ad2017-08-01 11:20:47 -0500111 */
112class PMBus
113{
114 public:
115
116 PMBus() = delete;
117 ~PMBus() = default;
118 PMBus(const PMBus&) = default;
119 PMBus& operator=(const PMBus&) = default;
120 PMBus(PMBus&&) = default;
121 PMBus& operator=(PMBus&&) = default;
122
123 /**
124 * Constructor
125 *
126 * @param[in] path - path to the sysfs directory
127 */
128 PMBus(const std::string& path) :
129 basePath(path)
130 {
Brandon Wymanff5f3392017-08-11 17:43:22 -0500131 findHwmonDir();
Matt Spinler015e3ad2017-08-01 11:20:47 -0500132 }
133
134 /**
Matt Spinler8f0d9532017-08-21 11:22:37 -0500135 * Constructor
136 *
137 * This version is required when DeviceDebug
138 * access will be used.
139 *
140 * @param[in] path - path to the sysfs directory
141 * @param[in] driverName - the device driver name
142 * @param[in] instance - chip instance number
143 */
144 PMBus(const std::string& path,
145 const std::string& driverName,
146 size_t instance) :
147 basePath(path),
148 driverName(driverName),
149 instance(instance)
150 {
151 findHwmonDir();
152 }
153
154 /**
Matt Spinler015e3ad2017-08-01 11:20:47 -0500155 * Reads a file in sysfs that represents a single bit,
156 * therefore doing a PMBus read.
157 *
158 * @param[in] name - path concatenated to
159 * basePath to read
Matt Spinler8f0d9532017-08-21 11:22:37 -0500160 * @param[in] type - Path type
Matt Spinler015e3ad2017-08-01 11:20:47 -0500161 *
162 * @return bool - false if result was 0, else true
163 */
Matt Spinler57868bc2017-08-03 10:07:41 -0500164 bool readBit(const std::string& name, Type type);
Matt Spinler015e3ad2017-08-01 11:20:47 -0500165
166 /**
167 * Reads a file in sysfs that represents a single bit,
168 * where the page number passed in is substituted
169 * into the name in place of the 'P' character in it.
170 *
171 * @param[in] name - path concatenated to
172 * basePath to read
173 * @param[in] page - page number
Matt Spinler8f0d9532017-08-21 11:22:37 -0500174 * @param[in] type - Path type
Matt Spinler015e3ad2017-08-01 11:20:47 -0500175 *
176 * @return bool - false if result was 0, else true
177 */
178 bool readBitInPage(const std::string& name,
Matt Spinler57868bc2017-08-03 10:07:41 -0500179 size_t page,
180 Type type);
Brandon Wymanf855e822017-08-08 18:04:47 -0500181 /**
Brandon Wyman3b7b38b2017-09-25 16:43:45 -0500182 * Checks if the file for the given name and type exists.
183 *
184 * @param[in] name - path concatenated to basePath to read
185 * @param[in] type - Path type
186 *
187 * @return bool - True if file exists, false if it does not.
188 */
189 bool exists(const std::string& name, Type type);
190
191 /**
Brandon Wymanf855e822017-08-08 18:04:47 -0500192 * Read byte(s) from file in sysfs.
193 *
194 * @param[in] name - path concatenated to basePath to read
Matt Spinler8f0d9532017-08-21 11:22:37 -0500195 * @param[in] type - Path type
Brandon Wymanf855e822017-08-08 18:04:47 -0500196 *
197 * @return uint64_t - Up to 8 bytes of data read from file.
198 */
199 uint64_t read(const std::string& name, Type type);
Matt Spinler015e3ad2017-08-01 11:20:47 -0500200
201 /**
202 * Writes an integer value to the file, therefore doing
203 * a PMBus write.
204 *
205 * @param[in] name - path concatenated to
206 * basePath to write
207 * @param[in] value - the value to write
Matt Spinler8f0d9532017-08-21 11:22:37 -0500208 * @param[in] type - Path type
Matt Spinler015e3ad2017-08-01 11:20:47 -0500209 */
Matt Spinler57868bc2017-08-03 10:07:41 -0500210 void write(const std::string& name, int value, Type type);
Matt Spinler015e3ad2017-08-01 11:20:47 -0500211
212 /**
213 * Returns the sysfs base path of this device
214 */
215 inline const auto& path() const
216 {
217 return basePath;
218 }
219
220 /**
221 * Replaces the 'P' in the string passed in with
222 * the page number passed in.
223 *
224 * For example:
225 * insertPageNum("inP_enable", 42)
226 * returns "in42_enable"
227 *
228 * @param[in] templateName - the name string, with a 'P' in it
229 * @param[in] page - the page number to insert where the P was
230 *
231 * @return string - the new string with the page number in it
232 */
233 static std::string insertPageNum(const std::string& templateName,
234 size_t page);
235
Matt Spinler57868bc2017-08-03 10:07:41 -0500236 /**
237 * Finds the path relative to basePath to the hwmon directory
238 * for the device and stores it in hwmonRelPath.
239 */
Brandon Wyman764c7972017-08-22 17:05:36 -0500240 void findHwmonDir();
Brandon Wymanff5f3392017-08-11 17:43:22 -0500241
242 /**
243 * Returns the path to use for the passed in type.
244 *
Matt Spinler8f0d9532017-08-21 11:22:37 -0500245 * @param[in] type - Path type
Brandon Wymanff5f3392017-08-11 17:43:22 -0500246 *
Matt Spinler8f0d9532017-08-21 11:22:37 -0500247 * @return fs::path - the full path
Brandon Wymanff5f3392017-08-11 17:43:22 -0500248 */
Brandon Wyman764c7972017-08-22 17:05:36 -0500249 fs::path getPath(Type type);
Matt Spinler57868bc2017-08-03 10:07:41 -0500250
Matt Spinler015e3ad2017-08-01 11:20:47 -0500251 private:
252
253 /**
Matt Spinlerba053482018-01-04 14:26:05 -0600254 * Returns the device name
255 *
256 * This is found in the 'name' file in basePath.
257 *
258 * @return string - the device name
259 */
260 std::string getDeviceName();
261
262 /**
Matt Spinler015e3ad2017-08-01 11:20:47 -0500263 * The sysfs device path
264 */
Brandon Wymanff5f3392017-08-11 17:43:22 -0500265 fs::path basePath;
Matt Spinler015e3ad2017-08-01 11:20:47 -0500266
Matt Spinler57868bc2017-08-03 10:07:41 -0500267 /**
Brandon Wymanff5f3392017-08-11 17:43:22 -0500268 * The directory name under the basePath hwmon directory
Matt Spinler57868bc2017-08-03 10:07:41 -0500269 */
Brandon Wymanff5f3392017-08-11 17:43:22 -0500270 fs::path hwmonDir;
271
272 /**
Matt Spinler8f0d9532017-08-21 11:22:37 -0500273 * The device driver name. Used for finding the device
274 * debug directory. Not required if that directory
275 * isn't used.
276 */
277 std::string driverName;
278
279 /**
280 * The device instance number.
281 *
282 * Used in conjuction with the driver name for finding
283 * the debug directory. Not required if that directory
284 * isn't used.
285 */
286 size_t instance = 0;
287
288 /**
Brandon Wymanff5f3392017-08-11 17:43:22 -0500289 * The pmbus debug path with status files
290 */
Matt Spinler8f0d9532017-08-21 11:22:37 -0500291 const fs::path debugPath = "/sys/kernel/debug/";
Matt Spinler57868bc2017-08-03 10:07:41 -0500292
Matt Spinler015e3ad2017-08-01 11:20:47 -0500293};
294
295}
296}