| commit | 90246e26904763be055ea07f5e5e6363ce0c20ac | [log] [tgz] |
|---|---|---|
| author | Patrick Venture <venture@google.com> | Mon Sep 17 17:06:02 2018 -0700 |
| committer | Patrick Venture <venture@google.com> | Mon Sep 17 17:07:15 2018 -0700 |
| tree | 38a8d9236752ec2def46b709cbd6746366847aac | |
| parent | 0dede335cd31592aa7e0299e9b4d40054e5ffd02 [diff] |
main: fixup log message to fixed type By statically casting to a fixed-size type we can ensure the code compiles the same for 64-bit and 32-bit environments (for the most part w.r.t this). Change-Id: If4989c7d3d0879e08be89dfa2a7846cf06dee883 Signed-off-by: Patrick Venture <venture@google.com>
There are and will be a variety of sys specific commands.
The cablecheck command checks whether the BMC is seeing traffic between itself and the host's NIC. Sys specifies which if_name is expected to be connected. The BMC presently only checks traffic on the interface specified. There are now ethernet statistics available over IPMI, which can be checked directly in lieu of this.
Request
| Byte(s) | Value | Data |
|---|---|---|
| 0x00 | 0x00 | Subcommand |
| 0x01 | If_name length | Where you expect the cable, eth0 or eth1, etc |
| 0x02 ... | The name | The string, not null-terminated |
Response
| Byte(s) | Value | Data |
|---|---|---|
| 0x00 | 0x00 | Subcommand |
| 0x01 | 0x00/0x01 | 0 for false, 1 for true |
Any CPLD on the system that can only be read directly via the BMC can have its version exported to Sys via the cpld version command.
Request
| Byte(s) | Value | Data |
|---|---|---|
| 0x00 | 0x01 | Subcommand |
| 0x01 | CPLD ID | A one-byte identifier for the CPLD file to read, unsigned byte. |
Response
| Byte(s) | Value | Data |
|---|---|---|
| 0x00 | 0x01 | Subcommand |
| 0x01 | Major | Major version |
| 0x02 | Minor | Minor Version |
| 0x03 | Sub 1 | Third version number |
| 0x04 | Sub 2 | Fourth version number |
Per the above, if the version number doesn't fit in a byte it'll be cast to size.
The BMC itself must have hard-coded into the image, which ethernet device is connected to the host NIC. This is true also in the mapping of ethernet device to channel number. The channel number is used to configure the ethernet device over IPMI, instead of the interface name. This is because we leverage the current IPMI command set to read and write the networking configuration. Sys can be programmed already to have this information in the board protobuf, however, this information -- can be read from the BMC over IPMI.
Request
| Byte(s) | Value | Data |
|---|---|---|
| 0x00 | 0x02 | Subcommand |
Response
| Byte(s) | Value | Data |
|---|---|---|
| 0x00 | 0x02 | Subcommand |
| 0x01 | Channel number | The IPMI channel number for use with the network configuration commands (such as reading the MAC or IP address of the BMC). |
| 0x02 | if_name length | The length of the if_name in bytes. |
| 0x03... | if_name | The interface name, not null-terminated |
Sys needs to be able to tell the BMC to reset the host but given a delay in seconds.
Request
| Byte(s) | Value | Data |
|---|---|---|
| 0x00 | 0x03 | Subcommand |
| 0x01..0x04 | Seconds to delay (uint32) |
Response
| Byte(s) | Value | Data |
|---|---|---|
| 0x00 | 0x03 | Subcommand |
It's a security requirement that the BMC must be able to persist a setting to disable plaintext console transmission via Nemora. The setting is stored in the BMC read-write filesystem, and Nemorad has a utility class to read and write that setting, which this OEM command uses. The command can be used for read-only as well as a read-then-write to ensure the state of the file.
For now, there is only one Subcommand; the byte is there in case we want to extend this command later.
Request
| Byte(s) | Value | Data |
|---|---|---|
| 0x00 | 0x00 | Subcommand |
| 0x00 | want_to_set | 1 if a set operation is desired; 0 if only reading. |
| 0x01 | desired_value | 1 if plaintext should be allowed; 0 if plaintext should be disallowed; ignored if want_to_set is 0. |
Response
| Byte(s) | Value | Data |
|---|---|---|
| 0x00 | 0x00 | Subcommand |
| 0x00 | Current value | 1 if plaintext is currently allowed; 0 if plaintext is currently disallowed |