8  *     http://www.apache.org/licenses/LICENSE-2.0
53  * Default configuration file name.  This is used when the system does not
54  * implement the D-Bus compatible interface.
62 const fs::path standardConfigFileDir{"/usr/share/phosphor-regulators"};
68 const fs::path testConfigFileDir{"/etc/phosphor-regulators"};
76     // Create object to find compatible system types for current system.
81     // If no system types found so far, try to load default config file
87     // Obtain D-Bus service name
90     // If system is already powered on, enable monitoring
105     // Verify config file has been loaded and System object is valid  in configure()
108         // Configure the regulator devices in the system  in configure()
109         system->configure(services);  in configure()
114         services.getJournal().logError("Unable to configure regulator devices: "  in configure()
118         // cause hardware damage if default regulator settings are very wrong.  in configure()
122         // Throw InternalFailure to propogate error status to D-Bus client  in configure()
160         // Verify config file has been loaded and System object is valid  in monitor()
163             // Close the regulator devices in the system.  Monitoring is  in monitor()
164             // normally disabled because the system is being powered off.  The  in monitor()
166             // while the system is powered off.  in monitor()
167             system->closeDevices(services);  in monitor()
174     // If we don't already have compatible system types  in compatibleSystemTypesFound()
179             std::format("Compatible system types found: {}", typesStr));  in compatibleSystemTypesFound()
181         // Store compatible system types  in compatibleSystemTypesFound()
184         // Find and load JSON config file based on system types  in compatibleSystemTypesFound()
191     // Verify config file has been loaded and System object is valid  in phaseFaultTimerExpired()
194         // Detect redundant phase faults in regulator devices in the system  in phaseFaultTimerExpired()
195         system->detectPhaseFaults(services);  in phaseFaultTimerExpired()
204     // Verify config file has been loaded and System object is valid  in sensorTimerExpired()
207         // Monitor sensors for the voltage rails in the system  in sensorTimerExpired()
208         system->monitorSensors(services);  in sensorTimerExpired()
228     // Verify config file has been loaded and System object is valid  in clearHardwareData()
231         // Clear any cached hardware data in the System object  in clearHardwareData()
232         system->clearCache();  in clearHardwareData()
234         // Clear error history related to hardware devices in the System object  in clearHardwareData()
235         system->clearErrorHistory();  in clearHardwareData()
244     // Add possible file names based on compatible system types (if any)  in findConfigFile()
247         // Look for file name that is entire system type + ".json"  in findConfigFile()
251         // Look for file name that is last node of system type + ".json"  in findConfigFile()
254         if ((pos != std::string::npos) && ((systemType.size() - pos) > 1))  in findConfigFile()
291         // Get D-Bus property that contains the current power state for  in isSystemPoweredOn()
292         // chassis0, which represents the entire system (all chassis)  in isSystemPoweredOn()
309         // application can start before the power state is published on D-Bus.  in isSystemPoweredOn()
332             // Store config file information in a new System object.  The old  in loadConfigFile()
333             // System object, if any, is automatically deleted.  in loadConfigFile()
334             system =  in loadConfigFile()
335                 std::make_unique<System>(std::move(rules), std::move(chassis));  in loadConfigFile()
342         services.getJournal().logError("Unable to load configuration file");  in loadConfigFile()
352     // If config file not loaded and list of compatible system types is empty  in waitUntilConfigFileLoaded()
355         // Loop until compatible system types found or waited max amount of time  in waitUntilConfigFileLoaded()
361             // Try to find list of compatible system types.  Force finder object  in waitUntilConfigFileLoaded()
362             // to re-find system types on D-Bus because we are not receiving  in waitUntilConfigFileLoaded()
364             compatSysTypesFinder->refind();  in waitUntilConfigFileLoaded()
371             timeWaited = std::chrono::system_clock::now() - start;  in waitUntilConfigFileLoaded()