nvidia-gpio-status-handler

NVIDIA GPIO Status Handler

Build

Environment Setup

OpenBMC SDK Installation Instructions: link

Instead of setting up those manually, run following script inside source code folder will help,

$ sudo scripts/setup_bldenv

NOTE: Cygwin packages need to be installed manually with Cygwin setup utility!

How to build

The general build steps are as below, inside source code folder and run,

$ meson builddir # configure 
$ ninja -C builddir # build
$ ninja -C builddir install # Optional

Project Options are defined as below, any combinations of them are valid,

How to Clean

To clean build cache,

$ ninja -C builddir clean
$ ninja -C builddir uninstall #optional

To completely clean the workspace,

$ rm -rf builddir

Enable Project Options

These commands would work for clean projects. If already configured, refer section

API Stubs

$ meson builddir -Dapi_stubs=enabled
$ ninja -C builddir
$ ninja -C builddir install # Optional

Sandbox Mode

$ meson builddir -Dsandbox_mode=enabled
$ ninja -C builddir
$ ninja -C builddir install # Optional

Debug Log Level

$ meson builddir -Ddebug_log={0,1,2,3,4}
$ ninja -C builddir
$ ninja -C builddir install # Optional

Enable Project Options for Configured Projects

If the project is already configured using,

$ meson builddir

, user can use meson configure to view/edit project options.

The complete list of project options can be accessed,

$ cd builddir
$ meson configure
Project options                Current Value                    Possible Values                  Description
  ---------------                -------------                    ---------------                  -----------
  api_stubs                      auto                             [enabled, disabled, auto]        Manager API stubs enablement
  sandbox_mode                   enabled                          [enabled, disabled, auto]        Sandbox mode enablement

Options can be edited,

$ cd builddir # If not already
$ meson configure -Dapi_stubs=enabled

Debug Logging Level Control

Debug Log Level supports to be configured on both build time and runtime.

There are 5 logging levels supported,

By default, the logging level is 1 - error. To change the default log level before building, e.g. to 3 - debug, in openbmc repo, modify the recipe by changing the following line,

EXTRA_OEMESON += "-Ddebug_log=1"

To change the logging level during runtime, e.g. to 3 - debug, we need to pass following command line argument.

-l <level> 0 - None; 1 - +Error; 2 - +Warning; 3 - +Info

To change the target for log output during runtime, e.g. to /tmp/gsh_debug.log, we need to pass following command line argument.

-L <log_file> where to output the log. Output to screen if the arg not present.