designs: Add Hardware Fault Monitor design doc

Signed-off-by: Claire Weinan <cweinan@google.com>
Change-Id: I17a15436e316e0d38ef1fad470972d256c03a7b3

OpenBMC-Metrics Report for October and November 2021

Monthly OpenBMC project metrics wiki
https://github.com/openbmc/openbmc/wiki/Project-Metrics

Change-Id: Ice9358a173a2c3891c599468eee40ccd00297d

OpenBMC-Metrics Report for October and November 2021

Monthly OpenBMC project metrics wiki
https://github.com/openbmc/openbmc/wiki/Project-Metrics

Change-Id: Ice9358a173a2c3891c599468eee40ccd00297d7f
Signed-off-by: Reed Frandsen <rfrandse@us.ibm.com>

show more ...

power-recovery: handling of brownout conditions

A brownout condition is when a system has enough power for the BMC but
not the rest of the hardware in the chassis. This design update
addresses how t

power-recovery: handling of brownout conditions

A brownout condition is when a system has enough power for the BMC but
not the rest of the hardware in the chassis. This design update
addresses how the BMC firmware will handle this scenario.

Change-Id: I7173f44e3a605ef317a2165595a43cf8906d7f87
Signed-off-by: Andrew Geissler <geissonator@yahoo.com>

show more ...

power-recovery: bmc and system recovery paths

Provide a mechanism for the power recovery software to not run in
situations where a user has manually intervened to try and recover the
system.

For ex

power-recovery: bmc and system recovery paths

Provide a mechanism for the power recovery software to not run in
situations where a user has manually intervened to try and recover the
system.

For example, if a system is unresponsive and a user manually resets
it in some way (for example via a pin hole reset), then do not run
the power recovery logic. This allows the user to manually work with
the system to debug and not worry about it automatically doing things
on them.

Change-Id: I3bead46df5d7ad4344d47affc066c7e36379e0db
Signed-off-by: Andrew Geissler <geissonator@yahoo.com>

show more ...

TLS-configuration: fix typo

Reported on openbmc/docs#59. Author hasn't moved to Gerrit in over 6
months and it is a trivial change.

Signed-off-by: Patrick Williams <patrick@stwcx.xyz>
Change-Id: I

TLS-configuration: fix typo

Reported on openbmc/docs#59. Author hasn't moved to Gerrit in over 6
months and it is a trivial change.

Signed-off-by: Patrick Williams <patrick@stwcx.xyz>
Change-Id: I0550c7414539d1e305fa309824f83efb7adff54d

show more ...

dbus-sensors: Assert on fault led group if cable is not properly connected

Signed-off-by: Chu Lin <linchuyuan@google.com>
Change-Id: I56b5bf1731b7afba9d6e99f91a20abe2d1502383

Redfish cheatsheet: Add warning about assuming ids

The Redfish spec discusses how a Redfish client should not assume an id.
This document hardcodes ids like ManagerId and ComputerSystemId.
Add appro

Redfish cheatsheet: Add warning about assuming ids

The Redfish spec discusses how a Redfish client should not assume an id.
This document hardcodes ids like ManagerId and ComputerSystemId.
Add appropriate warning.

Tested:
https://github.com/gtmills/docs/blob/fix-up-redfish-cheatsheet/REDFISH-cheatsheet.md

Change-Id: Ib0c8e0f09c98374757ac9377f1d90147cc682849
Signed-off-by: Gunnar Mills <gmills@us.ibm.com>

show more ...

Redfish cheatsheet: Disable IPMI

Change-Id: I5ddaaed4a020af2655e6c45f8a69f562f482a16a
Signed-off-by: Gunnar Mills <gmills@us.ibm.com>

Redfish cheatsheet: Enable NTP and add a Server

Tested: Tested these commands.
Change-Id: I7e8a8d9fe9b56331284becc5e937ee5eac323a3c
Signed-off-by: Gunnar Mills <gmills@us.ibm.com>

Redfish cheatsheet: Add viewing session

Change-Id: I5586e230801824e28368941834c5b193c0c6fff8
Signed-off-by: Gunnar Mills <gmills@us.ibm.com>

Redfish cheatsheet: Add BMC Factory Reset

