Skip to content

Commit

Permalink
peci: Add sysfs interface for PECI bus
Browse files Browse the repository at this point in the history
PECI devices may not be discoverable at the time when PECI controller is
being added (e.g. BMC can boot up when the Host system is still in S5).
Since we currently don't have the capabilities to figure out the Host
system state inside the PECI subsystem itself, we have to rely on
userspace to do it for us.

In the future, PECI subsystem may be expanded with mechanisms that allow
us to avoid depending on userspace interaction (e.g. CPU presence could
be detected using GPIO, and the information on whether it's discoverable
could be obtained over IPMI).
Unfortunately, those methods may ultimately not be available (support
will vary from platform to platform), which means that we still need
platform independent method triggered by userspace.

Acked-by: Joel Stanley <joel@jms.id.au>
Signed-off-by: Iwona Winiarska <iwona.winiarska@intel.com>
Link: https://lore.kernel.org/r/20220208153639.255278-8-iwona.winiarska@intel.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
  • Loading branch information
iklimasz authored and gregkh committed Feb 9, 2022
1 parent 52857e6 commit 42bed52
Show file tree
Hide file tree
Showing 6 changed files with 107 additions and 2 deletions.
16 changes: 16 additions & 0 deletions Documentation/ABI/testing/sysfs-bus-peci
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
What: /sys/bus/peci/rescan
Date: July 2021
KernelVersion: 5.18
Contact: Iwona Winiarska <iwona.winiarska@intel.com>
Description:
Writing a non-zero value to this attribute will
initiate scan for PECI devices on all PECI controllers
in the system.

What: /sys/bus/peci/devices/<controller_id>-<device_addr>/remove
Date: July 2021
KernelVersion: 5.18
Contact: Iwona Winiarska <iwona.winiarska@intel.com>
Description:
Writing a non-zero value to this attribute will
remove the PECI device and any of its children.
2 changes: 1 addition & 1 deletion drivers/peci/Makefile
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# SPDX-License-Identifier: GPL-2.0-only

# Core functionality
peci-y := core.o request.o device.o
peci-y := core.o request.o device.o sysfs.o
obj-$(CONFIG_PECI) += peci.o

# Hardware specific bus drivers
Expand Down
3 changes: 2 additions & 1 deletion drivers/peci/core.c
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ struct device_type peci_controller_type = {
.release = peci_controller_dev_release,
};

static int peci_controller_scan_devices(struct peci_controller *controller)
int peci_controller_scan_devices(struct peci_controller *controller)
{
int ret;
u8 addr;
Expand Down Expand Up @@ -162,6 +162,7 @@ EXPORT_SYMBOL_NS_GPL(devm_peci_controller_add, PECI);

struct bus_type peci_bus_type = {
.name = "peci",
.bus_groups = peci_bus_groups,
};

static int __init peci_init(void)
Expand Down
1 change: 1 addition & 0 deletions drivers/peci/device.c
Original file line number Diff line number Diff line change
Expand Up @@ -116,5 +116,6 @@ static void peci_device_release(struct device *dev)
}

struct device_type peci_device_type = {
.groups = peci_device_groups,
.release = peci_device_release,
};
5 changes: 5 additions & 0 deletions drivers/peci/internal.h
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@
#include <linux/types.h>

struct peci_controller;
struct attribute_group;
struct peci_device;
struct peci_request;

Expand All @@ -19,12 +20,16 @@ struct peci_request *peci_request_alloc(struct peci_device *device, u8 tx_len, u
void peci_request_free(struct peci_request *req);

extern struct device_type peci_device_type;
extern const struct attribute_group *peci_device_groups[];

int peci_device_create(struct peci_controller *controller, u8 addr);
void peci_device_destroy(struct peci_device *device);

extern struct bus_type peci_bus_type;
extern const struct attribute_group *peci_bus_groups[];

extern struct device_type peci_controller_type;

int peci_controller_scan_devices(struct peci_controller *controller);

#endif /* __PECI_INTERNAL_H */
82 changes: 82 additions & 0 deletions drivers/peci/sysfs.c
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
// SPDX-License-Identifier: GPL-2.0-only
// Copyright (c) 2021 Intel Corporation

#include <linux/device.h>
#include <linux/kernel.h>
#include <linux/peci.h>

#include "internal.h"

static int rescan_controller(struct device *dev, void *data)
{
if (dev->type != &peci_controller_type)
return 0;

return peci_controller_scan_devices(to_peci_controller(dev));
}

static ssize_t rescan_store(struct bus_type *bus, const char *buf, size_t count)
{
bool res;
int ret;

ret = kstrtobool(buf, &res);
if (ret)
return ret;

if (!res)
return count;

ret = bus_for_each_dev(&peci_bus_type, NULL, NULL, rescan_controller);
if (ret)
return ret;

return count;
}
static BUS_ATTR_WO(rescan);

static struct attribute *peci_bus_attrs[] = {
&bus_attr_rescan.attr,
NULL
};

static const struct attribute_group peci_bus_group = {
.attrs = peci_bus_attrs,
};

const struct attribute_group *peci_bus_groups[] = {
&peci_bus_group,
NULL
};

static ssize_t remove_store(struct device *dev, struct device_attribute *attr,
const char *buf, size_t count)
{
struct peci_device *device = to_peci_device(dev);
bool res;
int ret;

ret = kstrtobool(buf, &res);
if (ret)
return ret;

if (res && device_remove_file_self(dev, attr))
peci_device_destroy(device);

return count;
}
static DEVICE_ATTR_IGNORE_LOCKDEP(remove, 0200, NULL, remove_store);

static struct attribute *peci_device_attrs[] = {
&dev_attr_remove.attr,
NULL
};

static const struct attribute_group peci_device_group = {
.attrs = peci_device_attrs,
};

const struct attribute_group *peci_device_groups[] = {
&peci_device_group,
NULL
};

0 comments on commit 42bed52

Please sign in to comment.