xref: /openbmc/bios-settings-mgr/README.md (revision c65f0a3a)
1Remote BIOS Configuration via BMC Overview Provides ability for the user to view
2and modify the BIOS setup configuration parameters remotely via BMC at any Host
3state. Modifications to the parameters take place upon the next system reboot or
4immediate based on the host firmware. Please refer
5https://github.com/openbmc/docs/blob/master/designs/remote-bios-configuration.md
6
7Remote BIOS Configuration (RBC) service exposes D-Bus methods for BIOS settings
8management operations.
9
10RBC Manager Interface xyz.openbmc_project.BIOSConfig.Manager provides following
11methods, properties.
12
13Object Path : /xyz/openbmc_project/BIOSConfig/Manager
14
15xyz.openbmc_project.BIOSConfig.Manager
16
17methods: SetAttribute -To set the particular BIOS attribute with new value.
18GetAttribute -To get the bios attribute current values and pending values if
19again.
20
21Properties: ResetBIOSSettings - Contain reset BIOS setting type: Interface have
22to set NoAction this property, when Reset BIOS settings are informed to the
23BIOS. BaseBIOSTable - Save the whole BIOS table.
24map{attributeName,struct{attributeType,readonlyStatus,displayname,
25description,menuPath,current,default, array{struct{optionstring,optionvalue}}}}
26Example 1: {"DdrFreqLimit",
27{xyz.openbmc_project.BIOSConfig.Manager.AttributeType.String, false, "Memory
28Operating Speed Selection", "Force specific Memory Operating Speed or use Auto
29setting.", "Advanced/Memory Configuration/Memory Operating Speed Selection",
30"0x00", "0x0B", { {"OneOf", "auto"}, {"OneOf", "2133"}, {"OneOf", "2400"},
31{"OneOf", "2664"}, {"OneOf", "2933"} } } } Example 2: {"BIOSSerialDebugLevel",
32{xyz.openbmc_project.BIOSConfig.Manager.AttributeType.Integer, false, "BIOS
33Serial Debug level", "BIOS Serial Debug level during system boot.",
34"Advanced/Debug Feature Selection", 0x00, 0x01, { {"MinBound", 0}, {"MaxBound",
354}, {"ScalarIncrement",1} } } }
36
37Signals: AttributeChanged - Signal sent out when attribute is changed
38
39PasswordInterface:
40
41xyz.openbmc_project.BIOSConfig.Password provides following Methods and
42Properties.
43
44xyz.openbmc_project.BIOSConfig.Password Interface
45
46Methods: ChangePassword - Change the BIOS setup password.
47
48Properties: PasswordInitialized - To indicate BIOS password related details are
49received or not.
50