| commit | d219fa3c481509e57c99fface2fa8001b579f923 | [log] [tgz] |
|---|---|---|
| author | Naveen Moses <naveen.mosess@hcl.com> | Wed Jul 20 00:01:46 2022 +0530 |
| committer | Naveen Moses <naveen.mosess@hcl.com> | Tue Oct 18 13:12:50 2022 +0000 |
| tree | a6876c5ac0d44025789af6f4a0fada56af823fe8 | |
| parent | 4250785723d92b6578176a2d961d47ab66e08124 [diff] |
Add serial uart mux interface class 1. This change adds the multi-host serial uart mux interface class. In a multi-host system when the host position is changed, then the serial uart mux is configured to enable the respective host's serial console which is accessed via OCP debug card. 2. Introduced two new methods in gpio.cpp setGpioState - set state for gpio fd based on polarity getGpiostate - get state for gpio fd based on polarity 3. Updated the readme file about details on the new gpio configs design : https://github.com/openbmc/docs/blob/master/designs/multihost-phosphor-buttons.md Testing : This change is verified in yosemiteV2 platform. Signed-off-by: Naveen Moses <naveen.mosess@hcl.com> Change-Id: I861d70570650d7dfcab842a35bdcf63a9fdd3bd0
Phosphor-buttons has a collection of IO event handler interfaces for physical inputs which are part of OCP front panel.
It defines an individual dbus interface object for each physical button/switch inputs such as power button, reset button etc. Each of this button interfaces monitors it's associated io for event changes and calls the respective event handlers.
In order to monitor a button/input interface the respective gpio config details should be mentioned in the gpio defs json file - "/etc/default/obmc/gpio/gpio_defs.json"
{
"gpio_definitions": [
{
"name": "POWER_BUTTON",
"gpio_config" :[
{
"pin": "D0",
"direction": "both"
}
]
},
{
"name": "RESET_BUTTON",
"gpio_config" :[
{
"pin": "AB0",
"direction": "both"
}
]
},
{
"name" : "HOST_SELECTOR",
"group_gpio_config" : [
{
"pin": "AA4",
"direction": "both"
},
{
"pin": "AA5",
"direction": "both"
},
{
"pin": "AA6",
"direction": "both"
},
{
"pin": "AA7",
"direction": "both"
}
]
},
}
This config is original config which can be used for configs with only single gpio such as power button,reset button, OCP debug card host select button.
{
"name": "POWER_BUTTON",
"pin": "D0",
"direction": "both"
},
Note: this config is used by most of the other platforms so this format is kept as it is so that existing gpio configs do not get affected.
The following configs are related to multi-host bmc systems more info explained in the design: https://github.com/openbmc/docs/blob/master/designs/multihost-phosphor-buttons.md
The host selector has four gpios associated. So the related gpios are mentioned in a json array named "group_gpio_config".
Example : The value of "7" derived from the 4 host select gpio lines are mapped to host position 1.
{
"name" : "HOST_SELECTOR",
"group_gpio_config" : [
{
"name" : "host_select_0",
"pin": "AA4",
"direction": "both",
"polarity" : "active_high"
},
{
"name" : "host_select_1",
"pin": "AA5",
"direction": "both",
"polarity" : "active_high"
},
{
"name" : "host_select_2",
"pin": "AA6",
"direction": "both",
"polarity" : "active_high"
},
{
"name" : "host_select_3",
"pin": "AA7",
"direction": "both",
"polarity" : "active_high"
}
],
"max_position" : 4,
"host_selector_map" : {
"6" : 0,
"7": 1,
"8": 2,
"9": 3,
"10": 4,
"11": 0,
"12": 1,
"13": 2,
"14" : 3,
"15" : 4
}
},
Similar to host selector there are multiple gpios associated with the serial uart mux. These gpio configs are specificed as part of json array "group_gpio_config".
Here the serial uart mux output is accessed via OCP debug card. SO the OCP debug card present gpio is mentioned part of the group_gpio_config. The debug card present gpio is identified by its name "debug_card_present".
The other gpios part of the group gpio config is serial uart MUX gpio select lines and serial_uart_rx line.
{
"name" : "SERIAL_UART_MUX",
"group_gpio_config" : [
{
"name" : "serial_uart_sel_0",
"pin": "E0",
"direction": "out",
"polarity" : "active_high"
},
{
"name" : "serial_uart_sel_1",
"pin": "E1",
"direction": "out",
"polarity" : "active_high"
},
{
"name" : "serial_uart_sel_2",
"pin": "E2",
"direction": "out",
"polarity" : "active_high"
},
{
"name" : "serial_uart_sel_3",
"pin": "E3",
"direction": "out",
"polarity" : "active_high"
},
{
"name" : "serial_uart_rx",
"pin": "E4",
"direction": "out",
"polarity" : "active_high"
},
{
"name" : "debug_card_present",
"pin": "R3",
"direction": "both",
"polarity" : "active_high"
}
],
"serial_uart_mux_map" : {
"0" : 4,
"1": 0,
"2": 1,
"3": 2,
"4": 3
}
}