Change-Id: I54a1c694302230cf97de14f6f96fa676b4035788
Signed-off-by: Gunnar Mills <gmills@us.ibm.com>

Redfish cheatsheet: Add BMC reboot

Change-Id: Ifaf1bcf06ff5d7f993fd96134b9ca8220fb79cf9
Tested: Did a BMC reboot
Signed-off-by: Gunnar Mills <gmills@us.ibm.com>

Redfish cheatsheet: Make BIOS boot control match

Remove $, bullets, and add a horizontal rule to match the other
sections.

Make this section look just like Host power or Firmware update.

Tested: h

Redfish cheatsheet: Make BIOS boot control match

Remove $, bullets, and add a horizontal rule to match the other
sections.

Make this section look just like Host power or Firmware update.

Tested: https://github.com/gtmills/docs/blob/fix-up-redfish-cheatsheet/REDFISH-cheatsheet.md
Change-Id: Ib995ea9a6d22b1804b5d1c1ea30c07d5caebd263
Signed-off-by: Gunnar Mills <gmills@us.ibm.com>

show more ...

Redfish cheatsheet: Fix up ServiceRoot section

Clarify this is the Redfish Service Root.
Redfish in all its documentation intentionally calls this the Service
Root.

From https://redfish.dmtf.org/re

Redfish cheatsheet: Fix up ServiceRoot section

Clarify this is the Redfish Service Root.
Redfish in all its documentation intentionally calls this the Service
Root.

From https://redfish.dmtf.org/redfish/schema_index:
"The ServiceRoot schema describes the root of the Redfish Service,
located at the '/redfish/v1' URI. All other Resources accessible through
the Redfish interface on this device are linked directly or indirectly
from the Service Root."

The Service Root requires no authentication so remove -b.
No where else in this file is a cookie set or used.

Change-Id: I47b87b14c8d118c34889452a3775bf35bbc658fe
Signed-off-by: Gunnar Mills <gmills@us.ibm.com>

show more ...

clang-format: force unix newlines

In order to help avoid dos-style newlines from being introduced to the
codebase, force the clang-format style to use unix-style newlines.

