xref: /openbmc/bmcweb/redfish-core/lib/systems.hpp (revision a14c9113)
1 /*
2 Copyright (c) 2018 Intel Corporation
3 
4 Licensed under the Apache License, Version 2.0 (the "License");
5 you may not use this file except in compliance with the License.
6 You may obtain a copy of the License at
7 
8       http://www.apache.org/licenses/LICENSE-2.0
9 
10 Unless required by applicable law or agreed to in writing, software
11 distributed under the License is distributed on an "AS IS" BASIS,
12 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 See the License for the specific language governing permissions and
14 limitations under the License.
15 */
16 #pragma once
17 
18 #include "bmcweb_config.h"
19 
20 #include "app.hpp"
21 #include "dbus_singleton.hpp"
22 #include "dbus_utility.hpp"
23 #include "generated/enums/action_info.hpp"
24 #include "generated/enums/computer_system.hpp"
25 #include "generated/enums/open_bmc_computer_system.hpp"
26 #include "generated/enums/resource.hpp"
27 #include "hypervisor_system.hpp"
28 #include "led.hpp"
29 #include "query.hpp"
30 #include "redfish_util.hpp"
31 #include "registries/privilege_registry.hpp"
32 #include "utils/dbus_utils.hpp"
33 #include "utils/json_utils.hpp"
34 #include "utils/pcie_util.hpp"
35 #include "utils/sw_utils.hpp"
36 #include "utils/time_utils.hpp"
37 
38 #include <boost/asio/error.hpp>
39 #include <boost/container/flat_map.hpp>
40 #include <boost/system/error_code.hpp>
41 #include <boost/system/linux_error.hpp>
42 #include <boost/url/format.hpp>
43 #include <sdbusplus/asio/property.hpp>
44 #include <sdbusplus/message.hpp>
45 #include <sdbusplus/unpack_properties.hpp>
46 
47 #include <array>
48 #include <memory>
49 #include <string>
50 #include <string_view>
51 #include <utility>
52 #include <variant>
53 #include <vector>
54 
55 namespace redfish
56 {
57 
58 const static std::array<std::pair<std::string_view, std::string_view>, 2>
59     protocolToDBusForSystems{
60         {{"SSH", "obmc-console-ssh"}, {"IPMI", "phosphor-ipmi-net"}}};
61 
62 /**
63  * @brief Updates the Functional State of DIMMs
64  *
65  * @param[in] asyncResp Shared pointer for completing asynchronous calls
66  * @param[in] dimmState Dimm's Functional state, true/false
67  *
68  * @return None.
69  */
70 inline void updateDimmProperties(
71     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp, bool isDimmFunctional)
72 {
73     BMCWEB_LOG_DEBUG("Dimm Functional: {}", isDimmFunctional);
74 
75     // Set it as Enabled if at least one DIMM is functional
76     // Update STATE only if previous State was DISABLED and current Dimm is
77     // ENABLED.
78     const nlohmann::json& prevMemSummary =
79         asyncResp->res.jsonValue["MemorySummary"]["Status"]["State"];
80     if (prevMemSummary == "Disabled")
81     {
82         if (isDimmFunctional)
83         {
84             asyncResp->res.jsonValue["MemorySummary"]["Status"]["State"] =
85                 "Enabled";
86         }
87     }
88 }
89 
90 /*
91  * @brief Update "ProcessorSummary" "Status" "State" based on
92  *        CPU Functional State
93  *
94  * @param[in] asyncResp Shared pointer for completing asynchronous calls
95  * @param[in] cpuFunctionalState is CPU functional true/false
96  *
97  * @return None.
98  */
99 inline void modifyCpuFunctionalState(
100     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp, bool isCpuFunctional)
101 {
102     BMCWEB_LOG_DEBUG("Cpu Functional: {}", isCpuFunctional);
103 
104     const nlohmann::json& prevProcState =
105         asyncResp->res.jsonValue["ProcessorSummary"]["Status"]["State"];
106 
107     // Set it as Enabled if at least one CPU is functional
108     // Update STATE only if previous State was Non_Functional and current CPU is
109     // Functional.
110     if (prevProcState == "Disabled")
111     {
112         if (isCpuFunctional)
113         {
114             asyncResp->res.jsonValue["ProcessorSummary"]["Status"]["State"] =
115                 "Enabled";
116         }
117     }
118 }
119 
120 /*
121  * @brief Update "ProcessorSummary" "Count" based on Cpu PresenceState
122  *
123  * @param[in] asyncResp Shared pointer for completing asynchronous calls
124  * @param[in] cpuPresenceState CPU present or not
125  *
126  * @return None.
127  */
128 inline void modifyCpuPresenceState(
129     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp, bool isCpuPresent)
130 {
131     BMCWEB_LOG_DEBUG("Cpu Present: {}", isCpuPresent);
132 
133     if (isCpuPresent)
134     {
135         nlohmann::json& procCount =
136             asyncResp->res.jsonValue["ProcessorSummary"]["Count"];
137         auto* procCountPtr =
138             procCount.get_ptr<nlohmann::json::number_integer_t*>();
139         if (procCountPtr != nullptr)
140         {
141             // shouldn't be possible to be nullptr
142             *procCountPtr += 1;
143         }
144     }
145 }
146 
147 inline void getProcessorProperties(
148     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
149     const std::vector<std::pair<std::string, dbus::utility::DbusVariantType>>&
150         properties)
151 {
152     BMCWEB_LOG_DEBUG("Got {} Cpu properties.", properties.size());
153 
154     // TODO: Get Model
155 
156     const uint16_t* coreCount = nullptr;
157 
158     const bool success = sdbusplus::unpackPropertiesNoThrow(
159         dbus_utils::UnpackErrorPrinter(), properties, "CoreCount", coreCount);
160 
161     if (!success)
162     {
163         messages::internalError(asyncResp->res);
164         return;
165     }
166 
167     if (coreCount != nullptr)
168     {
169         nlohmann::json& coreCountJson =
170             asyncResp->res.jsonValue["ProcessorSummary"]["CoreCount"];
171         uint64_t* coreCountJsonPtr = coreCountJson.get_ptr<uint64_t*>();
172 
173         if (coreCountJsonPtr == nullptr)
174         {
175             coreCountJson = *coreCount;
176         }
177         else
178         {
179             *coreCountJsonPtr += *coreCount;
180         }
181     }
182 }
183 
184 /*
185  * @brief Get ProcessorSummary fields
186  *
187  * @param[in] asyncResp Shared pointer for completing asynchronous calls
188  * @param[in] service dbus service for Cpu Information
189  * @param[in] path dbus path for Cpu
190  *
191  * @return None.
192  */
193 inline void
194     getProcessorSummary(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
195                         const std::string& service, const std::string& path)
196 {
197     auto getCpuPresenceState = [asyncResp](const boost::system::error_code& ec3,
198                                            const bool cpuPresenceCheck) {
199         if (ec3)
200         {
201             BMCWEB_LOG_ERROR("DBUS response error {}", ec3);
202             return;
203         }
204         modifyCpuPresenceState(asyncResp, cpuPresenceCheck);
205     };
206 
207     // Get the Presence of CPU
208     sdbusplus::asio::getProperty<bool>(
209         *crow::connections::systemBus, service, path,
210         "xyz.openbmc_project.Inventory.Item", "Present",
211         std::move(getCpuPresenceState));
212 
213     sdbusplus::asio::getAllProperties(
214         *crow::connections::systemBus, service, path,
215         "xyz.openbmc_project.Inventory.Item.Cpu",
216         [asyncResp, service,
217          path](const boost::system::error_code& ec2,
218                const dbus::utility::DBusPropertiesMap& properties) {
219             if (ec2)
220             {
221                 BMCWEB_LOG_ERROR("DBUS response error {}", ec2);
222                 messages::internalError(asyncResp->res);
223                 return;
224             }
225             getProcessorProperties(asyncResp, properties);
226         });
227 }
228 
229 /*
230  * @brief processMemoryProperties fields
231  *
232  * @param[in] asyncResp Shared pointer for completing asynchronous calls
233  * @param[in] DBUS properties for memory
234  *
235  * @return None.
236  */
237 inline void
238     processMemoryProperties(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
239                             const dbus::utility::DBusPropertiesMap& properties)
240 {
241     BMCWEB_LOG_DEBUG("Got {} Dimm properties.", properties.size());
242 
243     if (properties.empty())
244     {
245         return;
246     }
247 
248     const size_t* memorySizeInKB = nullptr;
249 
250     const bool success = sdbusplus::unpackPropertiesNoThrow(
251         dbus_utils::UnpackErrorPrinter(), properties, "MemorySizeInKB",
252         memorySizeInKB);
253 
254     if (!success)
255     {
256         messages::internalError(asyncResp->res);
257         return;
258     }
259 
260     if (memorySizeInKB != nullptr)
261     {
262         nlohmann::json& totalMemory =
263             asyncResp->res.jsonValue["MemorySummary"]["TotalSystemMemoryGiB"];
264         const double* preValue = totalMemory.get_ptr<const double*>();
265         if (preValue == nullptr)
266         {
267             asyncResp->res.jsonValue["MemorySummary"]["TotalSystemMemoryGiB"] =
268                 static_cast<double>(*memorySizeInKB) / (1024 * 1024);
269         }
270         else
271         {
272             asyncResp->res.jsonValue["MemorySummary"]["TotalSystemMemoryGiB"] =
273                 static_cast<double>(*memorySizeInKB) / (1024 * 1024) +
274                 *preValue;
275         }
276     }
277 }
278 
279 /*
280  * @brief Get getMemorySummary fields
281  *
282  * @param[in] asyncResp Shared pointer for completing asynchronous calls
283  * @param[in] service dbus service for memory Information
284  * @param[in] path dbus path for memory
285  *
286  * @return None.
287  */
288 inline void
289     getMemorySummary(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
290                      const std::string& service, const std::string& path)
291 {
292     sdbusplus::asio::getAllProperties(
293         *crow::connections::systemBus, service, path,
294         "xyz.openbmc_project.Inventory.Item.Dimm",
295         [asyncResp, service,
296          path](const boost::system::error_code& ec2,
297                const dbus::utility::DBusPropertiesMap& properties) {
298             if (ec2)
299             {
300                 BMCWEB_LOG_ERROR("DBUS response error {}", ec2);
301                 messages::internalError(asyncResp->res);
302                 return;
303             }
304             processMemoryProperties(asyncResp, properties);
305         });
306 }
307 
308 inline void afterGetUUID(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
309                          const boost::system::error_code& ec,
310                          const dbus::utility::DBusPropertiesMap& properties)
311 {
312     if (ec)
313     {
314         BMCWEB_LOG_ERROR("DBUS response error {}", ec);
315         messages::internalError(asyncResp->res);
316         return;
317     }
318     BMCWEB_LOG_DEBUG("Got {} UUID properties.", properties.size());
319 
320     const std::string* uUID = nullptr;
321 
322     const bool success = sdbusplus::unpackPropertiesNoThrow(
323         dbus_utils::UnpackErrorPrinter(), properties, "UUID", uUID);
324 
325     if (!success)
326     {
327         messages::internalError(asyncResp->res);
328         return;
329     }
330 
331     if (uUID != nullptr)
332     {
333         std::string valueStr = *uUID;
334         if (valueStr.size() == 32)
335         {
336             valueStr.insert(8, 1, '-');
337             valueStr.insert(13, 1, '-');
338             valueStr.insert(18, 1, '-');
339             valueStr.insert(23, 1, '-');
340         }
341         BMCWEB_LOG_DEBUG("UUID = {}", valueStr);
342         asyncResp->res.jsonValue["UUID"] = valueStr;
343     }
344 }
345 
346 inline void
347     afterGetInventory(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
348                       const boost::system::error_code& ec,
349                       const dbus::utility::DBusPropertiesMap& propertiesList)
350 {
351     if (ec)
352     {
353         // doesn't have to include this
354         // interface
355         return;
356     }
357     BMCWEB_LOG_DEBUG("Got {} properties for system", propertiesList.size());
358 
359     const std::string* partNumber = nullptr;
360     const std::string* serialNumber = nullptr;
361     const std::string* manufacturer = nullptr;
362     const std::string* model = nullptr;
363     const std::string* subModel = nullptr;
364 
365     const bool success = sdbusplus::unpackPropertiesNoThrow(
366         dbus_utils::UnpackErrorPrinter(), propertiesList, "PartNumber",
367         partNumber, "SerialNumber", serialNumber, "Manufacturer", manufacturer,
368         "Model", model, "SubModel", subModel);
369 
370     if (!success)
371     {
372         messages::internalError(asyncResp->res);
373         return;
374     }
375 
376     if (partNumber != nullptr)
377     {
378         asyncResp->res.jsonValue["PartNumber"] = *partNumber;
379     }
380 
381     if (serialNumber != nullptr)
382     {
383         asyncResp->res.jsonValue["SerialNumber"] = *serialNumber;
384     }
385 
386     if (manufacturer != nullptr)
387     {
388         asyncResp->res.jsonValue["Manufacturer"] = *manufacturer;
389     }
390 
391     if (model != nullptr)
392     {
393         asyncResp->res.jsonValue["Model"] = *model;
394     }
395 
396     if (subModel != nullptr)
397     {
398         asyncResp->res.jsonValue["SubModel"] = *subModel;
399     }
400 
401     // Grab the bios version
402     sw_util::populateSoftwareInformation(asyncResp, sw_util::biosPurpose,
403                                          "BiosVersion", false);
404 }
405 
406 inline void afterGetAssetTag(
407     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
408     const boost::system::error_code& ec, const std::string& value)
409 {
410     if (ec)
411     {
412         // doesn't have to include this
413         // interface
414         return;
415     }
416 
417     asyncResp->res.jsonValue["AssetTag"] = value;
418 }
419 
420 inline void afterSystemGetSubTree(
421     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
422     const boost::system::error_code& ec,
423     const dbus::utility::MapperGetSubTreeResponse& subtree)
424 {
425     if (ec)
426     {
427         BMCWEB_LOG_ERROR("DBUS response error {}", ec);
428         messages::internalError(asyncResp->res);
429         return;
430     }
431     // Iterate over all retrieved ObjectPaths.
432     for (const std::pair<
433              std::string,
434              std::vector<std::pair<std::string, std::vector<std::string>>>>&
435              object : subtree)
436     {
437         const std::string& path = object.first;
438         BMCWEB_LOG_DEBUG("Got path: {}", path);
439         const std::vector<std::pair<std::string, std::vector<std::string>>>&
440             connectionNames = object.second;
441         if (connectionNames.empty())
442         {
443             continue;
444         }
445 
446         // This is not system, so check if it's cpu, dimm, UUID or
447         // BiosVer
448         for (const auto& connection : connectionNames)
449         {
450             for (const auto& interfaceName : connection.second)
451             {
452                 if (interfaceName == "xyz.openbmc_project.Inventory.Item.Dimm")
453                 {
454                     BMCWEB_LOG_DEBUG("Found Dimm, now get its properties.");
455 
456                     getMemorySummary(asyncResp, connection.first, path);
457                 }
458                 else if (interfaceName ==
459                          "xyz.openbmc_project.Inventory.Item.Cpu")
460                 {
461                     BMCWEB_LOG_DEBUG("Found Cpu, now get its properties.");
462 
463                     getProcessorSummary(asyncResp, connection.first, path);
464                 }
465                 else if (interfaceName == "xyz.openbmc_project.Common.UUID")
466                 {
467                     BMCWEB_LOG_DEBUG("Found UUID, now get its properties.");
468 
469                     sdbusplus::asio::getAllProperties(
470                         *crow::connections::systemBus, connection.first, path,
471                         "xyz.openbmc_project.Common.UUID",
472                         [asyncResp](const boost::system::error_code& ec3,
473                                     const dbus::utility::DBusPropertiesMap&
474                                         properties) {
475                             afterGetUUID(asyncResp, ec3, properties);
476                         });
477                 }
478                 else if (interfaceName ==
479                          "xyz.openbmc_project.Inventory.Item.System")
480                 {
481                     sdbusplus::asio::getAllProperties(
482                         *crow::connections::systemBus, connection.first, path,
483                         "xyz.openbmc_project.Inventory.Decorator.Asset",
484                         [asyncResp](const boost::system::error_code& ec3,
485                                     const dbus::utility::DBusPropertiesMap&
486                                         properties) {
487                             afterGetInventory(asyncResp, ec3, properties);
488                         });
489 
490                     sdbusplus::asio::getProperty<std::string>(
491                         *crow::connections::systemBus, connection.first, path,
492                         "xyz.openbmc_project.Inventory.Decorator."
493                         "AssetTag",
494                         "AssetTag",
495                         std::bind_front(afterGetAssetTag, asyncResp));
496                 }
497             }
498         }
499     }
500 }
501 
502 /*
503  * @brief Retrieves computer system properties over dbus
504  *
505  * @param[in] asyncResp Shared pointer for completing asynchronous calls
506  *
507  * @return None.
508  */
509 inline void
510     getComputerSystem(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
511 {
512     BMCWEB_LOG_DEBUG("Get available system components.");
513     constexpr std::array<std::string_view, 5> interfaces = {
514         "xyz.openbmc_project.Inventory.Decorator.Asset",
515         "xyz.openbmc_project.Inventory.Item.Cpu",
516         "xyz.openbmc_project.Inventory.Item.Dimm",
517         "xyz.openbmc_project.Inventory.Item.System",
518         "xyz.openbmc_project.Common.UUID",
519     };
520     dbus::utility::getSubTree(
521         "/xyz/openbmc_project/inventory", 0, interfaces,
522         std::bind_front(afterSystemGetSubTree, asyncResp));
523 }
524 
525 /**
526  * @brief Retrieves host state properties over dbus
527  *
528  * @param[in] asyncResp     Shared pointer for completing asynchronous calls.
529  *
530  * @return None.
531  */
532 inline void getHostState(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
533 {
534     BMCWEB_LOG_DEBUG("Get host information.");
535     sdbusplus::asio::getProperty<std::string>(
536         *crow::connections::systemBus, "xyz.openbmc_project.State.Host",
537         "/xyz/openbmc_project/state/host0", "xyz.openbmc_project.State.Host",
538         "CurrentHostState",
539         [asyncResp](const boost::system::error_code& ec,
540                     const std::string& hostState) {
541             if (ec)
542             {
543                 if (ec == boost::system::errc::host_unreachable)
544                 {
545                     // Service not available, no error, just don't return
546                     // host state info
547                     BMCWEB_LOG_DEBUG("Service not available {}", ec);
548                     return;
549                 }
550                 BMCWEB_LOG_ERROR("DBUS response error {}", ec);
551                 messages::internalError(asyncResp->res);
552                 return;
553             }
554 
555             BMCWEB_LOG_DEBUG("Host state: {}", hostState);
556             // Verify Host State
557             if (hostState == "xyz.openbmc_project.State.Host.HostState.Running")
558             {
559                 asyncResp->res.jsonValue["PowerState"] =
560                     resource::PowerState::On;
561                 asyncResp->res.jsonValue["Status"]["State"] =
562                     resource::State::Enabled;
563             }
564             else if (hostState ==
565                      "xyz.openbmc_project.State.Host.HostState.Quiesced")
566             {
567                 asyncResp->res.jsonValue["PowerState"] =
568                     resource::PowerState::On;
569                 asyncResp->res.jsonValue["Status"]["State"] =
570                     resource::State::Quiesced;
571             }
572             else if (hostState ==
573                      "xyz.openbmc_project.State.Host.HostState.DiagnosticMode")
574             {
575                 asyncResp->res.jsonValue["PowerState"] =
576                     resource::PowerState::On;
577                 asyncResp->res.jsonValue["Status"]["State"] =
578                     resource::State::InTest;
579             }
580             else if (
581                 hostState ==
582                 "xyz.openbmc_project.State.Host.HostState.TransitioningToRunning")
583             {
584                 asyncResp->res.jsonValue["PowerState"] =
585                     resource::PowerState::PoweringOn;
586                 asyncResp->res.jsonValue["Status"]["State"] =
587                     resource::State::Starting;
588             }
589             else if (
590                 hostState ==
591                 "xyz.openbmc_project.State.Host.HostState.TransitioningToOff")
592             {
593                 asyncResp->res.jsonValue["PowerState"] =
594                     resource::PowerState::PoweringOff;
595                 asyncResp->res.jsonValue["Status"]["State"] =
596                     resource::State::Disabled;
597             }
598             else
599             {
600                 asyncResp->res.jsonValue["PowerState"] =
601                     resource::PowerState::Off;
602                 asyncResp->res.jsonValue["Status"]["State"] =
603                     resource::State::Disabled;
604             }
605         });
606 }
607 
608 /**
609  * @brief Translates boot source DBUS property value to redfish.
610  *
611  * @param[in] dbusSource    The boot source in DBUS speak.
612  *
613  * @return Returns as a string, the boot source in Redfish terms. If translation
614  * cannot be done, returns an empty string.
615  */
616 inline std::string dbusToRfBootSource(const std::string& dbusSource)
617 {
618     if (dbusSource == "xyz.openbmc_project.Control.Boot.Source.Sources.Default")
619     {
620         return "None";
621     }
622     if (dbusSource == "xyz.openbmc_project.Control.Boot.Source.Sources.Disk")
623     {
624         return "Hdd";
625     }
626     if (dbusSource ==
627         "xyz.openbmc_project.Control.Boot.Source.Sources.ExternalMedia")
628     {
629         return "Cd";
630     }
631     if (dbusSource == "xyz.openbmc_project.Control.Boot.Source.Sources.Network")
632     {
633         return "Pxe";
634     }
635     if (dbusSource ==
636         "xyz.openbmc_project.Control.Boot.Source.Sources.RemovableMedia")
637     {
638         return "Usb";
639     }
640     return "";
641 }
642 
643 /**
644  * @brief Translates boot type DBUS property value to redfish.
645  *
646  * @param[in] dbusType    The boot type in DBUS speak.
647  *
648  * @return Returns as a string, the boot type in Redfish terms. If translation
649  * cannot be done, returns an empty string.
650  */
651 inline std::string dbusToRfBootType(const std::string& dbusType)
652 {
653     if (dbusType == "xyz.openbmc_project.Control.Boot.Type.Types.Legacy")
654     {
655         return "Legacy";
656     }
657     if (dbusType == "xyz.openbmc_project.Control.Boot.Type.Types.EFI")
658     {
659         return "UEFI";
660     }
661     return "";
662 }
663 
664 /**
665  * @brief Translates boot mode DBUS property value to redfish.
666  *
667  * @param[in] dbusMode    The boot mode in DBUS speak.
668  *
669  * @return Returns as a string, the boot mode in Redfish terms. If translation
670  * cannot be done, returns an empty string.
671  */
672 inline std::string dbusToRfBootMode(const std::string& dbusMode)
673 {
674     if (dbusMode == "xyz.openbmc_project.Control.Boot.Mode.Modes.Regular")
675     {
676         return "None";
677     }
678     if (dbusMode == "xyz.openbmc_project.Control.Boot.Mode.Modes.Safe")
679     {
680         return "Diags";
681     }
682     if (dbusMode == "xyz.openbmc_project.Control.Boot.Mode.Modes.Setup")
683     {
684         return "BiosSetup";
685     }
686     return "";
687 }
688 
689 /**
690  * @brief Translates boot progress DBUS property value to redfish.
691  *
692  * @param[in] dbusBootProgress    The boot progress in DBUS speak.
693  *
694  * @return Returns as a string, the boot progress in Redfish terms. If
695  *         translation cannot be done, returns "None".
696  */
697 inline std::string dbusToRfBootProgress(const std::string& dbusBootProgress)
698 {
699     // Now convert the D-Bus BootProgress to the appropriate Redfish
700     // enum
701     std::string rfBpLastState = "None";
702     if (dbusBootProgress == "xyz.openbmc_project.State.Boot.Progress."
703                             "ProgressStages.Unspecified")
704     {
705         rfBpLastState = "None";
706     }
707     else if (dbusBootProgress ==
708              "xyz.openbmc_project.State.Boot.Progress.ProgressStages."
709              "PrimaryProcInit")
710     {
711         rfBpLastState = "PrimaryProcessorInitializationStarted";
712     }
713     else if (dbusBootProgress ==
714              "xyz.openbmc_project.State.Boot.Progress.ProgressStages."
715              "BusInit")
716     {
717         rfBpLastState = "BusInitializationStarted";
718     }
719     else if (dbusBootProgress ==
720              "xyz.openbmc_project.State.Boot.Progress.ProgressStages."
721              "MemoryInit")
722     {
723         rfBpLastState = "MemoryInitializationStarted";
724     }
725     else if (dbusBootProgress ==
726              "xyz.openbmc_project.State.Boot.Progress.ProgressStages."
727              "SecondaryProcInit")
728     {
729         rfBpLastState = "SecondaryProcessorInitializationStarted";
730     }
731     else if (dbusBootProgress ==
732              "xyz.openbmc_project.State.Boot.Progress.ProgressStages."
733              "PCIInit")
734     {
735         rfBpLastState = "PCIResourceConfigStarted";
736     }
737     else if (dbusBootProgress ==
738              "xyz.openbmc_project.State.Boot.Progress.ProgressStages."
739              "SystemSetup")
740     {
741         rfBpLastState = "SetupEntered";
742     }
743     else if (dbusBootProgress ==
744              "xyz.openbmc_project.State.Boot.Progress.ProgressStages."
745              "SystemInitComplete")
746     {
747         rfBpLastState = "SystemHardwareInitializationComplete";
748     }
749     else if (dbusBootProgress ==
750              "xyz.openbmc_project.State.Boot.Progress.ProgressStages."
751              "OSStart")
752     {
753         rfBpLastState = "OSBootStarted";
754     }
755     else if (dbusBootProgress ==
756              "xyz.openbmc_project.State.Boot.Progress.ProgressStages."
757              "OSRunning")
758     {
759         rfBpLastState = "OSRunning";
760     }
761     else
762     {
763         BMCWEB_LOG_DEBUG("Unsupported D-Bus BootProgress {}", dbusBootProgress);
764         // Just return the default
765     }
766     return rfBpLastState;
767 }
768 
769 /**
770  * @brief Translates boot source from Redfish to the DBus boot paths.
771  *
772  * @param[in] rfSource    The boot source in Redfish.
773  * @param[out] bootSource The DBus source
774  * @param[out] bootMode   the DBus boot mode
775  *
776  * @return Integer error code.
777  */
778 inline int assignBootParameters(
779     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
780     const std::string& rfSource, std::string& bootSource, std::string& bootMode)
781 {
782     bootSource = "xyz.openbmc_project.Control.Boot.Source.Sources.Default";
783     bootMode = "xyz.openbmc_project.Control.Boot.Mode.Modes.Regular";
784 
785     if (rfSource == "None")
786     {
787         return 0;
788     }
789     if (rfSource == "Pxe")
790     {
791         bootSource = "xyz.openbmc_project.Control.Boot.Source.Sources.Network";
792     }
793     else if (rfSource == "Hdd")
794     {
795         bootSource = "xyz.openbmc_project.Control.Boot.Source.Sources.Disk";
796     }
797     else if (rfSource == "Diags")
798     {
799         bootMode = "xyz.openbmc_project.Control.Boot.Mode.Modes.Safe";
800     }
801     else if (rfSource == "Cd")
802     {
803         bootSource =
804             "xyz.openbmc_project.Control.Boot.Source.Sources.ExternalMedia";
805     }
806     else if (rfSource == "BiosSetup")
807     {
808         bootMode = "xyz.openbmc_project.Control.Boot.Mode.Modes.Setup";
809     }
810     else if (rfSource == "Usb")
811     {
812         bootSource =
813             "xyz.openbmc_project.Control.Boot.Source.Sources.RemovableMedia";
814     }
815     else
816     {
817         BMCWEB_LOG_DEBUG(
818             "Invalid property value for BootSourceOverrideTarget: {}",
819             bootSource);
820         messages::propertyValueNotInList(asyncResp->res, rfSource,
821                                          "BootSourceTargetOverride");
822         return -1;
823     }
824     return 0;
825 }
826 
827 /**
828  * @brief Retrieves boot progress of the system
829  *
830  * @param[in] asyncResp  Shared pointer for generating response message.
831  *
832  * @return None.
833  */
834 inline void getBootProgress(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
835 {
836     sdbusplus::asio::getProperty<std::string>(
837         *crow::connections::systemBus, "xyz.openbmc_project.State.Host",
838         "/xyz/openbmc_project/state/host0",
839         "xyz.openbmc_project.State.Boot.Progress", "BootProgress",
840         [asyncResp](const boost::system::error_code& ec,
841                     const std::string& bootProgressStr) {
842             if (ec)
843             {
844                 // BootProgress is an optional object so just do nothing if
845                 // not found
846                 return;
847             }
848 
849             BMCWEB_LOG_DEBUG("Boot Progress: {}", bootProgressStr);
850 
851             asyncResp->res.jsonValue["BootProgress"]["LastState"] =
852                 dbusToRfBootProgress(bootProgressStr);
853         });
854 }
855 
856 /**
857  * @brief Retrieves boot progress Last Update of the system
858  *
859  * @param[in] asyncResp  Shared pointer for generating response message.
860  *
861  * @return None.
862  */
863 inline void getBootProgressLastStateTime(
864     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
865 {
866     sdbusplus::asio::getProperty<uint64_t>(
867         *crow::connections::systemBus, "xyz.openbmc_project.State.Host",
868         "/xyz/openbmc_project/state/host0",
869         "xyz.openbmc_project.State.Boot.Progress", "BootProgressLastUpdate",
870         [asyncResp](const boost::system::error_code& ec,
871                     const uint64_t lastStateTime) {
872             if (ec)
873             {
874                 BMCWEB_LOG_DEBUG("D-BUS response error {}", ec);
875                 return;
876             }
877 
878             // BootProgressLastUpdate is the last time the BootProgress property
879             // was updated. The time is the Epoch time, number of microseconds
880             // since 1 Jan 1970 00::00::00 UTC."
881             // https://github.com/openbmc/phosphor-dbus-interfaces/blob/master/
882             // yaml/xyz/openbmc_project/State/Boot/Progress.interface.yaml#L11
883 
884             // Convert to ISO 8601 standard
885             asyncResp->res.jsonValue["BootProgress"]["LastStateTime"] =
886                 redfish::time_utils::getDateTimeUintUs(lastStateTime);
887         });
888 }
889 
890 /**
891  * @brief Retrieves boot override type over DBUS and fills out the response
892  *
893  * @param[in] asyncResp         Shared pointer for generating response message.
894  *
895  * @return None.
896  */
897 
898 inline void
899     getBootOverrideType(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
900 {
901     sdbusplus::asio::getProperty<std::string>(
902         *crow::connections::systemBus, "xyz.openbmc_project.Settings",
903         "/xyz/openbmc_project/control/host0/boot",
904         "xyz.openbmc_project.Control.Boot.Type", "BootType",
905         [asyncResp](const boost::system::error_code& ec,
906                     const std::string& bootType) {
907             if (ec)
908             {
909                 // not an error, don't have to have the interface
910                 return;
911             }
912 
913             BMCWEB_LOG_DEBUG("Boot type: {}", bootType);
914 
915             asyncResp->res
916                 .jsonValue["Boot"]
917                           ["BootSourceOverrideMode@Redfish.AllowableValues"] =
918                 nlohmann::json::array_t({"Legacy", "UEFI"});
919 
920             auto rfType = dbusToRfBootType(bootType);
921             if (rfType.empty())
922             {
923                 messages::internalError(asyncResp->res);
924                 return;
925             }
926 
927             asyncResp->res.jsonValue["Boot"]["BootSourceOverrideMode"] = rfType;
928         });
929 }
930 
931 /**
932  * @brief Retrieves boot override mode over DBUS and fills out the response
933  *
934  * @param[in] asyncResp         Shared pointer for generating response message.
935  *
936  * @return None.
937  */
938 
939 inline void
940     getBootOverrideMode(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
941 {
942     sdbusplus::asio::getProperty<std::string>(
943         *crow::connections::systemBus, "xyz.openbmc_project.Settings",
944         "/xyz/openbmc_project/control/host0/boot",
945         "xyz.openbmc_project.Control.Boot.Mode", "BootMode",
946         [asyncResp](const boost::system::error_code& ec,
947                     const std::string& bootModeStr) {
948             if (ec)
949             {
950                 BMCWEB_LOG_ERROR("DBUS response error {}", ec);
951                 messages::internalError(asyncResp->res);
952                 return;
953             }
954 
955             BMCWEB_LOG_DEBUG("Boot mode: {}", bootModeStr);
956 
957             nlohmann::json::array_t allowed;
958             allowed.emplace_back("None");
959             allowed.emplace_back("Pxe");
960             allowed.emplace_back("Hdd");
961             allowed.emplace_back("Cd");
962             allowed.emplace_back("Diags");
963             allowed.emplace_back("BiosSetup");
964             allowed.emplace_back("Usb");
965 
966             asyncResp->res
967                 .jsonValue["Boot"]
968                           ["BootSourceOverrideTarget@Redfish.AllowableValues"] =
969                 std::move(allowed);
970             if (bootModeStr !=
971                 "xyz.openbmc_project.Control.Boot.Mode.Modes.Regular")
972             {
973                 auto rfMode = dbusToRfBootMode(bootModeStr);
974                 if (!rfMode.empty())
975                 {
976                     asyncResp->res
977                         .jsonValue["Boot"]["BootSourceOverrideTarget"] = rfMode;
978                 }
979             }
980         });
981 }
982 
983 /**
984  * @brief Retrieves boot override source over DBUS
985  *
986  * @param[in] asyncResp         Shared pointer for generating response message.
987  *
988  * @return None.
989  */
990 
991 inline void
992     getBootOverrideSource(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
993 {
994     sdbusplus::asio::getProperty<std::string>(
995         *crow::connections::systemBus, "xyz.openbmc_project.Settings",
996         "/xyz/openbmc_project/control/host0/boot",
997         "xyz.openbmc_project.Control.Boot.Source", "BootSource",
998         [asyncResp](const boost::system::error_code& ec,
999                     const std::string& bootSourceStr) {
1000             if (ec)
1001             {
1002                 if (ec.value() == boost::asio::error::host_unreachable)
1003                 {
1004                     return;
1005                 }
1006                 BMCWEB_LOG_ERROR("DBUS response error {}", ec);
1007                 messages::internalError(asyncResp->res);
1008                 return;
1009             }
1010 
1011             BMCWEB_LOG_DEBUG("Boot source: {}", bootSourceStr);
1012 
1013             auto rfSource = dbusToRfBootSource(bootSourceStr);
1014             if (!rfSource.empty())
1015             {
1016                 asyncResp->res.jsonValue["Boot"]["BootSourceOverrideTarget"] =
1017                     rfSource;
1018             }
1019 
1020             // Get BootMode as BootSourceOverrideTarget is constructed
1021             // from both BootSource and BootMode
1022             getBootOverrideMode(asyncResp);
1023         });
1024 }
1025 
1026 /**
1027  * @brief This functions abstracts all the logic behind getting a
1028  * "BootSourceOverrideEnabled" property from an overall boot override enable
1029  * state
1030  *
1031  * @param[in] asyncResp     Shared pointer for generating response message.
1032  *
1033  * @return None.
1034  */
1035 
1036 inline void processBootOverrideEnable(
1037     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
1038     const bool bootOverrideEnableSetting)
1039 {
1040     if (!bootOverrideEnableSetting)
1041     {
1042         asyncResp->res.jsonValue["Boot"]["BootSourceOverrideEnabled"] =
1043             "Disabled";
1044         return;
1045     }
1046 
1047     // If boot source override is enabled, we need to check 'one_time'
1048     // property to set a correct value for the "BootSourceOverrideEnabled"
1049     sdbusplus::asio::getProperty<bool>(
1050         *crow::connections::systemBus, "xyz.openbmc_project.Settings",
1051         "/xyz/openbmc_project/control/host0/boot/one_time",
1052         "xyz.openbmc_project.Object.Enable", "Enabled",
1053         [asyncResp](const boost::system::error_code& ec, bool oneTimeSetting) {
1054             if (ec)
1055             {
1056                 BMCWEB_LOG_ERROR("DBUS response error {}", ec);
1057                 messages::internalError(asyncResp->res);
1058                 return;
1059             }
1060 
1061             if (oneTimeSetting)
1062             {
1063                 asyncResp->res.jsonValue["Boot"]["BootSourceOverrideEnabled"] =
1064                     "Once";
1065             }
1066             else
1067             {
1068                 asyncResp->res.jsonValue["Boot"]["BootSourceOverrideEnabled"] =
1069                     "Continuous";
1070             }
1071         });
1072 }
1073 
1074 /**
1075  * @brief Retrieves boot override enable over DBUS
1076  *
1077  * @param[in] asyncResp     Shared pointer for generating response message.
1078  *
1079  * @return None.
1080  */
1081 
1082 inline void
1083     getBootOverrideEnable(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
1084 {
1085     sdbusplus::asio::getProperty<bool>(
1086         *crow::connections::systemBus, "xyz.openbmc_project.Settings",
1087         "/xyz/openbmc_project/control/host0/boot",
1088         "xyz.openbmc_project.Object.Enable", "Enabled",
1089         [asyncResp](const boost::system::error_code& ec,
1090                     const bool bootOverrideEnable) {
1091             if (ec)
1092             {
1093                 if (ec.value() == boost::asio::error::host_unreachable)
1094                 {
1095                     return;
1096                 }
1097                 BMCWEB_LOG_ERROR("DBUS response error {}", ec);
1098                 messages::internalError(asyncResp->res);
1099                 return;
1100             }
1101 
1102             processBootOverrideEnable(asyncResp, bootOverrideEnable);
1103         });
1104 }
1105 
1106 /**
1107  * @brief Retrieves boot source override properties
1108  *
1109  * @param[in] asyncResp     Shared pointer for generating response message.
1110  *
1111  * @return None.
1112  */
1113 inline void
1114     getBootProperties(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
1115 {
1116     BMCWEB_LOG_DEBUG("Get boot information.");
1117 
1118     getBootOverrideSource(asyncResp);
1119     getBootOverrideType(asyncResp);
1120     getBootOverrideEnable(asyncResp);
1121 }
1122 
1123 /**
1124  * @brief Retrieves the Last Reset Time
1125  *
1126  * "Reset" is an overloaded term in Redfish, "Reset" includes power on
1127  * and power off. Even though this is the "system" Redfish object look at the
1128  * chassis D-Bus interface for the LastStateChangeTime since this has the
1129  * last power operation time.
1130  *
1131  * @param[in] asyncResp     Shared pointer for generating response message.
1132  *
1133  * @return None.
1134  */
1135 inline void
1136     getLastResetTime(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
1137 {
1138     BMCWEB_LOG_DEBUG("Getting System Last Reset Time");
1139 
1140     sdbusplus::asio::getProperty<uint64_t>(
1141         *crow::connections::systemBus, "xyz.openbmc_project.State.Chassis",
1142         "/xyz/openbmc_project/state/chassis0",
1143         "xyz.openbmc_project.State.Chassis", "LastStateChangeTime",
1144         [asyncResp](const boost::system::error_code& ec,
1145                     uint64_t lastResetTime) {
1146             if (ec)
1147             {
1148                 BMCWEB_LOG_DEBUG("D-BUS response error {}", ec);
1149                 return;
1150             }
1151 
1152             // LastStateChangeTime is epoch time, in milliseconds
1153             // https://github.com/openbmc/phosphor-dbus-interfaces/blob/33e8e1dd64da53a66e888d33dc82001305cd0bf9/xyz/openbmc_project/State/Chassis.interface.yaml#L19
1154             uint64_t lastResetTimeStamp = lastResetTime / 1000;
1155 
1156             // Convert to ISO 8601 standard
1157             asyncResp->res.jsonValue["LastResetTime"] =
1158                 redfish::time_utils::getDateTimeUint(lastResetTimeStamp);
1159         });
1160 }
1161 
1162 /**
1163  * @brief Retrieves the number of automatic boot Retry attempts allowed/left.
1164  *
1165  * The total number of automatic reboot retries allowed "RetryAttempts" and its
1166  * corresponding property "AttemptsLeft" that keeps track of the amount of
1167  * automatic retry attempts left are hosted in phosphor-state-manager through
1168  * dbus.
1169  *
1170  * @param[in] asyncResp     Shared pointer for generating response message.
1171  *
1172  * @return None.
1173  */
1174 inline void getAutomaticRebootAttempts(
1175     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
1176 {
1177     BMCWEB_LOG_DEBUG("Get Automatic Retry policy");
1178 
1179     sdbusplus::asio::getAllProperties(
1180         *crow::connections::systemBus, "xyz.openbmc_project.State.Host",
1181         "/xyz/openbmc_project/state/host0",
1182         "xyz.openbmc_project.Control.Boot.RebootAttempts",
1183         [asyncResp{asyncResp}](
1184             const boost::system::error_code& ec,
1185             const dbus::utility::DBusPropertiesMap& propertiesList) {
1186             if (ec)
1187             {
1188                 if (ec.value() != EBADR)
1189                 {
1190                     BMCWEB_LOG_ERROR("D-Bus responses error: {}", ec);
1191                     messages::internalError(asyncResp->res);
1192                 }
1193                 return;
1194             }
1195 
1196             const uint32_t* attemptsLeft = nullptr;
1197             const uint32_t* retryAttempts = nullptr;
1198 
1199             const bool success = sdbusplus::unpackPropertiesNoThrow(
1200                 dbus_utils::UnpackErrorPrinter(), propertiesList,
1201                 "AttemptsLeft", attemptsLeft, "RetryAttempts", retryAttempts);
1202 
1203             if (!success)
1204             {
1205                 messages::internalError(asyncResp->res);
1206                 return;
1207             }
1208 
1209             if (attemptsLeft != nullptr)
1210             {
1211                 asyncResp->res
1212                     .jsonValue["Boot"]["RemainingAutomaticRetryAttempts"] =
1213                     *attemptsLeft;
1214             }
1215 
1216             if (retryAttempts != nullptr)
1217             {
1218                 asyncResp->res.jsonValue["Boot"]["AutomaticRetryAttempts"] =
1219                     *retryAttempts;
1220             }
1221         });
1222 }
1223 
1224 /**
1225  * @brief Retrieves Automatic Retry properties. Known on D-Bus as AutoReboot.
1226  *
1227  * @param[in] asyncResp     Shared pointer for generating response message.
1228  *
1229  * @return None.
1230  */
1231 inline void
1232     getAutomaticRetryPolicy(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
1233 {
1234     BMCWEB_LOG_DEBUG("Get Automatic Retry policy");
1235 
1236     sdbusplus::asio::getProperty<bool>(
1237         *crow::connections::systemBus, "xyz.openbmc_project.Settings",
1238         "/xyz/openbmc_project/control/host0/auto_reboot",
1239         "xyz.openbmc_project.Control.Boot.RebootPolicy", "AutoReboot",
1240         [asyncResp](const boost::system::error_code& ec,
1241                     bool autoRebootEnabled) {
1242             if (ec)
1243             {
1244                 if (ec.value() != EBADR)
1245                 {
1246                     BMCWEB_LOG_ERROR("D-Bus responses error: {}", ec);
1247                     messages::internalError(asyncResp->res);
1248                 }
1249                 return;
1250             }
1251 
1252             BMCWEB_LOG_DEBUG("Auto Reboot: {}", autoRebootEnabled);
1253             if (autoRebootEnabled)
1254             {
1255                 asyncResp->res.jsonValue["Boot"]["AutomaticRetryConfig"] =
1256                     "RetryAttempts";
1257             }
1258             else
1259             {
1260                 asyncResp->res.jsonValue["Boot"]["AutomaticRetryConfig"] =
1261                     "Disabled";
1262             }
1263             getAutomaticRebootAttempts(asyncResp);
1264 
1265             // "AutomaticRetryConfig" can be 3 values, Disabled, RetryAlways,
1266             // and RetryAttempts. OpenBMC only supports Disabled and
1267             // RetryAttempts.
1268             nlohmann::json::array_t allowed;
1269             allowed.emplace_back("Disabled");
1270             allowed.emplace_back("RetryAttempts");
1271             asyncResp->res
1272                 .jsonValue["Boot"]
1273                           ["AutomaticRetryConfig@Redfish.AllowableValues"] =
1274                 std::move(allowed);
1275         });
1276 }
1277 
1278 /**
1279  * @brief Sets RetryAttempts
1280  *
1281  * @param[in] asyncResp   Shared pointer for generating response message.
1282  * @param[in] retryAttempts  "AutomaticRetryAttempts" from request.
1283  *
1284  *@return None.
1285  */
1286 
1287 inline void setAutomaticRetryAttempts(
1288     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
1289     const uint32_t retryAttempts)
1290 {
1291     BMCWEB_LOG_DEBUG("Set Automatic Retry Attempts.");
1292     setDbusProperty(
1293         asyncResp, "Boot/AutomaticRetryAttempts",
1294         "xyz.openbmc_project.State.Host",
1295         sdbusplus::message::object_path("/xyz/openbmc_project/state/host0"),
1296         "xyz.openbmc_project.Control.Boot.RebootAttempts", "RetryAttempts",
1297         retryAttempts);
1298 }
1299 
1300 inline computer_system::PowerRestorePolicyTypes
1301     redfishPowerRestorePolicyFromDbus(std::string_view value)
1302 {
1303     if (value ==
1304         "xyz.openbmc_project.Control.Power.RestorePolicy.Policy.AlwaysOn")
1305     {
1306         return computer_system::PowerRestorePolicyTypes::AlwaysOn;
1307     }
1308     if (value ==
1309         "xyz.openbmc_project.Control.Power.RestorePolicy.Policy.AlwaysOff")
1310     {
1311         return computer_system::PowerRestorePolicyTypes::AlwaysOff;
1312     }
1313     if (value ==
1314         "xyz.openbmc_project.Control.Power.RestorePolicy.Policy.Restore")
1315     {
1316         return computer_system::PowerRestorePolicyTypes::LastState;
1317     }
1318     if (value == "xyz.openbmc_project.Control.Power.RestorePolicy.Policy.None")
1319     {
1320         return computer_system::PowerRestorePolicyTypes::AlwaysOff;
1321     }
1322     return computer_system::PowerRestorePolicyTypes::Invalid;
1323 }
1324 /**
1325  * @brief Retrieves power restore policy over DBUS.
1326  *
1327  * @param[in] asyncResp     Shared pointer for generating response message.
1328  *
1329  * @return None.
1330  */
1331 inline void
1332     getPowerRestorePolicy(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
1333 {
1334     BMCWEB_LOG_DEBUG("Get power restore policy");
1335 
1336     sdbusplus::asio::getProperty<std::string>(
1337         *crow::connections::systemBus, "xyz.openbmc_project.Settings",
1338         "/xyz/openbmc_project/control/host0/power_restore_policy",
1339         "xyz.openbmc_project.Control.Power.RestorePolicy", "PowerRestorePolicy",
1340         [asyncResp](const boost::system::error_code& ec,
1341                     const std::string& policy) {
1342             if (ec)
1343             {
1344                 BMCWEB_LOG_DEBUG("DBUS response error {}", ec);
1345                 return;
1346             }
1347             computer_system::PowerRestorePolicyTypes restore =
1348                 redfishPowerRestorePolicyFromDbus(policy);
1349             if (restore == computer_system::PowerRestorePolicyTypes::Invalid)
1350             {
1351                 messages::internalError(asyncResp->res);
1352                 return;
1353             }
1354 
1355             asyncResp->res.jsonValue["PowerRestorePolicy"] = restore;
1356         });
1357 }
1358 
1359 /**
1360  * @brief Stop Boot On Fault over DBUS.
1361  *
1362  * @param[in] asyncResp     Shared pointer for generating response message.
1363  *
1364  * @return None.
1365  */
1366 inline void
1367     getStopBootOnFault(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
1368 {
1369     BMCWEB_LOG_DEBUG("Get Stop Boot On Fault");
1370 
1371     sdbusplus::asio::getProperty<bool>(
1372         *crow::connections::systemBus, "xyz.openbmc_project.Settings",
1373         "/xyz/openbmc_project/logging/settings",
1374         "xyz.openbmc_project.Logging.Settings", "QuiesceOnHwError",
1375         [asyncResp](const boost::system::error_code& ec, bool value) {
1376             if (ec)
1377             {
1378                 if (ec.value() != EBADR)
1379                 {
1380                     BMCWEB_LOG_ERROR("DBUS response error {}", ec);
1381                     messages::internalError(asyncResp->res);
1382                 }
1383                 return;
1384             }
1385 
1386             if (value)
1387             {
1388                 asyncResp->res.jsonValue["Boot"]["StopBootOnFault"] =
1389                     computer_system::StopBootOnFault::AnyFault;
1390             }
1391             else
1392             {
1393                 asyncResp->res.jsonValue["Boot"]["StopBootOnFault"] =
1394                     computer_system::StopBootOnFault::Never;
1395             }
1396         });
1397 }
1398 
1399 /**
1400  * @brief Get TrustedModuleRequiredToBoot property. Determines whether or not
1401  * TPM is required for booting the host.
1402  *
1403  * @param[in] asyncResp     Shared pointer for generating response message.
1404  *
1405  * @return None.
1406  */
1407 inline void getTrustedModuleRequiredToBoot(
1408     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
1409 {
1410     BMCWEB_LOG_DEBUG("Get TPM required to boot.");
1411     constexpr std::array<std::string_view, 1> interfaces = {
1412         "xyz.openbmc_project.Control.TPM.Policy"};
1413     dbus::utility::getSubTree(
1414         "/", 0, interfaces,
1415         [asyncResp](const boost::system::error_code& ec,
1416                     const dbus::utility::MapperGetSubTreeResponse& subtree) {
1417             if (ec)
1418             {
1419                 BMCWEB_LOG_DEBUG(
1420                     "DBUS response error on TPM.Policy GetSubTree{}", ec);
1421                 // This is an optional D-Bus object so just return if
1422                 // error occurs
1423                 return;
1424             }
1425             if (subtree.empty())
1426             {
1427                 // As noted above, this is an optional interface so just return
1428                 // if there is no instance found
1429                 return;
1430             }
1431 
1432             /* When there is more than one TPMEnable object... */
1433             if (subtree.size() > 1)
1434             {
1435                 BMCWEB_LOG_DEBUG(
1436                     "DBUS response has more than 1 TPM Enable object:{}",
1437                     subtree.size());
1438                 // Throw an internal Error and return
1439                 messages::internalError(asyncResp->res);
1440                 return;
1441             }
1442 
1443             // Make sure the Dbus response map has a service and objectPath
1444             // field
1445             if (subtree[0].first.empty() || subtree[0].second.size() != 1)
1446             {
1447                 BMCWEB_LOG_DEBUG("TPM.Policy mapper error!");
1448                 messages::internalError(asyncResp->res);
1449                 return;
1450             }
1451 
1452             const std::string& path = subtree[0].first;
1453             const std::string& serv = subtree[0].second.begin()->first;
1454 
1455             // Valid TPM Enable object found, now reading the current value
1456             sdbusplus::asio::getProperty<bool>(
1457                 *crow::connections::systemBus, serv, path,
1458                 "xyz.openbmc_project.Control.TPM.Policy", "TPMEnable",
1459                 [asyncResp](const boost::system::error_code& ec2,
1460                             bool tpmRequired) {
1461                     if (ec2)
1462                     {
1463                         BMCWEB_LOG_ERROR(
1464                             "D-BUS response error on TPM.Policy Get{}", ec2);
1465                         messages::internalError(asyncResp->res);
1466                         return;
1467                     }
1468 
1469                     if (tpmRequired)
1470                     {
1471                         asyncResp->res
1472                             .jsonValue["Boot"]["TrustedModuleRequiredToBoot"] =
1473                             "Required";
1474                     }
1475                     else
1476                     {
1477                         asyncResp->res
1478                             .jsonValue["Boot"]["TrustedModuleRequiredToBoot"] =
1479                             "Disabled";
1480                     }
1481                 });
1482         });
1483 }
1484 
1485 /**
1486  * @brief Set TrustedModuleRequiredToBoot property. Determines whether or not
1487  * TPM is required for booting the host.
1488  *
1489  * @param[in] asyncResp     Shared pointer for generating response message.
1490  * @param[in] tpmRequired   Value to set TPM Required To Boot property to.
1491  *
1492  * @return None.
1493  */
1494 inline void setTrustedModuleRequiredToBoot(
1495     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp, const bool tpmRequired)
1496 {
1497     BMCWEB_LOG_DEBUG("Set TrustedModuleRequiredToBoot.");
1498     constexpr std::array<std::string_view, 1> interfaces = {
1499         "xyz.openbmc_project.Control.TPM.Policy"};
1500     dbus::utility::getSubTree(
1501         "/", 0, interfaces,
1502         [asyncResp,
1503          tpmRequired](const boost::system::error_code& ec,
1504                       const dbus::utility::MapperGetSubTreeResponse& subtree) {
1505             if (ec)
1506             {
1507                 BMCWEB_LOG_ERROR(
1508                     "DBUS response error on TPM.Policy GetSubTree{}", ec);
1509                 messages::internalError(asyncResp->res);
1510                 return;
1511             }
1512             if (subtree.empty())
1513             {
1514                 messages::propertyValueNotInList(asyncResp->res,
1515                                                  "ComputerSystem",
1516                                                  "TrustedModuleRequiredToBoot");
1517                 return;
1518             }
1519 
1520             /* When there is more than one TPMEnable object... */
1521             if (subtree.size() > 1)
1522             {
1523                 BMCWEB_LOG_DEBUG(
1524                     "DBUS response has more than 1 TPM Enable object:{}",
1525                     subtree.size());
1526                 // Throw an internal Error and return
1527                 messages::internalError(asyncResp->res);
1528                 return;
1529             }
1530 
1531             // Make sure the Dbus response map has a service and objectPath
1532             // field
1533             if (subtree[0].first.empty() || subtree[0].second.size() != 1)
1534             {
1535                 BMCWEB_LOG_DEBUG("TPM.Policy mapper error!");
1536                 messages::internalError(asyncResp->res);
1537                 return;
1538             }
1539 
1540             const std::string& path = subtree[0].first;
1541             const std::string& serv = subtree[0].second.begin()->first;
1542 
1543             if (serv.empty())
1544             {
1545                 BMCWEB_LOG_DEBUG("TPM.Policy service mapper error!");
1546                 messages::internalError(asyncResp->res);
1547                 return;
1548             }
1549 
1550             // Valid TPM Enable object found, now setting the value
1551             setDbusProperty(asyncResp, "Boot/TrustedModuleRequiredToBoot", serv,
1552                             path, "xyz.openbmc_project.Control.TPM.Policy",
1553                             "TPMEnable", tpmRequired);
1554         });
1555 }
1556 
1557 /**
1558  * @brief Sets boot properties into DBUS object(s).
1559  *
1560  * @param[in] asyncResp       Shared pointer for generating response message.
1561  * @param[in] bootType        The boot type to set.
1562  * @return Integer error code.
1563  */
1564 inline void setBootType(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
1565                         const std::optional<std::string>& bootType)
1566 {
1567     std::string bootTypeStr;
1568 
1569     if (!bootType)
1570     {
1571         return;
1572     }
1573 
1574     // Source target specified
1575     BMCWEB_LOG_DEBUG("Boot type: {}", *bootType);
1576     // Figure out which DBUS interface and property to use
1577     if (*bootType == "Legacy")
1578     {
1579         bootTypeStr = "xyz.openbmc_project.Control.Boot.Type.Types.Legacy";
1580     }
1581     else if (*bootType == "UEFI")
1582     {
1583         bootTypeStr = "xyz.openbmc_project.Control.Boot.Type.Types.EFI";
1584     }
1585     else
1586     {
1587         BMCWEB_LOG_DEBUG("Invalid property value for "
1588                          "BootSourceOverrideMode: {}",
1589                          *bootType);
1590         messages::propertyValueNotInList(asyncResp->res, *bootType,
1591                                          "BootSourceOverrideMode");
1592         return;
1593     }
1594 
1595     // Act on validated parameters
1596     BMCWEB_LOG_DEBUG("DBUS boot type: {}", bootTypeStr);
1597 
1598     setDbusProperty(asyncResp, "Boot/BootSourceOverrideMode",
1599                     "xyz.openbmc_project.Settings",
1600                     sdbusplus::message::object_path(
1601                         "/xyz/openbmc_project/control/host0/boot"),
1602                     "xyz.openbmc_project.Control.Boot.Type", "BootType",
1603                     bootTypeStr);
1604 }
1605 
1606 /**
1607  * @brief Sets boot properties into DBUS object(s).
1608  *
1609  * @param[in] asyncResp           Shared pointer for generating response
1610  * message.
1611  * @param[in] bootType        The boot type to set.
1612  * @return Integer error code.
1613  */
1614 inline void setBootEnable(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
1615                           const std::optional<std::string>& bootEnable)
1616 {
1617     if (!bootEnable)
1618     {
1619         return;
1620     }
1621     // Source target specified
1622     BMCWEB_LOG_DEBUG("Boot enable: {}", *bootEnable);
1623 
1624     bool bootOverrideEnable = false;
1625     bool bootOverridePersistent = false;
1626     // Figure out which DBUS interface and property to use
1627     if (*bootEnable == "Disabled")
1628     {
1629         bootOverrideEnable = false;
1630     }
1631     else if (*bootEnable == "Once")
1632     {
1633         bootOverrideEnable = true;
1634         bootOverridePersistent = false;
1635     }
1636     else if (*bootEnable == "Continuous")
1637     {
1638         bootOverrideEnable = true;
1639         bootOverridePersistent = true;
1640     }
1641     else
1642     {
1643         BMCWEB_LOG_DEBUG(
1644             "Invalid property value for BootSourceOverrideEnabled: {}",
1645             *bootEnable);
1646         messages::propertyValueNotInList(asyncResp->res, *bootEnable,
1647                                          "BootSourceOverrideEnabled");
1648         return;
1649     }
1650 
1651     // Act on validated parameters
1652     BMCWEB_LOG_DEBUG("DBUS boot override enable: {}", bootOverrideEnable);
1653 
1654     setDbusProperty(asyncResp, "Boot/BootSourceOverrideEnabled",
1655                     "xyz.openbmc_project.Settings",
1656                     sdbusplus::message::object_path(
1657                         "/xyz/openbmc_project/control/host0/boot"),
1658                     "xyz.openbmc_project.Object.Enable", "Enabled",
1659                     bootOverrideEnable);
1660 
1661     if (!bootOverrideEnable)
1662     {
1663         return;
1664     }
1665 
1666     // In case boot override is enabled we need to set correct value for the
1667     // 'one_time' enable DBus interface
1668     BMCWEB_LOG_DEBUG("DBUS boot override persistent: {}",
1669                      bootOverridePersistent);
1670 
1671     setDbusProperty(asyncResp, "Boot/BootSourceOverrideEnabled",
1672                     "xyz.openbmc_project.Settings",
1673                     sdbusplus::message::object_path(
1674                         "/xyz/openbmc_project/control/host0/boot/one_time"),
1675                     "xyz.openbmc_project.Object.Enable", "Enabled",
1676                     !bootOverridePersistent);
1677 }
1678 
1679 /**
1680  * @brief Sets boot properties into DBUS object(s).
1681  *
1682  * @param[in] asyncResp       Shared pointer for generating response message.
1683  * @param[in] bootSource      The boot source to set.
1684  *
1685  * @return Integer error code.
1686  */
1687 inline void
1688     setBootModeOrSource(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
1689                         const std::optional<std::string>& bootSource)
1690 {
1691     std::string bootSourceStr;
1692     std::string bootModeStr;
1693 
1694     if (!bootSource)
1695     {
1696         return;
1697     }
1698 
1699     // Source target specified
1700     BMCWEB_LOG_DEBUG("Boot source: {}", *bootSource);
1701     // Figure out which DBUS interface and property to use
1702     if (assignBootParameters(asyncResp, *bootSource, bootSourceStr,
1703                              bootModeStr) != 0)
1704     {
1705         BMCWEB_LOG_DEBUG(
1706             "Invalid property value for BootSourceOverrideTarget: {}",
1707             *bootSource);
1708         messages::propertyValueNotInList(asyncResp->res, *bootSource,
1709                                          "BootSourceTargetOverride");
1710         return;
1711     }
1712 
1713     // Act on validated parameters
1714     BMCWEB_LOG_DEBUG("DBUS boot source: {}", bootSourceStr);
1715     BMCWEB_LOG_DEBUG("DBUS boot mode: {}", bootModeStr);
1716 
1717     setDbusProperty(asyncResp, "Boot/BootSourceOverrideTarget",
1718                     "xyz.openbmc_project.Settings",
1719                     sdbusplus::message::object_path(
1720                         "/xyz/openbmc_project/control/host0/boot"),
1721                     "xyz.openbmc_project.Control.Boot.Source", "BootSource",
1722                     bootSourceStr);
1723     setDbusProperty(asyncResp, "Boot/BootSourceOverrideTarget",
1724                     "xyz.openbmc_project.Settings",
1725                     sdbusplus::message::object_path(
1726                         "/xyz/openbmc_project/control/host0/boot"),
1727                     "xyz.openbmc_project.Control.Boot.Mode", "BootMode",
1728                     bootModeStr);
1729 }
1730 
1731 /**
1732  * @brief Sets Boot source override properties.
1733  *
1734  * @param[in] asyncResp  Shared pointer for generating response message.
1735  * @param[in] bootSource The boot source from incoming RF request.
1736  * @param[in] bootType   The boot type from incoming RF request.
1737  * @param[in] bootEnable The boot override enable from incoming RF request.
1738  *
1739  * @return Integer error code.
1740  */
1741 
1742 inline void
1743     setBootProperties(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
1744                       const std::optional<std::string>& bootSource,
1745                       const std::optional<std::string>& bootType,
1746                       const std::optional<std::string>& bootEnable)
1747 {
1748     BMCWEB_LOG_DEBUG("Set boot information.");
1749 
1750     setBootModeOrSource(asyncResp, bootSource);
1751     setBootType(asyncResp, bootType);
1752     setBootEnable(asyncResp, bootEnable);
1753 }
1754 
1755 /**
1756  * @brief Sets AssetTag
1757  *
1758  * @param[in] asyncResp Shared pointer for generating response message.
1759  * @param[in] assetTag  "AssetTag" from request.
1760  *
1761  * @return None.
1762  */
1763 inline void setAssetTag(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
1764                         const std::string& assetTag)
1765 {
1766     constexpr std::array<std::string_view, 1> interfaces = {
1767         "xyz.openbmc_project.Inventory.Item.System"};
1768     dbus::utility::getSubTree(
1769         "/xyz/openbmc_project/inventory", 0, interfaces,
1770         [asyncResp,
1771          assetTag](const boost::system::error_code& ec,
1772                    const dbus::utility::MapperGetSubTreeResponse& subtree) {
1773             if (ec)
1774             {
1775                 BMCWEB_LOG_DEBUG("D-Bus response error on GetSubTree {}", ec);
1776                 messages::internalError(asyncResp->res);
1777                 return;
1778             }
1779             if (subtree.empty())
1780             {
1781                 BMCWEB_LOG_DEBUG("Can't find system D-Bus object!");
1782                 messages::internalError(asyncResp->res);
1783                 return;
1784             }
1785             // Assume only 1 system D-Bus object
1786             // Throw an error if there is more than 1
1787             if (subtree.size() > 1)
1788             {
1789                 BMCWEB_LOG_DEBUG("Found more than 1 system D-Bus object!");
1790                 messages::internalError(asyncResp->res);
1791                 return;
1792             }
1793             if (subtree[0].first.empty() || subtree[0].second.size() != 1)
1794             {
1795                 BMCWEB_LOG_DEBUG("Asset Tag Set mapper error!");
1796                 messages::internalError(asyncResp->res);
1797                 return;
1798             }
1799 
1800             const std::string& path = subtree[0].first;
1801             const std::string& service = subtree[0].second.begin()->first;
1802 
1803             if (service.empty())
1804             {
1805                 BMCWEB_LOG_DEBUG("Asset Tag Set service mapper error!");
1806                 messages::internalError(asyncResp->res);
1807                 return;
1808             }
1809 
1810             setDbusProperty(asyncResp, "AssetTag", service, path,
1811                             "xyz.openbmc_project.Inventory.Decorator.AssetTag",
1812                             "AssetTag", assetTag);
1813         });
1814 }
1815 
1816 /**
1817  * @brief Validate the specified stopBootOnFault is valid and return the
1818  * stopBootOnFault name associated with that string
1819  *
1820  * @param[in] stopBootOnFaultString  String representing the desired
1821  * stopBootOnFault
1822  *
1823  * @return stopBootOnFault value or empty  if incoming value is not valid
1824  */
1825 inline std::optional<bool>
1826     validstopBootOnFault(const std::string& stopBootOnFaultString)
1827 {
1828     if (stopBootOnFaultString == "AnyFault")
1829     {
1830         return true;
1831     }
1832 
1833     if (stopBootOnFaultString == "Never")
1834     {
1835         return false;
1836     }
1837 
1838     return std::nullopt;
1839 }
1840 
1841 /**
1842  * @brief Sets stopBootOnFault
1843  *
1844  * @param[in] asyncResp   Shared pointer for generating response message.
1845  * @param[in] stopBootOnFault  "StopBootOnFault" from request.
1846  *
1847  * @return None.
1848  */
1849 inline void
1850     setStopBootOnFault(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
1851                        const std::string& stopBootOnFault)
1852 {
1853     BMCWEB_LOG_DEBUG("Set Stop Boot On Fault.");
1854 
1855     std::optional<bool> stopBootEnabled = validstopBootOnFault(stopBootOnFault);
1856     if (!stopBootEnabled)
1857     {
1858         BMCWEB_LOG_DEBUG("Invalid property value for StopBootOnFault: {}",
1859                          stopBootOnFault);
1860         messages::propertyValueNotInList(asyncResp->res, stopBootOnFault,
1861                                          "StopBootOnFault");
1862         return;
1863     }
1864 
1865     setDbusProperty(asyncResp, "Boot/StopBootOnFault",
1866                     "xyz.openbmc_project.Settings",
1867                     sdbusplus::message::object_path(
1868                         "/xyz/openbmc_project/logging/settings"),
1869                     "xyz.openbmc_project.Logging.Settings", "QuiesceOnHwError",
1870                     *stopBootEnabled);
1871 }
1872 
1873 /**
1874  * @brief Sets automaticRetry (Auto Reboot)
1875  *
1876  * @param[in] asyncResp   Shared pointer for generating response message.
1877  * @param[in] automaticRetryConfig  "AutomaticRetryConfig" from request.
1878  *
1879  * @return None.
1880  */
1881 inline void
1882     setAutomaticRetry(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
1883                       const std::string& automaticRetryConfig)
1884 {
1885     BMCWEB_LOG_DEBUG("Set Automatic Retry.");
1886 
1887     // OpenBMC only supports "Disabled" and "RetryAttempts".
1888     bool autoRebootEnabled = false;
1889 
1890     if (automaticRetryConfig == "Disabled")
1891     {
1892         autoRebootEnabled = false;
1893     }
1894     else if (automaticRetryConfig == "RetryAttempts")
1895     {
1896         autoRebootEnabled = true;
1897     }
1898     else
1899     {
1900         BMCWEB_LOG_DEBUG("Invalid property value for AutomaticRetryConfig: {}",
1901                          automaticRetryConfig);
1902         messages::propertyValueNotInList(asyncResp->res, automaticRetryConfig,
1903                                          "AutomaticRetryConfig");
1904         return;
1905     }
1906 
1907     setDbusProperty(asyncResp, "Boot/AutomaticRetryConfig",
1908                     "xyz.openbmc_project.Settings",
1909                     sdbusplus::message::object_path(
1910                         "/xyz/openbmc_project/control/host0/auto_reboot"),
1911                     "xyz.openbmc_project.Control.Boot.RebootPolicy",
1912                     "AutoReboot", autoRebootEnabled);
1913 }
1914 
1915 inline std::string dbusPowerRestorePolicyFromRedfish(std::string_view policy)
1916 {
1917     if (policy == "AlwaysOn")
1918     {
1919         return "xyz.openbmc_project.Control.Power.RestorePolicy.Policy.AlwaysOn";
1920     }
1921     if (policy == "AlwaysOff")
1922     {
1923         return "xyz.openbmc_project.Control.Power.RestorePolicy.Policy.AlwaysOff";
1924     }
1925     if (policy == "LastState")
1926     {
1927         return "xyz.openbmc_project.Control.Power.RestorePolicy.Policy.Restore";
1928     }
1929     return "";
1930 }
1931 
1932 /**
1933  * @brief Sets power restore policy properties.
1934  *
1935  * @param[in] asyncResp   Shared pointer for generating response message.
1936  * @param[in] policy  power restore policy properties from request.
1937  *
1938  * @return None.
1939  */
1940 inline void
1941     setPowerRestorePolicy(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
1942                           std::string_view policy)
1943 {
1944     BMCWEB_LOG_DEBUG("Set power restore policy.");
1945 
1946     std::string powerRestorePolicy = dbusPowerRestorePolicyFromRedfish(policy);
1947 
1948     if (powerRestorePolicy.empty())
1949     {
1950         messages::propertyValueNotInList(asyncResp->res, policy,
1951                                          "PowerRestorePolicy");
1952         return;
1953     }
1954 
1955     setDbusProperty(
1956         asyncResp, "PowerRestorePolicy", "xyz.openbmc_project.Settings",
1957         sdbusplus::message::object_path(
1958             "/xyz/openbmc_project/control/host0/power_restore_policy"),
1959         "xyz.openbmc_project.Control.Power.RestorePolicy", "PowerRestorePolicy",
1960         powerRestorePolicy);
1961 }
1962 
1963 /**
1964  * @brief Retrieves provisioning status
1965  *
1966  * @param[in] asyncResp     Shared pointer for completing asynchronous
1967  * calls.
1968  *
1969  * @return None.
1970  */
1971 inline void
1972     getProvisioningStatus(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
1973 {
1974     BMCWEB_LOG_DEBUG("Get OEM information.");
1975     sdbusplus::asio::getAllProperties(
1976         *crow::connections::systemBus, "xyz.openbmc_project.PFR.Manager",
1977         "/xyz/openbmc_project/pfr", "xyz.openbmc_project.PFR.Attributes",
1978         [asyncResp](const boost::system::error_code& ec,
1979                     const dbus::utility::DBusPropertiesMap& propertiesList) {
1980             nlohmann::json& oemPFR =
1981                 asyncResp->res
1982                     .jsonValue["Oem"]["OpenBmc"]["FirmwareProvisioning"];
1983             asyncResp->res.jsonValue["Oem"]["OpenBmc"]["@odata.type"] =
1984                 "#OpenBMCComputerSystem.v1_0_0.OpenBmc";
1985             oemPFR["@odata.type"] =
1986                 "#OpenBMCComputerSystem.FirmwareProvisioning";
1987 
1988             if (ec)
1989             {
1990                 BMCWEB_LOG_DEBUG("DBUS response error {}", ec);
1991                 // not an error, don't have to have the interface
1992                 oemPFR["ProvisioningStatus"] = open_bmc_computer_system::
1993                     FirmwareProvisioningStatus::NotProvisioned;
1994                 return;
1995             }
1996 
1997             const bool* provState = nullptr;
1998             const bool* lockState = nullptr;
1999 
2000             const bool success = sdbusplus::unpackPropertiesNoThrow(
2001                 dbus_utils::UnpackErrorPrinter(), propertiesList,
2002                 "UfmProvisioned", provState, "UfmLocked", lockState);
2003 
2004             if (!success)
2005             {
2006                 messages::internalError(asyncResp->res);
2007                 return;
2008             }
2009 
2010             if ((provState == nullptr) || (lockState == nullptr))
2011             {
2012                 BMCWEB_LOG_DEBUG("Unable to get PFR attributes.");
2013                 messages::internalError(asyncResp->res);
2014                 return;
2015             }
2016 
2017             if (*provState)
2018             {
2019                 if (*lockState)
2020                 {
2021                     oemPFR["ProvisioningStatus"] = open_bmc_computer_system::
2022                         FirmwareProvisioningStatus::ProvisionedAndLocked;
2023                 }
2024                 else
2025                 {
2026                     oemPFR["ProvisioningStatus"] = open_bmc_computer_system::
2027                         FirmwareProvisioningStatus::ProvisionedButNotLocked;
2028                 }
2029             }
2030             else
2031             {
2032                 oemPFR["ProvisioningStatus"] = open_bmc_computer_system::
2033                     FirmwareProvisioningStatus::NotProvisioned;
2034             }
2035         });
2036 }
2037 
2038 /**
2039  * @brief Translate the PowerMode string to enum value
2040  *
2041  * @param[in]  modeString PowerMode string to be translated
2042  *
2043  * @return PowerMode enum
2044  */
2045 inline computer_system::PowerMode
2046     translatePowerModeString(const std::string& modeString)
2047 {
2048     using PowerMode = computer_system::PowerMode;
2049 
2050     if (modeString == "xyz.openbmc_project.Control.Power.Mode.PowerMode.Static")
2051     {
2052         return PowerMode::Static;
2053     }
2054     if (modeString ==
2055         "xyz.openbmc_project.Control.Power.Mode.PowerMode.MaximumPerformance")
2056     {
2057         return PowerMode::MaximumPerformance;
2058     }
2059     if (modeString ==
2060         "xyz.openbmc_project.Control.Power.Mode.PowerMode.PowerSaving")
2061     {
2062         return PowerMode::PowerSaving;
2063     }
2064     if (modeString ==
2065         "xyz.openbmc_project.Control.Power.Mode.PowerMode.BalancedPerformance")
2066     {
2067         return PowerMode::BalancedPerformance;
2068     }
2069     if (modeString ==
2070         "xyz.openbmc_project.Control.Power.Mode.PowerMode.EfficiencyFavorPerformance")
2071     {
2072         return PowerMode::EfficiencyFavorPerformance;
2073     }
2074     if (modeString ==
2075         "xyz.openbmc_project.Control.Power.Mode.PowerMode.EfficiencyFavorPower")
2076     {
2077         return PowerMode::EfficiencyFavorPower;
2078     }
2079     if (modeString == "xyz.openbmc_project.Control.Power.Mode.PowerMode.OEM")
2080     {
2081         return PowerMode::OEM;
2082     }
2083     // Any other values would be invalid
2084     BMCWEB_LOG_ERROR("PowerMode value was not valid: {}", modeString);
2085     return PowerMode::Invalid;
2086 }
2087 
2088 inline void
2089     afterGetPowerMode(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
2090                       const boost::system::error_code& ec,
2091                       const dbus::utility::DBusPropertiesMap& properties)
2092 {
2093     if (ec)
2094     {
2095         BMCWEB_LOG_ERROR("DBUS response error on PowerMode GetAll: {}", ec);
2096         messages::internalError(asyncResp->res);
2097         return;
2098     }
2099 
2100     std::string powerMode;
2101     const std::vector<std::string>* allowedModes = nullptr;
2102     const bool success = sdbusplus::unpackPropertiesNoThrow(
2103         dbus_utils::UnpackErrorPrinter(), properties, "PowerMode", powerMode,
2104         "AllowedPowerModes", allowedModes);
2105 
2106     if (!success)
2107     {
2108         messages::internalError(asyncResp->res);
2109         return;
2110     }
2111 
2112     nlohmann::json::array_t modeList;
2113     if (allowedModes == nullptr)
2114     {
2115         modeList.emplace_back("Static");
2116         modeList.emplace_back("MaximumPerformance");
2117         modeList.emplace_back("PowerSaving");
2118     }
2119     else
2120     {
2121         for (const auto& aMode : *allowedModes)
2122         {
2123             computer_system::PowerMode modeValue =
2124                 translatePowerModeString(aMode);
2125             if (modeValue == computer_system::PowerMode::Invalid)
2126             {
2127                 messages::internalError(asyncResp->res);
2128                 continue;
2129             }
2130             modeList.emplace_back(modeValue);
2131         }
2132     }
2133     asyncResp->res.jsonValue["PowerMode@Redfish.AllowableValues"] = modeList;
2134 
2135     BMCWEB_LOG_DEBUG("Current power mode: {}", powerMode);
2136     const computer_system::PowerMode modeValue =
2137         translatePowerModeString(powerMode);
2138     if (modeValue == computer_system::PowerMode::Invalid)
2139     {
2140         messages::internalError(asyncResp->res);
2141         return;
2142     }
2143     asyncResp->res.jsonValue["PowerMode"] = modeValue;
2144 }
2145 /**
2146  * @brief Retrieves system power mode
2147  *
2148  * @param[in] asyncResp  Shared pointer for generating response message.
2149  *
2150  * @return None.
2151  */
2152 inline void getPowerMode(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
2153 {
2154     BMCWEB_LOG_DEBUG("Get power mode.");
2155 
2156     // Get Power Mode object path:
2157     constexpr std::array<std::string_view, 1> interfaces = {
2158         "xyz.openbmc_project.Control.Power.Mode"};
2159     dbus::utility::getSubTree(
2160         "/", 0, interfaces,
2161         [asyncResp](const boost::system::error_code& ec,
2162                     const dbus::utility::MapperGetSubTreeResponse& subtree) {
2163             if (ec)
2164             {
2165                 BMCWEB_LOG_DEBUG(
2166                     "DBUS response error on Power.Mode GetSubTree {}", ec);
2167                 // This is an optional D-Bus object so just return if
2168                 // error occurs
2169                 return;
2170             }
2171             if (subtree.empty())
2172             {
2173                 // As noted above, this is an optional interface so just return
2174                 // if there is no instance found
2175                 return;
2176             }
2177             if (subtree.size() > 1)
2178             {
2179                 // More then one PowerMode object is not supported and is an
2180                 // error
2181                 BMCWEB_LOG_DEBUG(
2182                     "Found more than 1 system D-Bus Power.Mode objects: {}",
2183                     subtree.size());
2184                 messages::internalError(asyncResp->res);
2185                 return;
2186             }
2187             if ((subtree[0].first.empty()) || (subtree[0].second.size() != 1))
2188             {
2189                 BMCWEB_LOG_DEBUG("Power.Mode mapper error!");
2190                 messages::internalError(asyncResp->res);
2191                 return;
2192             }
2193             const std::string& path = subtree[0].first;
2194             const std::string& service = subtree[0].second.begin()->first;
2195             if (service.empty())
2196             {
2197                 BMCWEB_LOG_DEBUG("Power.Mode service mapper error!");
2198                 messages::internalError(asyncResp->res);
2199                 return;
2200             }
2201 
2202             // Valid Power Mode object found, now read the mode properties
2203             sdbusplus::asio::getAllProperties(
2204                 *crow::connections::systemBus, service, path,
2205                 "xyz.openbmc_project.Control.Power.Mode",
2206                 [asyncResp](
2207                     const boost::system::error_code& ec2,
2208                     const dbus::utility::DBusPropertiesMap& properties) {
2209                     afterGetPowerMode(asyncResp, ec2, properties);
2210                 });
2211         });
2212 }
2213 
2214 /**
2215  * @brief Validate the specified mode is valid and return the PowerMode
2216  * name associated with that string
2217  *
2218  * @param[in] asyncResp   Shared pointer for generating response message.
2219  * @param[in] modeValue   String representing the desired PowerMode
2220  *
2221  * @return PowerMode value or empty string if mode is not valid
2222  */
2223 inline std::string
2224     validatePowerMode(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
2225                       const nlohmann::json& modeValue)
2226 {
2227     using PowerMode = computer_system::PowerMode;
2228     std::string mode;
2229 
2230     if (modeValue == PowerMode::Static)
2231     {
2232         mode = "xyz.openbmc_project.Control.Power.Mode.PowerMode.Static";
2233     }
2234     else if (modeValue == PowerMode::MaximumPerformance)
2235     {
2236         mode =
2237             "xyz.openbmc_project.Control.Power.Mode.PowerMode.MaximumPerformance";
2238     }
2239     else if (modeValue == PowerMode::PowerSaving)
2240     {
2241         mode = "xyz.openbmc_project.Control.Power.Mode.PowerMode.PowerSaving";
2242     }
2243     else if (modeValue == PowerMode::BalancedPerformance)
2244     {
2245         mode =
2246             "xyz.openbmc_project.Control.Power.Mode.PowerMode.BalancedPerformance";
2247     }
2248     else if (modeValue == PowerMode::EfficiencyFavorPerformance)
2249     {
2250         mode =
2251             "xyz.openbmc_project.Control.Power.Mode.PowerMode.EfficiencyFavorPerformance";
2252     }
2253     else if (modeValue == PowerMode::EfficiencyFavorPower)
2254     {
2255         mode =
2256             "xyz.openbmc_project.Control.Power.Mode.PowerMode.EfficiencyFavorPower";
2257     }
2258     else
2259     {
2260         messages::propertyValueNotInList(asyncResp->res, modeValue.dump(),
2261                                          "PowerMode");
2262     }
2263     return mode;
2264 }
2265 
2266 /**
2267  * @brief Sets system power mode.
2268  *
2269  * @param[in] asyncResp   Shared pointer for generating response message.
2270  * @param[in] pmode   System power mode from request.
2271  *
2272  * @return None.
2273  */
2274 inline void setPowerMode(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
2275                          const std::string& pmode)
2276 {
2277     BMCWEB_LOG_DEBUG("Set power mode.");
2278 
2279     std::string powerMode = validatePowerMode(asyncResp, pmode);
2280     if (powerMode.empty())
2281     {
2282         return;
2283     }
2284 
2285     // Get Power Mode object path:
2286     constexpr std::array<std::string_view, 1> interfaces = {
2287         "xyz.openbmc_project.Control.Power.Mode"};
2288     dbus::utility::getSubTree(
2289         "/", 0, interfaces,
2290         [asyncResp,
2291          powerMode](const boost::system::error_code& ec,
2292                     const dbus::utility::MapperGetSubTreeResponse& subtree) {
2293             if (ec)
2294             {
2295                 BMCWEB_LOG_ERROR(
2296                     "DBUS response error on Power.Mode GetSubTree {}", ec);
2297                 // This is an optional D-Bus object, but user attempted to patch
2298                 messages::internalError(asyncResp->res);
2299                 return;
2300             }
2301             if (subtree.empty())
2302             {
2303                 // This is an optional D-Bus object, but user attempted to patch
2304                 messages::resourceNotFound(asyncResp->res, "ComputerSystem",
2305                                            "PowerMode");
2306                 return;
2307             }
2308             if (subtree.size() > 1)
2309             {
2310                 // More then one PowerMode object is not supported and is an
2311                 // error
2312                 BMCWEB_LOG_DEBUG(
2313                     "Found more than 1 system D-Bus Power.Mode objects: {}",
2314                     subtree.size());
2315                 messages::internalError(asyncResp->res);
2316                 return;
2317             }
2318             if ((subtree[0].first.empty()) || (subtree[0].second.size() != 1))
2319             {
2320                 BMCWEB_LOG_DEBUG("Power.Mode mapper error!");
2321                 messages::internalError(asyncResp->res);
2322                 return;
2323             }
2324             const std::string& path = subtree[0].first;
2325             const std::string& service = subtree[0].second.begin()->first;
2326             if (service.empty())
2327             {
2328                 BMCWEB_LOG_DEBUG("Power.Mode service mapper error!");
2329                 messages::internalError(asyncResp->res);
2330                 return;
2331             }
2332 
2333             BMCWEB_LOG_DEBUG("Setting power mode({}) -> {}", powerMode, path);
2334 
2335             // Set the Power Mode property
2336             setDbusProperty(asyncResp, "PowerMode", service, path,
2337                             "xyz.openbmc_project.Control.Power.Mode",
2338                             "PowerMode", powerMode);
2339         });
2340 }
2341 
2342 /**
2343  * @brief Translates watchdog timeout action DBUS property value to redfish.
2344  *
2345  * @param[in] dbusAction    The watchdog timeout action in D-BUS.
2346  *
2347  * @return Returns as a string, the timeout action in Redfish terms. If
2348  * translation cannot be done, returns an empty string.
2349  */
2350 inline std::string dbusToRfWatchdogAction(const std::string& dbusAction)
2351 {
2352     if (dbusAction == "xyz.openbmc_project.State.Watchdog.Action.None")
2353     {
2354         return "None";
2355     }
2356     if (dbusAction == "xyz.openbmc_project.State.Watchdog.Action.HardReset")
2357     {
2358         return "ResetSystem";
2359     }
2360     if (dbusAction == "xyz.openbmc_project.State.Watchdog.Action.PowerOff")
2361     {
2362         return "PowerDown";
2363     }
2364     if (dbusAction == "xyz.openbmc_project.State.Watchdog.Action.PowerCycle")
2365     {
2366         return "PowerCycle";
2367     }
2368 
2369     return "";
2370 }
2371 
2372 /**
2373  *@brief Translates timeout action from Redfish to DBUS property value.
2374  *
2375  *@param[in] rfAction The timeout action in Redfish.
2376  *
2377  *@return Returns as a string, the time_out action as expected by DBUS.
2378  *If translation cannot be done, returns an empty string.
2379  */
2380 
2381 inline std::string rfToDbusWDTTimeOutAct(const std::string& rfAction)
2382 {
2383     if (rfAction == "None")
2384     {
2385         return "xyz.openbmc_project.State.Watchdog.Action.None";
2386     }
2387     if (rfAction == "PowerCycle")
2388     {
2389         return "xyz.openbmc_project.State.Watchdog.Action.PowerCycle";
2390     }
2391     if (rfAction == "PowerDown")
2392     {
2393         return "xyz.openbmc_project.State.Watchdog.Action.PowerOff";
2394     }
2395     if (rfAction == "ResetSystem")
2396     {
2397         return "xyz.openbmc_project.State.Watchdog.Action.HardReset";
2398     }
2399 
2400     return "";
2401 }
2402 
2403 /**
2404  * @brief Retrieves host watchdog timer properties over DBUS
2405  *
2406  * @param[in] asyncResp     Shared pointer for completing asynchronous calls.
2407  *
2408  * @return None.
2409  */
2410 inline void
2411     getHostWatchdogTimer(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
2412 {
2413     BMCWEB_LOG_DEBUG("Get host watchodg");
2414     sdbusplus::asio::getAllProperties(
2415         *crow::connections::systemBus, "xyz.openbmc_project.Watchdog",
2416         "/xyz/openbmc_project/watchdog/host0",
2417         "xyz.openbmc_project.State.Watchdog",
2418         [asyncResp](const boost::system::error_code& ec,
2419                     const dbus::utility::DBusPropertiesMap& properties) {
2420             if (ec)
2421             {
2422                 // watchdog service is stopped
2423                 BMCWEB_LOG_DEBUG("DBUS response error {}", ec);
2424                 return;
2425             }
2426 
2427             BMCWEB_LOG_DEBUG("Got {} wdt prop.", properties.size());
2428 
2429             nlohmann::json& hostWatchdogTimer =
2430                 asyncResp->res.jsonValue["HostWatchdogTimer"];
2431 
2432             // watchdog service is running/enabled
2433             hostWatchdogTimer["Status"]["State"] = resource::State::Enabled;
2434 
2435             const bool* enabled = nullptr;
2436             const std::string* expireAction = nullptr;
2437 
2438             const bool success = sdbusplus::unpackPropertiesNoThrow(
2439                 dbus_utils::UnpackErrorPrinter(), properties, "Enabled",
2440                 enabled, "ExpireAction", expireAction);
2441 
2442             if (!success)
2443             {
2444                 messages::internalError(asyncResp->res);
2445                 return;
2446             }
2447 
2448             if (enabled != nullptr)
2449             {
2450                 hostWatchdogTimer["FunctionEnabled"] = *enabled;
2451             }
2452 
2453             if (expireAction != nullptr)
2454             {
2455                 std::string action = dbusToRfWatchdogAction(*expireAction);
2456                 if (action.empty())
2457                 {
2458                     messages::internalError(asyncResp->res);
2459                     return;
2460                 }
2461                 hostWatchdogTimer["TimeoutAction"] = action;
2462             }
2463         });
2464 }
2465 
2466 /**
2467  * @brief Sets Host WatchDog Timer properties.
2468  *
2469  * @param[in] asyncResp  Shared pointer for generating response message.
2470  * @param[in] wdtEnable  The WDTimer Enable value (true/false) from incoming
2471  *                       RF request.
2472  * @param[in] wdtTimeOutAction The WDT Timeout action, from incoming RF request.
2473  *
2474  * @return None.
2475  */
2476 inline void
2477     setWDTProperties(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
2478                      const std::optional<bool> wdtEnable,
2479                      const std::optional<std::string>& wdtTimeOutAction)
2480 {
2481     BMCWEB_LOG_DEBUG("Set host watchdog");
2482 
2483     if (wdtTimeOutAction)
2484     {
2485         std::string wdtTimeOutActStr = rfToDbusWDTTimeOutAct(*wdtTimeOutAction);
2486         // check if TimeOut Action is Valid
2487         if (wdtTimeOutActStr.empty())
2488         {
2489             BMCWEB_LOG_DEBUG("Unsupported value for TimeoutAction: {}",
2490                              *wdtTimeOutAction);
2491             messages::propertyValueNotInList(asyncResp->res, *wdtTimeOutAction,
2492                                              "TimeoutAction");
2493             return;
2494         }
2495 
2496         setDbusProperty(asyncResp, "HostWatchdogTimer/TimeoutAction",
2497                         "xyz.openbmc_project.Watchdog",
2498                         sdbusplus::message::object_path(
2499                             "/xyz/openbmc_project/watchdog/host0"),
2500                         "xyz.openbmc_project.State.Watchdog", "ExpireAction",
2501                         wdtTimeOutActStr);
2502     }
2503 
2504     if (wdtEnable)
2505     {
2506         setDbusProperty(asyncResp, "HostWatchdogTimer/FunctionEnabled",
2507                         "xyz.openbmc_project.Watchdog",
2508                         sdbusplus::message::object_path(
2509                             "/xyz/openbmc_project/watchdog/host0"),
2510                         "xyz.openbmc_project.State.Watchdog", "Enabled",
2511                         *wdtEnable);
2512     }
2513 }
2514 
2515 /**
2516  * @brief Parse the Idle Power Saver properties into json
2517  *
2518  * @param[in] asyncResp   Shared pointer for completing asynchronous calls.
2519  * @param[in] properties  IPS property data from DBus.
2520  *
2521  * @return true if successful
2522  */
2523 inline bool
2524     parseIpsProperties(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
2525                        const dbus::utility::DBusPropertiesMap& properties)
2526 {
2527     const bool* enabled = nullptr;
2528     const uint8_t* enterUtilizationPercent = nullptr;
2529     const uint64_t* enterDwellTime = nullptr;
2530     const uint8_t* exitUtilizationPercent = nullptr;
2531     const uint64_t* exitDwellTime = nullptr;
2532 
2533     const bool success = sdbusplus::unpackPropertiesNoThrow(
2534         dbus_utils::UnpackErrorPrinter(), properties, "Enabled", enabled,
2535         "EnterUtilizationPercent", enterUtilizationPercent, "EnterDwellTime",
2536         enterDwellTime, "ExitUtilizationPercent", exitUtilizationPercent,
2537         "ExitDwellTime", exitDwellTime);
2538 
2539     if (!success)
2540     {
2541         return false;
2542     }
2543 
2544     if (enabled != nullptr)
2545     {
2546         asyncResp->res.jsonValue["IdlePowerSaver"]["Enabled"] = *enabled;
2547     }
2548 
2549     if (enterUtilizationPercent != nullptr)
2550     {
2551         asyncResp->res.jsonValue["IdlePowerSaver"]["EnterUtilizationPercent"] =
2552             *enterUtilizationPercent;
2553     }
2554 
2555     if (enterDwellTime != nullptr)
2556     {
2557         const std::chrono::duration<uint64_t, std::milli> ms(*enterDwellTime);
2558         asyncResp->res.jsonValue["IdlePowerSaver"]["EnterDwellTimeSeconds"] =
2559             std::chrono::duration_cast<std::chrono::duration<uint64_t>>(ms)
2560                 .count();
2561     }
2562 
2563     if (exitUtilizationPercent != nullptr)
2564     {
2565         asyncResp->res.jsonValue["IdlePowerSaver"]["ExitUtilizationPercent"] =
2566             *exitUtilizationPercent;
2567     }
2568 
2569     if (exitDwellTime != nullptr)
2570     {
2571         const std::chrono::duration<uint64_t, std::milli> ms(*exitDwellTime);
2572         asyncResp->res.jsonValue["IdlePowerSaver"]["ExitDwellTimeSeconds"] =
2573             std::chrono::duration_cast<std::chrono::duration<uint64_t>>(ms)
2574                 .count();
2575     }
2576 
2577     return true;
2578 }
2579 
2580 /**
2581  * @brief Retrieves host watchdog timer properties over DBUS
2582  *
2583  * @param[in] asyncResp     Shared pointer for completing asynchronous calls.
2584  *
2585  * @return None.
2586  */
2587 inline void
2588     getIdlePowerSaver(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
2589 {
2590     BMCWEB_LOG_DEBUG("Get idle power saver parameters");
2591 
2592     // Get IdlePowerSaver object path:
2593     constexpr std::array<std::string_view, 1> interfaces = {
2594         "xyz.openbmc_project.Control.Power.IdlePowerSaver"};
2595     dbus::utility::getSubTree(
2596         "/", 0, interfaces,
2597         [asyncResp](const boost::system::error_code& ec,
2598                     const dbus::utility::MapperGetSubTreeResponse& subtree) {
2599             if (ec)
2600             {
2601                 BMCWEB_LOG_ERROR(
2602                     "DBUS response error on Power.IdlePowerSaver GetSubTree {}",
2603                     ec);
2604                 messages::internalError(asyncResp->res);
2605                 return;
2606             }
2607             if (subtree.empty())
2608             {
2609                 // This is an optional interface so just return
2610                 // if there is no instance found
2611                 BMCWEB_LOG_DEBUG("No instances found");
2612                 return;
2613             }
2614             if (subtree.size() > 1)
2615             {
2616                 // More then one PowerIdlePowerSaver object is not supported and
2617                 // is an error
2618                 BMCWEB_LOG_DEBUG("Found more than 1 system D-Bus "
2619                                  "Power.IdlePowerSaver objects: {}",
2620                                  subtree.size());
2621                 messages::internalError(asyncResp->res);
2622                 return;
2623             }
2624             if ((subtree[0].first.empty()) || (subtree[0].second.size() != 1))
2625             {
2626                 BMCWEB_LOG_DEBUG("Power.IdlePowerSaver mapper error!");
2627                 messages::internalError(asyncResp->res);
2628                 return;
2629             }
2630             const std::string& path = subtree[0].first;
2631             const std::string& service = subtree[0].second.begin()->first;
2632             if (service.empty())
2633             {
2634                 BMCWEB_LOG_DEBUG("Power.IdlePowerSaver service mapper error!");
2635                 messages::internalError(asyncResp->res);
2636                 return;
2637             }
2638 
2639             // Valid IdlePowerSaver object found, now read the current values
2640             sdbusplus::asio::getAllProperties(
2641                 *crow::connections::systemBus, service, path,
2642                 "xyz.openbmc_project.Control.Power.IdlePowerSaver",
2643                 [asyncResp](
2644                     const boost::system::error_code& ec2,
2645                     const dbus::utility::DBusPropertiesMap& properties) {
2646                     if (ec2)
2647                     {
2648                         BMCWEB_LOG_ERROR(
2649                             "DBUS response error on IdlePowerSaver GetAll: {}",
2650                             ec2);
2651                         messages::internalError(asyncResp->res);
2652                         return;
2653                     }
2654 
2655                     if (!parseIpsProperties(asyncResp, properties))
2656                     {
2657                         messages::internalError(asyncResp->res);
2658                         return;
2659                     }
2660                 });
2661         });
2662 
2663     BMCWEB_LOG_DEBUG("EXIT: Get idle power saver parameters");
2664 }
2665 
2666 /**
2667  * @brief Sets Idle Power Saver properties.
2668  *
2669  * @param[in] asyncResp  Shared pointer for generating response message.
2670  * @param[in] ipsEnable  The IPS Enable value (true/false) from incoming
2671  *                       RF request.
2672  * @param[in] ipsEnterUtil The utilization limit to enter idle state.
2673  * @param[in] ipsEnterTime The time the utilization must be below ipsEnterUtil
2674  * before entering idle state.
2675  * @param[in] ipsExitUtil The utilization limit when exiting idle state.
2676  * @param[in] ipsExitTime The time the utilization must be above ipsExutUtil
2677  * before exiting idle state
2678  *
2679  * @return None.
2680  */
2681 inline void setIdlePowerSaver(
2682     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
2683     const std::optional<bool> ipsEnable,
2684     const std::optional<uint8_t> ipsEnterUtil,
2685     const std::optional<uint64_t> ipsEnterTime,
2686     const std::optional<uint8_t> ipsExitUtil,
2687     const std::optional<uint64_t> ipsExitTime)
2688 {
2689     BMCWEB_LOG_DEBUG("Set idle power saver properties");
2690 
2691     // Get IdlePowerSaver object path:
2692     constexpr std::array<std::string_view, 1> interfaces = {
2693         "xyz.openbmc_project.Control.Power.IdlePowerSaver"};
2694     dbus::utility::getSubTree(
2695         "/", 0, interfaces,
2696         [asyncResp, ipsEnable, ipsEnterUtil, ipsEnterTime, ipsExitUtil,
2697          ipsExitTime](const boost::system::error_code& ec,
2698                       const dbus::utility::MapperGetSubTreeResponse& subtree) {
2699             if (ec)
2700             {
2701                 BMCWEB_LOG_ERROR(
2702                     "DBUS response error on Power.IdlePowerSaver GetSubTree {}",
2703                     ec);
2704                 messages::internalError(asyncResp->res);
2705                 return;
2706             }
2707             if (subtree.empty())
2708             {
2709                 // This is an optional D-Bus object, but user attempted to patch
2710                 messages::resourceNotFound(asyncResp->res, "ComputerSystem",
2711                                            "IdlePowerSaver");
2712                 return;
2713             }
2714             if (subtree.size() > 1)
2715             {
2716                 // More then one PowerIdlePowerSaver object is not supported and
2717                 // is an error
2718                 BMCWEB_LOG_DEBUG(
2719                     "Found more than 1 system D-Bus Power.IdlePowerSaver objects: {}",
2720                     subtree.size());
2721                 messages::internalError(asyncResp->res);
2722                 return;
2723             }
2724             if ((subtree[0].first.empty()) || (subtree[0].second.size() != 1))
2725             {
2726                 BMCWEB_LOG_DEBUG("Power.IdlePowerSaver mapper error!");
2727                 messages::internalError(asyncResp->res);
2728                 return;
2729             }
2730             const std::string& path = subtree[0].first;
2731             const std::string& service = subtree[0].second.begin()->first;
2732             if (service.empty())
2733             {
2734                 BMCWEB_LOG_DEBUG("Power.IdlePowerSaver service mapper error!");
2735                 messages::internalError(asyncResp->res);
2736                 return;
2737             }
2738 
2739             // Valid Power IdlePowerSaver object found, now set any values that
2740             // need to be updated
2741 
2742             if (ipsEnable)
2743             {
2744                 setDbusProperty(
2745                     asyncResp, "IdlePowerSaver/Enabled", service, path,
2746                     "xyz.openbmc_project.Control.Power.IdlePowerSaver",
2747                     "Enabled", *ipsEnable);
2748             }
2749             if (ipsEnterUtil)
2750             {
2751                 setDbusProperty(
2752                     asyncResp, "IdlePowerSaver/EnterUtilizationPercent",
2753                     service, path,
2754                     "xyz.openbmc_project.Control.Power.IdlePowerSaver",
2755                     "EnterUtilizationPercent", *ipsEnterUtil);
2756             }
2757             if (ipsEnterTime)
2758             {
2759                 // Convert from seconds into milliseconds for DBus
2760                 const uint64_t timeMilliseconds = *ipsEnterTime * 1000;
2761                 setDbusProperty(
2762                     asyncResp, "IdlePowerSaver/EnterDwellTimeSeconds", service,
2763                     path, "xyz.openbmc_project.Control.Power.IdlePowerSaver",
2764                     "EnterDwellTime", timeMilliseconds);
2765             }
2766             if (ipsExitUtil)
2767             {
2768                 setDbusProperty(
2769                     asyncResp, "IdlePowerSaver/ExitUtilizationPercent", service,
2770                     path, "xyz.openbmc_project.Control.Power.IdlePowerSaver",
2771                     "ExitUtilizationPercent", *ipsExitUtil);
2772             }
2773             if (ipsExitTime)
2774             {
2775                 // Convert from seconds into milliseconds for DBus
2776                 const uint64_t timeMilliseconds = *ipsExitTime * 1000;
2777                 setDbusProperty(
2778                     asyncResp, "IdlePowerSaver/ExitDwellTimeSeconds", service,
2779                     path, "xyz.openbmc_project.Control.Power.IdlePowerSaver",
2780                     "ExitDwellTime", timeMilliseconds);
2781             }
2782         });
2783 
2784     BMCWEB_LOG_DEBUG("EXIT: Set idle power saver parameters");
2785 }
2786 
2787 inline void handleComputerSystemCollectionHead(
2788     crow::App& app, const crow::Request& req,
2789     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
2790 {
2791     if (!redfish::setUpRedfishRoute(app, req, asyncResp))
2792     {
2793         return;
2794     }
2795     asyncResp->res.addHeader(
2796         boost::beast::http::field::link,
2797         "</redfish/v1/JsonSchemas/ComputerSystemCollection/ComputerSystemCollection.json>; rel=describedby");
2798 }
2799 
2800 inline void handleComputerSystemCollectionGet(
2801     crow::App& app, const crow::Request& req,
2802     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
2803 {
2804     if (!redfish::setUpRedfishRoute(app, req, asyncResp))
2805     {
2806         return;
2807     }
2808 
2809     asyncResp->res.addHeader(
2810         boost::beast::http::field::link,
2811         "</redfish/v1/JsonSchemas/ComputerSystemCollection.json>; rel=describedby");
2812     asyncResp->res.jsonValue["@odata.type"] =
2813         "#ComputerSystemCollection.ComputerSystemCollection";
2814     asyncResp->res.jsonValue["@odata.id"] = "/redfish/v1/Systems";
2815     asyncResp->res.jsonValue["Name"] = "Computer System Collection";
2816 
2817     nlohmann::json& ifaceArray = asyncResp->res.jsonValue["Members"];
2818     ifaceArray = nlohmann::json::array();
2819     if constexpr (BMCWEB_EXPERIMENTAL_REDFISH_MULTI_COMPUTER_SYSTEM)
2820     {
2821         asyncResp->res.jsonValue["Members@odata.count"] = 0;
2822         // Option currently returns no systems.  TBD
2823         return;
2824     }
2825     asyncResp->res.jsonValue["Members@odata.count"] = 1;
2826     nlohmann::json::object_t system;
2827     system["@odata.id"] = boost::urls::format("/redfish/v1/Systems/{}",
2828                                               BMCWEB_REDFISH_SYSTEM_URI_NAME);
2829     ifaceArray.emplace_back(std::move(system));
2830 
2831     if constexpr (BMCWEB_HYPERVISOR_COMPUTER_SYSTEM)
2832     {
2833         BMCWEB_LOG_DEBUG("Hypervisor is available");
2834         asyncResp->res.jsonValue["Members@odata.count"] = 2;
2835 
2836         nlohmann::json::object_t hypervisor;
2837         hypervisor["@odata.id"] = "/redfish/v1/Systems/hypervisor";
2838         ifaceArray.emplace_back(std::move(hypervisor));
2839     }
2840 }
2841 
2842 /**
2843  * Function transceives data with dbus directly.
2844  */
2845 inline void doNMI(const std::shared_ptr<bmcweb::AsyncResp>& asyncResp)
2846 {
2847     constexpr const char* serviceName = "xyz.openbmc_project.Control.Host.NMI";
2848     constexpr const char* objectPath = "/xyz/openbmc_project/control/host0/nmi";
2849     constexpr const char* interfaceName =
2850         "xyz.openbmc_project.Control.Host.NMI";
2851     constexpr const char* method = "NMI";
2852 
2853     crow::connections::systemBus->async_method_call(
2854         [asyncResp](const boost::system::error_code& ec) {
2855             if (ec)
2856             {
2857                 BMCWEB_LOG_ERROR(" Bad D-Bus request error: {}", ec);
2858                 messages::internalError(asyncResp->res);
2859                 return;
2860             }
2861             messages::success(asyncResp->res);
2862         },
2863         serviceName, objectPath, interfaceName, method);
2864 }
2865 
2866 inline void handleComputerSystemResetActionPost(
2867     crow::App& app, const crow::Request& req,
2868     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
2869     const std::string& systemName)
2870 {
2871     if (!redfish::setUpRedfishRoute(app, req, asyncResp))
2872     {
2873         return;
2874     }
2875 
2876     if constexpr (BMCWEB_HYPERVISOR_COMPUTER_SYSTEM)
2877     {
2878         if (systemName == "hypervisor")
2879         {
2880             handleHypervisorSystemResetPost(req, asyncResp);
2881             return;
2882         }
2883     }
2884 
2885     if (systemName != BMCWEB_REDFISH_SYSTEM_URI_NAME)
2886     {
2887         messages::resourceNotFound(asyncResp->res, "ComputerSystem",
2888                                    systemName);
2889         return;
2890     }
2891     if constexpr (BMCWEB_EXPERIMENTAL_REDFISH_MULTI_COMPUTER_SYSTEM)
2892     {
2893         // Option currently returns no systems.  TBD
2894         messages::resourceNotFound(asyncResp->res, "ComputerSystem",
2895                                    systemName);
2896         return;
2897     }
2898     std::string resetType;
2899     if (!json_util::readJsonAction(req, asyncResp->res, "ResetType", resetType))
2900     {
2901         return;
2902     }
2903 
2904     // Get the command and host vs. chassis
2905     std::string command;
2906     bool hostCommand = true;
2907     if ((resetType == "On") || (resetType == "ForceOn"))
2908     {
2909         command = "xyz.openbmc_project.State.Host.Transition.On";
2910         hostCommand = true;
2911     }
2912     else if (resetType == "ForceOff")
2913     {
2914         command = "xyz.openbmc_project.State.Chassis.Transition.Off";
2915         hostCommand = false;
2916     }
2917     else if (resetType == "ForceRestart")
2918     {
2919         command = "xyz.openbmc_project.State.Host.Transition.ForceWarmReboot";
2920         hostCommand = true;
2921     }
2922     else if (resetType == "GracefulShutdown")
2923     {
2924         command = "xyz.openbmc_project.State.Host.Transition.Off";
2925         hostCommand = true;
2926     }
2927     else if (resetType == "GracefulRestart")
2928     {
2929         command =
2930             "xyz.openbmc_project.State.Host.Transition.GracefulWarmReboot";
2931         hostCommand = true;
2932     }
2933     else if (resetType == "PowerCycle")
2934     {
2935         command = "xyz.openbmc_project.State.Host.Transition.Reboot";
2936         hostCommand = true;
2937     }
2938     else if (resetType == "Nmi")
2939     {
2940         doNMI(asyncResp);
2941         return;
2942     }
2943     else
2944     {
2945         messages::actionParameterUnknown(asyncResp->res, "Reset", resetType);
2946         return;
2947     }
2948     sdbusplus::message::object_path statePath("/xyz/openbmc_project/state");
2949 
2950     if (hostCommand)
2951     {
2952         setDbusProperty(asyncResp, "Reset", "xyz.openbmc_project.State.Host",
2953                         statePath / "host0", "xyz.openbmc_project.State.Host",
2954                         "RequestedHostTransition", command);
2955     }
2956     else
2957     {
2958         setDbusProperty(asyncResp, "Reset", "xyz.openbmc_project.State.Chassis",
2959                         statePath / "chassis0",
2960                         "xyz.openbmc_project.State.Chassis",
2961                         "RequestedPowerTransition", command);
2962     }
2963 }
2964 
2965 inline void handleComputerSystemHead(
2966     App& app, const crow::Request& req,
2967     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
2968     const std::string& /*systemName*/)
2969 {
2970     if (!redfish::setUpRedfishRoute(app, req, asyncResp))
2971     {
2972         return;
2973     }
2974 
2975     asyncResp->res.addHeader(
2976         boost::beast::http::field::link,
2977         "</redfish/v1/JsonSchemas/ComputerSystem/ComputerSystem.json>; rel=describedby");
2978 }
2979 
2980 inline void afterPortRequest(
2981     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
2982     const boost::system::error_code& ec,
2983     const std::vector<std::tuple<std::string, std::string, bool>>& socketData)
2984 {
2985     if (ec)
2986     {
2987         BMCWEB_LOG_ERROR("DBUS response error {}", ec);
2988         messages::internalError(asyncResp->res);
2989         return;
2990     }
2991     for (const auto& data : socketData)
2992     {
2993         const std::string& socketPath = get<0>(data);
2994         const std::string& protocolName = get<1>(data);
2995         bool isProtocolEnabled = get<2>(data);
2996         nlohmann::json& dataJson = asyncResp->res.jsonValue["SerialConsole"];
2997         dataJson[protocolName]["ServiceEnabled"] = isProtocolEnabled;
2998         // need to retrieve port number for
2999         // obmc-console-ssh service
3000         if (protocolName == "SSH")
3001         {
3002             getPortNumber(socketPath, [asyncResp, protocolName](
3003                                           const boost::system::error_code& ec1,
3004                                           int portNumber) {
3005                 if (ec1)
3006                 {
3007                     BMCWEB_LOG_ERROR("DBUS response error {}", ec1);
3008                     messages::internalError(asyncResp->res);
3009                     return;
3010                 }
3011                 nlohmann::json& dataJson1 =
3012                     asyncResp->res.jsonValue["SerialConsole"];
3013                 dataJson1[protocolName]["Port"] = portNumber;
3014             });
3015         }
3016     }
3017 }
3018 
3019 inline void
3020     handleComputerSystemGet(crow::App& app, const crow::Request& req,
3021                             const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
3022                             const std::string& systemName)
3023 {
3024     if (!redfish::setUpRedfishRoute(app, req, asyncResp))
3025     {
3026         return;
3027     }
3028 
3029     if constexpr (BMCWEB_EXPERIMENTAL_REDFISH_MULTI_COMPUTER_SYSTEM)
3030     {
3031         // Option currently returns no systems.  TBD
3032         messages::resourceNotFound(asyncResp->res, "ComputerSystem",
3033                                    systemName);
3034         return;
3035     }
3036 
3037     if constexpr (BMCWEB_HYPERVISOR_COMPUTER_SYSTEM)
3038     {
3039         if (systemName == "hypervisor")
3040         {
3041             handleHypervisorSystemGet(asyncResp);
3042             return;
3043         }
3044     }
3045 
3046     if (systemName != BMCWEB_REDFISH_SYSTEM_URI_NAME)
3047     {
3048         messages::resourceNotFound(asyncResp->res, "ComputerSystem",
3049                                    systemName);
3050         return;
3051     }
3052     asyncResp->res.addHeader(
3053         boost::beast::http::field::link,
3054         "</redfish/v1/JsonSchemas/ComputerSystem/ComputerSystem.json>; rel=describedby");
3055     asyncResp->res.jsonValue["@odata.type"] =
3056         "#ComputerSystem.v1_22_0.ComputerSystem";
3057     asyncResp->res.jsonValue["Name"] = BMCWEB_REDFISH_SYSTEM_URI_NAME;
3058     asyncResp->res.jsonValue["Id"] = BMCWEB_REDFISH_SYSTEM_URI_NAME;
3059     asyncResp->res.jsonValue["SystemType"] =
3060         computer_system::SystemType::Physical;
3061     asyncResp->res.jsonValue["Description"] = "Computer System";
3062     asyncResp->res.jsonValue["ProcessorSummary"]["Count"] = 0;
3063     asyncResp->res.jsonValue["MemorySummary"]["TotalSystemMemoryGiB"] =
3064         double(0);
3065     asyncResp->res.jsonValue["@odata.id"] = boost::urls::format(
3066         "/redfish/v1/Systems/{}", BMCWEB_REDFISH_SYSTEM_URI_NAME);
3067 
3068     asyncResp->res.jsonValue["Processors"]["@odata.id"] = boost::urls::format(
3069         "/redfish/v1/Systems/{}/Processors", BMCWEB_REDFISH_SYSTEM_URI_NAME);
3070     asyncResp->res.jsonValue["Memory"]["@odata.id"] = boost::urls::format(
3071         "/redfish/v1/Systems/{}/Memory", BMCWEB_REDFISH_SYSTEM_URI_NAME);
3072     asyncResp->res.jsonValue["Storage"]["@odata.id"] = boost::urls::format(
3073         "/redfish/v1/Systems/{}/Storage", BMCWEB_REDFISH_SYSTEM_URI_NAME);
3074     asyncResp->res.jsonValue["FabricAdapters"]["@odata.id"] =
3075         boost::urls::format("/redfish/v1/Systems/{}/FabricAdapters",
3076                             BMCWEB_REDFISH_SYSTEM_URI_NAME);
3077 
3078     asyncResp->res.jsonValue["Actions"]["#ComputerSystem.Reset"]["target"] =
3079         boost::urls::format(
3080             "/redfish/v1/Systems/{}/Actions/ComputerSystem.Reset",
3081             BMCWEB_REDFISH_SYSTEM_URI_NAME);
3082     asyncResp->res
3083         .jsonValue["Actions"]["#ComputerSystem.Reset"]["@Redfish.ActionInfo"] =
3084         boost::urls::format("/redfish/v1/Systems/{}/ResetActionInfo",
3085                             BMCWEB_REDFISH_SYSTEM_URI_NAME);
3086 
3087     asyncResp->res.jsonValue["LogServices"]["@odata.id"] = boost::urls::format(
3088         "/redfish/v1/Systems/{}/LogServices", BMCWEB_REDFISH_SYSTEM_URI_NAME);
3089     asyncResp->res.jsonValue["Bios"]["@odata.id"] = boost::urls::format(
3090         "/redfish/v1/Systems/{}/Bios", BMCWEB_REDFISH_SYSTEM_URI_NAME);
3091 
3092     nlohmann::json::array_t managedBy;
3093     nlohmann::json& manager = managedBy.emplace_back();
3094     manager["@odata.id"] = boost::urls::format("/redfish/v1/Managers/{}",
3095                                                BMCWEB_REDFISH_MANAGER_URI_NAME);
3096     asyncResp->res.jsonValue["Links"]["ManagedBy"] = std::move(managedBy);
3097     asyncResp->res.jsonValue["Status"]["Health"] = resource::Health::OK;
3098     asyncResp->res.jsonValue["Status"]["State"] = resource::State::Enabled;
3099 
3100     // Fill in SerialConsole info
3101     asyncResp->res.jsonValue["SerialConsole"]["MaxConcurrentSessions"] = 15;
3102     asyncResp->res.jsonValue["SerialConsole"]["IPMI"]["ServiceEnabled"] = true;
3103 
3104     asyncResp->res.jsonValue["SerialConsole"]["SSH"]["ServiceEnabled"] = true;
3105     asyncResp->res.jsonValue["SerialConsole"]["SSH"]["Port"] = 2200;
3106     asyncResp->res.jsonValue["SerialConsole"]["SSH"]["HotKeySequenceDisplay"] =
3107         "Press ~. to exit console";
3108     getPortStatusAndPath(std::span{protocolToDBusForSystems},
3109                          std::bind_front(afterPortRequest, asyncResp));
3110 
3111     if constexpr (BMCWEB_KVM)
3112     {
3113         // Fill in GraphicalConsole info
3114         asyncResp->res.jsonValue["GraphicalConsole"]["ServiceEnabled"] = true;
3115         asyncResp->res.jsonValue["GraphicalConsole"]["MaxConcurrentSessions"] =
3116             4;
3117         asyncResp->res.jsonValue["GraphicalConsole"]["ConnectTypesSupported"] =
3118             nlohmann::json::array_t({"KVMIP"});
3119     }
3120 
3121     getMainChassisId(
3122         asyncResp, [](const std::string& chassisId,
3123                       const std::shared_ptr<bmcweb::AsyncResp>& aRsp) {
3124             nlohmann::json::array_t chassisArray;
3125             nlohmann::json& chassis = chassisArray.emplace_back();
3126             chassis["@odata.id"] =
3127                 boost::urls::format("/redfish/v1/Chassis/{}", chassisId);
3128             aRsp->res.jsonValue["Links"]["Chassis"] = std::move(chassisArray);
3129         });
3130 
3131     getSystemLocationIndicatorActive(asyncResp);
3132     // TODO (Gunnar): Remove IndicatorLED after enough time has passed
3133     getIndicatorLedState(asyncResp);
3134     getComputerSystem(asyncResp);
3135     getHostState(asyncResp);
3136     getBootProperties(asyncResp);
3137     getBootProgress(asyncResp);
3138     getBootProgressLastStateTime(asyncResp);
3139     pcie_util::getPCIeDeviceList(asyncResp,
3140                                  nlohmann::json::json_pointer("/PCIeDevices"));
3141     getHostWatchdogTimer(asyncResp);
3142     getPowerRestorePolicy(asyncResp);
3143     getStopBootOnFault(asyncResp);
3144     getAutomaticRetryPolicy(asyncResp);
3145     getLastResetTime(asyncResp);
3146     if constexpr (BMCWEB_REDFISH_PROVISIONING_FEATURE)
3147     {
3148         getProvisioningStatus(asyncResp);
3149     }
3150     getTrustedModuleRequiredToBoot(asyncResp);
3151     getPowerMode(asyncResp);
3152     getIdlePowerSaver(asyncResp);
3153 }
3154 
3155 inline void handleComputerSystemPatch(
3156     crow::App& app, const crow::Request& req,
3157     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
3158     const std::string& systemName)
3159 {
3160     if (!redfish::setUpRedfishRoute(app, req, asyncResp))
3161     {
3162         return;
3163     }
3164     if constexpr (BMCWEB_EXPERIMENTAL_REDFISH_MULTI_COMPUTER_SYSTEM)
3165     {
3166         // Option currently returns no systems.  TBD
3167         messages::resourceNotFound(asyncResp->res, "ComputerSystem",
3168                                    systemName);
3169         return;
3170     }
3171     if (systemName != BMCWEB_REDFISH_SYSTEM_URI_NAME)
3172     {
3173         messages::resourceNotFound(asyncResp->res, "ComputerSystem",
3174                                    systemName);
3175         return;
3176     }
3177 
3178     asyncResp->res.addHeader(
3179         boost::beast::http::field::link,
3180         "</redfish/v1/JsonSchemas/ComputerSystem/ComputerSystem.json>; rel=describedby");
3181 
3182     std::optional<bool> locationIndicatorActive;
3183     std::optional<std::string> indicatorLed;
3184     std::optional<std::string> assetTag;
3185     std::optional<std::string> powerRestorePolicy;
3186     std::optional<std::string> powerMode;
3187     std::optional<bool> wdtEnable;
3188     std::optional<std::string> wdtTimeOutAction;
3189     std::optional<std::string> bootSource;
3190     std::optional<std::string> bootType;
3191     std::optional<std::string> bootEnable;
3192     std::optional<std::string> bootAutomaticRetry;
3193     std::optional<uint32_t> bootAutomaticRetryAttempts;
3194     std::optional<bool> bootTrustedModuleRequired;
3195     std::optional<std::string> stopBootOnFault;
3196     std::optional<bool> ipsEnable;
3197     std::optional<uint8_t> ipsEnterUtil;
3198     std::optional<uint64_t> ipsEnterTime;
3199     std::optional<uint8_t> ipsExitUtil;
3200     std::optional<uint64_t> ipsExitTime;
3201 
3202     // clang-format off
3203     if (!json_util::readJsonPatch(
3204             req, asyncResp->res,
3205             "IndicatorLED", indicatorLed,
3206             "LocationIndicatorActive", locationIndicatorActive,
3207             "AssetTag", assetTag,
3208             "PowerRestorePolicy", powerRestorePolicy,
3209             "PowerMode", powerMode,
3210             "HostWatchdogTimer/FunctionEnabled", wdtEnable,
3211             "HostWatchdogTimer/TimeoutAction", wdtTimeOutAction,
3212             "Boot/BootSourceOverrideTarget", bootSource,
3213             "Boot/BootSourceOverrideMode", bootType,
3214             "Boot/BootSourceOverrideEnabled", bootEnable,
3215             "Boot/AutomaticRetryConfig", bootAutomaticRetry,
3216             "Boot/AutomaticRetryAttempts", bootAutomaticRetryAttempts,
3217             "Boot/TrustedModuleRequiredToBoot", bootTrustedModuleRequired,
3218             "Boot/StopBootOnFault", stopBootOnFault,
3219             "IdlePowerSaver/Enabled", ipsEnable,
3220             "IdlePowerSaver/EnterUtilizationPercent", ipsEnterUtil,
3221             "IdlePowerSaver/EnterDwellTimeSeconds", ipsEnterTime,
3222             "IdlePowerSaver/ExitUtilizationPercent", ipsExitUtil,
3223             "IdlePowerSaver/ExitDwellTimeSeconds", ipsExitTime))
3224     {
3225         return;
3226     }
3227     // clang-format on
3228 
3229     asyncResp->res.result(boost::beast::http::status::no_content);
3230 
3231     if (assetTag)
3232     {
3233         setAssetTag(asyncResp, *assetTag);
3234     }
3235 
3236     if (wdtEnable || wdtTimeOutAction)
3237     {
3238         setWDTProperties(asyncResp, wdtEnable, wdtTimeOutAction);
3239     }
3240 
3241     if (bootSource || bootType || bootEnable)
3242     {
3243         setBootProperties(asyncResp, bootSource, bootType, bootEnable);
3244     }
3245     if (bootAutomaticRetry)
3246     {
3247         setAutomaticRetry(asyncResp, *bootAutomaticRetry);
3248     }
3249 
3250     if (bootAutomaticRetryAttempts)
3251     {
3252         setAutomaticRetryAttempts(asyncResp,
3253                                   bootAutomaticRetryAttempts.value());
3254     }
3255 
3256     if (bootTrustedModuleRequired)
3257     {
3258         setTrustedModuleRequiredToBoot(asyncResp, *bootTrustedModuleRequired);
3259     }
3260 
3261     if (stopBootOnFault)
3262     {
3263         setStopBootOnFault(asyncResp, *stopBootOnFault);
3264     }
3265 
3266     if (locationIndicatorActive)
3267     {
3268         setSystemLocationIndicatorActive(asyncResp, *locationIndicatorActive);
3269     }
3270 
3271     // TODO (Gunnar): Remove IndicatorLED after enough time has
3272     // passed
3273     if (indicatorLed)
3274     {
3275         setIndicatorLedState(asyncResp, *indicatorLed);
3276         asyncResp->res.addHeader(boost::beast::http::field::warning,
3277                                  "299 - \"IndicatorLED is deprecated. Use "
3278                                  "LocationIndicatorActive instead.\"");
3279     }
3280 
3281     if (powerRestorePolicy)
3282     {
3283         setPowerRestorePolicy(asyncResp, *powerRestorePolicy);
3284     }
3285 
3286     if (powerMode)
3287     {
3288         setPowerMode(asyncResp, *powerMode);
3289     }
3290 
3291     if (ipsEnable || ipsEnterUtil || ipsEnterTime || ipsExitUtil || ipsExitTime)
3292     {
3293         setIdlePowerSaver(asyncResp, ipsEnable, ipsEnterUtil, ipsEnterTime,
3294                           ipsExitUtil, ipsExitTime);
3295     }
3296 }
3297 
3298 inline void handleSystemCollectionResetActionHead(
3299     crow::App& app, const crow::Request& req,
3300     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
3301     const std::string& /*systemName*/)
3302 {
3303     if (!redfish::setUpRedfishRoute(app, req, asyncResp))
3304     {
3305         return;
3306     }
3307     asyncResp->res.addHeader(
3308         boost::beast::http::field::link,
3309         "</redfish/v1/JsonSchemas/ActionInfo/ActionInfo.json>; rel=describedby");
3310 }
3311 
3312 /**
3313  * @brief Translates allowed host transitions to redfish string
3314  *
3315  * @param[in]  dbusAllowedHostTran The allowed host transition on dbus
3316  * @param[out] allowableValues     The translated host transition(s)
3317  *
3318  * @return Emplaces corresponding Redfish translated value(s) in
3319  * allowableValues. If translation not possible, does nothing to
3320  * allowableValues.
3321  */
3322 inline void
3323     dbusToRfAllowedHostTransitions(const std::string& dbusAllowedHostTran,
3324                                    nlohmann::json::array_t& allowableValues)
3325 {
3326     if (dbusAllowedHostTran == "xyz.openbmc_project.State.Host.Transition.On")
3327     {
3328         allowableValues.emplace_back(resource::ResetType::On);
3329         allowableValues.emplace_back(resource::ResetType::ForceOn);
3330     }
3331     else if (dbusAllowedHostTran ==
3332              "xyz.openbmc_project.State.Host.Transition.Off")
3333     {
3334         allowableValues.emplace_back(resource::ResetType::GracefulShutdown);
3335     }
3336     else if (dbusAllowedHostTran ==
3337              "xyz.openbmc_project.State.Host.Transition.GracefulWarmReboot")
3338     {
3339         allowableValues.emplace_back(resource::ResetType::GracefulRestart);
3340     }
3341     else if (dbusAllowedHostTran ==
3342              "xyz.openbmc_project.State.Host.Transition.ForceWarmReboot")
3343     {
3344         allowableValues.emplace_back(resource::ResetType::ForceRestart);
3345     }
3346     else
3347     {
3348         BMCWEB_LOG_WARNING("Unsupported host tran {}", dbusAllowedHostTran);
3349     }
3350 }
3351 
3352 inline void afterGetAllowedHostTransitions(
3353     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
3354     const boost::system::error_code& ec,
3355     const std::vector<std::string>& allowedHostTransitions)
3356 {
3357     nlohmann::json::array_t allowableValues;
3358 
3359     // Supported on all systems currently
3360     allowableValues.emplace_back(resource::ResetType::ForceOff);
3361     allowableValues.emplace_back(resource::ResetType::PowerCycle);
3362     allowableValues.emplace_back(resource::ResetType::Nmi);
3363 
3364     if (ec)
3365     {
3366         if ((ec.value() ==
3367              boost::system::linux_error::bad_request_descriptor) ||
3368             (ec.value() == boost::asio::error::basic_errors::host_unreachable))
3369         {
3370             // Property not implemented so just return defaults
3371             BMCWEB_LOG_DEBUG("Property not available {}", ec);
3372             allowableValues.emplace_back(resource::ResetType::On);
3373             allowableValues.emplace_back(resource::ResetType::ForceOn);
3374             allowableValues.emplace_back(resource::ResetType::ForceRestart);
3375             allowableValues.emplace_back(resource::ResetType::GracefulRestart);
3376             allowableValues.emplace_back(resource::ResetType::GracefulShutdown);
3377         }
3378         else
3379         {
3380             BMCWEB_LOG_ERROR("DBUS response error {}", ec);
3381             messages::internalError(asyncResp->res);
3382             return;
3383         }
3384     }
3385     else
3386     {
3387         for (const std::string& transition : allowedHostTransitions)
3388         {
3389             BMCWEB_LOG_DEBUG("Found allowed host tran {}", transition);
3390             dbusToRfAllowedHostTransitions(transition, allowableValues);
3391         }
3392     }
3393 
3394     nlohmann::json::object_t parameter;
3395     parameter["Name"] = "ResetType";
3396     parameter["Required"] = true;
3397     parameter["DataType"] = action_info::ParameterTypes::String;
3398     parameter["AllowableValues"] = std::move(allowableValues);
3399     nlohmann::json::array_t parameters;
3400     parameters.emplace_back(std::move(parameter));
3401     asyncResp->res.jsonValue["Parameters"] = std::move(parameters);
3402 }
3403 
3404 inline void handleSystemCollectionResetActionGet(
3405     crow::App& app, const crow::Request& req,
3406     const std::shared_ptr<bmcweb::AsyncResp>& asyncResp,
3407     const std::string& systemName)
3408 {
3409     if (!redfish::setUpRedfishRoute(app, req, asyncResp))
3410     {
3411         return;
3412     }
3413     if constexpr (BMCWEB_EXPERIMENTAL_REDFISH_MULTI_COMPUTER_SYSTEM)
3414     {
3415         // Option currently returns no systems.  TBD
3416         messages::resourceNotFound(asyncResp->res, "ComputerSystem",
3417                                    systemName);
3418         return;
3419     }
3420 
3421     if constexpr (BMCWEB_HYPERVISOR_COMPUTER_SYSTEM)
3422     {
3423         if (systemName == "hypervisor")
3424         {
3425             handleHypervisorResetActionGet(asyncResp);
3426             return;
3427         }
3428     }
3429 
3430     if (systemName != BMCWEB_REDFISH_SYSTEM_URI_NAME)
3431     {
3432         messages::resourceNotFound(asyncResp->res, "ComputerSystem",
3433                                    systemName);
3434         return;
3435     }
3436 
3437     asyncResp->res.addHeader(
3438         boost::beast::http::field::link,
3439         "</redfish/v1/JsonSchemas/ActionInfo/ActionInfo.json>; rel=describedby");
3440 
3441     asyncResp->res.jsonValue["@odata.id"] =
3442         boost::urls::format("/redfish/v1/Systems/{}/ResetActionInfo",
3443                             BMCWEB_REDFISH_SYSTEM_URI_NAME);
3444     asyncResp->res.jsonValue["@odata.type"] = "#ActionInfo.v1_1_2.ActionInfo";
3445     asyncResp->res.jsonValue["Name"] = "Reset Action Info";
3446     asyncResp->res.jsonValue["Id"] = "ResetActionInfo";
3447 
3448     // Look to see if system defines AllowedHostTransitions
3449     sdbusplus::asio::getProperty<std::vector<std::string>>(
3450         *crow::connections::systemBus, "xyz.openbmc_project.State.Host",
3451         "/xyz/openbmc_project/state/host0", "xyz.openbmc_project.State.Host",
3452         "AllowedHostTransitions",
3453         [asyncResp](const boost::system::error_code& ec,
3454                     const std::vector<std::string>& allowedHostTransitions) {
3455             afterGetAllowedHostTransitions(asyncResp, ec,
3456                                            allowedHostTransitions);
3457         });
3458 }
3459 /**
3460  * SystemResetActionInfo derived class for delivering Computer Systems
3461  * ResetType AllowableValues using ResetInfo schema.
3462  */
3463 inline void requestRoutesSystems(App& app)
3464 {
3465     BMCWEB_ROUTE(app, "/redfish/v1/Systems/")
3466         .privileges(redfish::privileges::headComputerSystemCollection)
3467         .methods(boost::beast::http::verb::head)(
3468             std::bind_front(handleComputerSystemCollectionHead, std::ref(app)));
3469 
3470     BMCWEB_ROUTE(app, "/redfish/v1/Systems/")
3471         .privileges(redfish::privileges::getComputerSystemCollection)
3472         .methods(boost::beast::http::verb::get)(
3473             std::bind_front(handleComputerSystemCollectionGet, std::ref(app)));
3474 
3475     BMCWEB_ROUTE(app, "/redfish/v1/Systems/<str>/")
3476         .privileges(redfish::privileges::headComputerSystem)
3477         .methods(boost::beast::http::verb::head)(
3478             std::bind_front(handleComputerSystemHead, std::ref(app)));
3479 
3480     BMCWEB_ROUTE(app, "/redfish/v1/Systems/<str>/")
3481         .privileges(redfish::privileges::getComputerSystem)
3482         .methods(boost::beast::http::verb::get)(
3483             std::bind_front(handleComputerSystemGet, std::ref(app)));
3484 
3485     BMCWEB_ROUTE(app, "/redfish/v1/Systems/<str>/")
3486         .privileges(redfish::privileges::patchComputerSystem)
3487         .methods(boost::beast::http::verb::patch)(
3488             std::bind_front(handleComputerSystemPatch, std::ref(app)));
3489 
3490     BMCWEB_ROUTE(app, "/redfish/v1/Systems/<str>/Actions/ComputerSystem.Reset/")
3491         .privileges(redfish::privileges::postComputerSystem)
3492         .methods(boost::beast::http::verb::post)(std::bind_front(
3493             handleComputerSystemResetActionPost, std::ref(app)));
3494 
3495     BMCWEB_ROUTE(app, "/redfish/v1/Systems/<str>/ResetActionInfo/")
3496         .privileges(redfish::privileges::headActionInfo)
3497         .methods(boost::beast::http::verb::head)(std::bind_front(
3498             handleSystemCollectionResetActionHead, std::ref(app)));
3499     BMCWEB_ROUTE(app, "/redfish/v1/Systems/<str>/ResetActionInfo/")
3500         .privileges(redfish::privileges::getActionInfo)
3501         .methods(boost::beast::http::verb::get)(std::bind_front(
3502             handleSystemCollectionResetActionGet, std::ref(app)));
3503 }
3504 } // namespace redfish
3505