`DeriveLineEnding: fals

clang-format: force unix newlines

In order to help avoid dos-style newlines from being introduced to the
codebase, force the clang-format style to use unix-style newlines.

`DeriveLineEnding: false`:
- This disables automatic newline style detection by clang-format.

`UseCRLF: false`:
- Since detection is disabled, this enforces unix-style (LF).

Also, add a remark in the cpp-style document to codify the expectation
that unix-style newlines are used.

Tested: Apply changes to sdbusplus, run 'unix2dos' on a source file, and
confirm file is reverted to unix-style with 'clang-format'.

Signed-off-by: Patrick Williams <patrick@stwcx.xyz>
Change-Id: Ie8f0cd956a3c52cd14891c06a0b61507f5829aaf

show more ...

Security response team membership guidelines

This better articulates the guidelines for who should be on the
security response team and clarifies that membership is based on
participating organizati

Security response team membership guidelines

This better articulates the guidelines for who should be on the
security response team and clarifies that membership is based on
participating organizations.

Signed-off-by: Joseph Reynolds <joseph-reynolds@charter.net>
Change-Id: Ia331bf1dec4e75b86d448561c82f4096c9a17c12

show more ...

reset-cause: define new pinhole reset gpio

The pinhole reset cause will be utilized by BMC firmware to know
when it has been reset due to a user initiated pinhole reset. This
is commonly done in err

reset-cause: define new pinhole reset gpio

The pinhole reset cause will be utilized by BMC firmware to know
when it has been reset due to a user initiated pinhole reset. This
is commonly done in error scenarios where the BMC is hanging or
otherwise unresponsive.

Initially I put this under the Buttons section but as it's really more
of a reason that a pinhole reset has occurred, I went with a new
section. The BMC is not involved with the actual pinhole reset hardware
because the whole purpose of it is to trigger a BMC reset when the BMC
is unresponsive.

The design doc on this function is at:
https://gerrit.openbmc-project.xyz/c/openbmc/docs/+/47816

Change-Id: I9fb4e5909a279dc588815bb13ff1550c70f867ab
Signed-off-by: Andrew Geissler <geissonator@yahoo.com>

show more ...

device-tree-gpio-naming: Order sections alphabetically

Change-Id: I3066ace0db0222ac9e6c3adc09e50540b2ad4784
Signed-off-by: Andrew Jeffery <andrew@aj.id.au>

power-recovery: auto power on feature

This commit documents what is already in place within OpenBMC with
respect to BMC support for auto power on functions. This document is
being written post-morte

power-recovery: auto power on feature

This commit documents what is already in place within OpenBMC with
respect to BMC support for auto power on functions. This document is
being written post-mortem so that it can be built upon for proposed new
functions in this area.

Change-Id: I0d5dcbb8b4e53aac81cb714df6d863e171f41b45
Signed-off-by: Andrew Geissler <geissonator@yahoo.com>

show more ...

owners: Add Andrew and Joel to gpio-naming.md

To help with reviewing the eventual device tree patches that will flow
from additions to this file, add us as reviewers.

Signed-off-by: Joel Stanley <j

owners: Add Andrew and Joel to gpio-naming.md

To help with reviewing the eventual device tree patches that will flow
from additions to this file, add us as reviewers.

Signed-off-by: Joel Stanley <joel@jms.id.au>
Signed-off-by: Patrick Williams <patrick@stwcx.xyz>
Change-Id: I99c378a54964611a22ab25d0badd29e30d2258cd

show more ...

gpio-naming: grammar: fix plural vs possessive

In English, apostrophes are used to indicate possession or contraction:
- Patrick's commit (possession).
- It's here (contraction of it-is).

T

gpio-naming: grammar: fix plural vs possessive

In English, apostrophes are used to indicate possession or contraction:
- Patrick's commit (possession).
- It's here (contraction of it-is).

Throughout the document there is an intention to describe multiples of
a GPIO (plural), which should grammatically be "GPIOs" and not "GPIO's".

Signed-off-by: Patrick Williams <patrick@stwcx.xyz>
Change-Id: I2f9a221052faa6e3ceead8107a9681553db92a6c

show more ...

gpio-name: document clean up and standardization

Some recent changes have gone against the grain on the initial document
layout. This was done so pin names could have more description
associated wit

gpio-name: document clean up and standardization

Some recent changes have gone against the grain on the initial document
layout. This was done so pin names could have more description
associated with them which makes sense. Change the document to get all
sections back to being consistent and add some descriptive text where needed.

Change-Id: Ib28c02e297cc24bcc01559c8af85f54ae04faf5b
Signed-off-by: Andrew Geissler <geissonator@yahoo.com>

show more ...

CLA: Update links to CCLA and ICLA

The TSC approved new CLAs templates:
https://gerrit.openbmc-project.xyz/c/openbmc/docs/+/43587 that avoid
requiring contributors to divulge sensitive personal info

CLA: Update links to CCLA and ICLA

The TSC approved new CLAs templates:
https://gerrit.openbmc-project.xyz/c/openbmc/docs/+/43587 that avoid
requiring contributors to divulge sensitive personal information.

The old templates were hosted on a GitHub asset server attached to a
comment in openbmc/openbmc#3046. This was a poor choice for a number of
reasons - the main one being it requires a GitHub support ticket to get
the assets taken down.

For the moment, the new templates are hosted in the same Google drive as
the filled out CLAs.

This patch updates any links to the templates in the docs repository.

Change-Id: I846451e56bb0b0d5206e74084c916741535ebb43
Signed-off-by: Brad Bishop <bradleyb@fuzziesquirrel.com>

show more ...

tof: contract: add repository links

Signed-off-by: Patrick Williams <patrick@stwcx.xyz>
Change-Id: Ifb68a4c88f9f1a2a78566a73809ebd3d11c0455b

Design doc for eStoraged

This daemon will serve as an abstraction for an encrypted storage device,
providing a D-Bus interface for storage management.

Signed-off-by: John Wedig <johnwedig@google.co

Design doc for eStoraged

This daemon will serve as an abstraction for an encrypted storage device,
providing a D-Bus interface for storage management.

Signed-off-by: John Wedig <johnwedig@google.com>
Change-Id: Id004e331ed4ce9f72904beefb8d5b0c59cc75169

show more ...