With this patch, transport-level utility functions for SCMI pinctrl protocol are added. DM-compliant device drivers, pinctrl and gpio, are added in the following patches.
Signed-off-by: AKASHI Takahiro <takahiro.aka...@linaro.org> --- cmd/scmi.c | 1 + drivers/firmware/scmi/Kconfig | 3 + drivers/firmware/scmi/Makefile | 1 + drivers/firmware/scmi/pinctrl.c | 412 ++++++++++++++++++++ drivers/firmware/scmi/scmi_agent-uclass.c | 11 + include/scmi_agent-uclass.h | 2 + include/scmi_protocols.h | 435 ++++++++++++++++++++++ 7 files changed, 865 insertions(+) create mode 100644 drivers/firmware/scmi/pinctrl.c diff --git a/cmd/scmi.c b/cmd/scmi.c index 5efec8ad87fd..ae7892381e0a 100644 --- a/cmd/scmi.c +++ b/cmd/scmi.c @@ -33,6 +33,7 @@ struct { {SCMI_PROTOCOL_ID_SENSOR, "Sensor management"}, {SCMI_PROTOCOL_ID_RESET_DOMAIN, "Reset domain management"}, {SCMI_PROTOCOL_ID_VOLTAGE_DOMAIN, "Voltage domain management"}, + {SCMI_PROTOCOL_ID_PIN_CONTROL, "Pin control"}, }; /** diff --git a/drivers/firmware/scmi/Kconfig b/drivers/firmware/scmi/Kconfig index 8cf85f0d7a12..e0cb7b70dede 100644 --- a/drivers/firmware/scmi/Kconfig +++ b/drivers/firmware/scmi/Kconfig @@ -41,3 +41,6 @@ config SCMI_AGENT_OPTEE help Enable the SCMI communication channel based on OP-TEE transport for compatible "linaro,scmi-optee". + +config SCMI_PINCTRL + bool diff --git a/drivers/firmware/scmi/Makefile b/drivers/firmware/scmi/Makefile index 1a23d4981709..bf6381332e9e 100644 --- a/drivers/firmware/scmi/Makefile +++ b/drivers/firmware/scmi/Makefile @@ -4,4 +4,5 @@ obj-y += smt.o obj-$(CONFIG_SCMI_AGENT_SMCCC) += smccc_agent.o obj-$(CONFIG_SCMI_AGENT_MAILBOX) += mailbox_agent.o obj-$(CONFIG_SCMI_AGENT_OPTEE) += optee_agent.o +obj-$(CONFIG_SCMI_PINCTRL) += pinctrl.o obj-$(CONFIG_SANDBOX) += sandbox-scmi_agent.o sandbox-scmi_devices.o diff --git a/drivers/firmware/scmi/pinctrl.c b/drivers/firmware/scmi/pinctrl.c new file mode 100644 index 000000000000..88ec57dc3d53 --- /dev/null +++ b/drivers/firmware/scmi/pinctrl.c @@ -0,0 +1,412 @@ +// SPDX-License-Identifier: GPL-2.0+ +/* + * SCMI Pin control protocol as U-Boot device + * + * Copyright (C) 2023 Linaro Limited + * author: AKASHI Takahiro <takahiro.aka...@linaro.org> + */ + +#include <common.h> +#include <dm.h> +#include <malloc.h> +#include <scmi_agent.h> +#include <scmi_protocols.h> +#include <string.h> +#include <asm/types.h> +#include <dm/device_compat.h> +#include <linux/kernel.h> + +/** + * struct scmi_pinctrl_priv - Private data for SCMI Pin control protocol + * @channel: Reference to the SCMI channel to use + */ +struct scmi_pinctrl_priv { + struct scmi_channel *channel; +}; + +int scmi_pinctrl_protocol_attrs(struct udevice *dev, u32 *num_pins, + u32 *num_groups, u32 *num_functions) +{ + struct scmi_pinctrl_protocol_attrs_out out; + struct scmi_msg msg = { + .protocol_id = SCMI_PROTOCOL_ID_PIN_CONTROL, + .message_id = SCMI_PROTOCOL_ATTRIBUTES, + .out_msg = (u8 *)&out, + .out_msg_sz = sizeof(out), + }; + int ret; + + if (!dev || !num_pins || !num_groups || !num_functions) + return -EINVAL; + + ret = devm_scmi_process_msg(dev, &msg); + if (ret) + return ret; + if (out.status) + return scmi_to_linux_errno(out.status); + + *num_groups = SCMI_PINCTRL_ATTRS_NUM_GROUPS(out.attributes_low); + *num_pins = SCMI_PINCTRL_ATTRS_NUM_PINS(out.attributes_low); + *num_functions = SCMI_PINCTRL_ATTRS_NUM_FUNCTIONS(out.attributes_high); + + return 0; +} + +int scmi_pinctrl_attrs(struct udevice *dev, u32 id, u32 flags, + bool *extended_name, u8 **name) +{ + struct scmi_pinctrl_attrs_in in; + struct scmi_pinctrl_attrs_out out; + struct scmi_msg msg = { + .protocol_id = SCMI_PROTOCOL_ID_PIN_CONTROL, + .message_id = SCMI_PINCTRL_ATTRIBUTES, + .in_msg = (u8 *)&in, + .in_msg_sz = sizeof(in), + .out_msg = (u8 *)&out, + .out_msg_sz = sizeof(out), + }; + int ret; + + if (!dev || !extended_name || !name) + return -EINVAL; + + in.id = id; + in.flags = flags; + ret = devm_scmi_process_msg(dev, &msg); + if (ret) + return ret; + if (out.status) + return scmi_to_linux_errno(out.status); + + *extended_name = SCMI_PINCTRL_ATTRS_EXTENDED_NAME(out.attributes); + *name = strdup(out.name); + if (!*name) + return -ENOMEM; + + return 0; +} + +int scmi_pinctrl_list_assocs(struct udevice *dev, u32 id, u32 flags, + u16 **array) +{ + struct scmi_pinctrl_list_assocs_in in; + struct scmi_pinctrl_list_assocs_out out; + struct scmi_msg msg = { + .protocol_id = SCMI_PROTOCOL_ID_PIN_CONTROL, + .message_id = SCMI_PINCTRL_LIST_ASSOCIATIONS, + .in_msg = (u8 *)&in, + .in_msg_sz = sizeof(in), + .out_msg = (u8 *)&out, + .out_msg_sz = sizeof(out), + }; + u32 index; + u16 *buf; + int i, ret; + + if (!dev || !array) + return -EINVAL; + + in.id = id; + in.flags = flags; + + buf = calloc(sizeof(u16), SCMI_PINCTRL_ARRAY_SIZE); + if (!buf) + return -ENOMEM; + + index = 0; + while (1) { + in.index = index; + ret = devm_scmi_process_msg(dev, &msg); + if (ret) + goto err; + if (out.status) { + ret = scmi_to_linux_errno(out.status); + goto err; + } + + for (i = 0; i < SCMI_PINCTRL_LIST_NUM_PINGROUP(out.flags); + i++, index++) + buf[index] = out.array[i]; + + /* realloc should happen only once */ + if (SCMI_PINCTRL_LIST_NUM_REMAINING(out.flags)) { + buf = realloc(buf, sizeof(u16) * + (SCMI_PINCTRL_ARRAY_SIZE + + SCMI_PINCTRL_LIST_NUM_REMAINING(out.flags))); + if (!buf) + return -ENOMEM; + } else { + break; + } + } + + *array = buf; + + return index; +err: + free(buf); + + return ret; +} + +int scmi_pinctrl_config_get(struct udevice *dev, u32 id, bool all_configs, + int selector, unsigned int config_type, + struct scmi_pin_entry **configs) + +{ + struct scmi_pinctrl_config_get_in in; + struct scmi_pinctrl_config_get_out out; + struct scmi_msg msg = { + .protocol_id = SCMI_PROTOCOL_ID_PIN_CONTROL, + .message_id = SCMI_PINCTRL_CONFIG_GET, + .in_msg = (u8 *)&in, + .in_msg_sz = sizeof(in), + .out_msg = (u8 *)&out, + .out_msg_sz = sizeof(out), + }; + struct scmi_pin_entry *entry; + int cur, num, remaining, ret; + + if (!dev) + return -EINVAL; + + if (!all_configs) { + in.id = id; + in.attributes = SCMI_PINCTRL_CONFIG_GET_ATTRS(0, selector, 0, + config_type); + ret = devm_scmi_process_msg(dev, &msg); + if (ret) + return ret; + if (out.status) + return scmi_to_linux_errno(out.status); + + entry = malloc(sizeof(*entry)); + if (!entry) + return -ENOMEM; + + *entry = out.configs[0]; + *configs = entry; + + return 0; + } + + entry = NULL; + cur = 0; + while (1) { + in.id = id; + in.attributes = SCMI_PINCTRL_CONFIG_GET_ATTRS(1, selector, cur, + 0); + ret = devm_scmi_process_msg(dev, &msg); + if (ret) + return ret; + if (out.status) + return scmi_to_linux_errno(out.status); + + num = SCMI_PINCTRL_CONFIG_GET_NUM_RET(out.num_configs); + remaining = SCMI_PINCTRL_CONFIG_GET_REMAINING(out.num_configs); + + if (!entry) + entry = malloc(sizeof(*entry) * (num + remaining)); + if (!entry) + return -ENOMEM; + + memcpy(entry + cur, &out.configs, sizeof(*entry) * num); + + if (!remaining) + break; + + cur += num; + } + + return 0; +} + +int scmi_pinctrl_config_set(struct udevice *dev, u32 id, int selector, + int num_configs, struct scmi_pin_entry *configs) +{ + s32 status; + struct scmi_pinctrl_config_set_in in; + struct scmi_msg msg = { + .protocol_id = SCMI_PROTOCOL_ID_PIN_CONTROL, + .message_id = SCMI_PINCTRL_CONFIG_SET, + .in_msg = (u8 *)&in, + .in_msg_sz = sizeof(in), + .out_msg = (u8 *)&status, + .out_msg_sz = sizeof(status), + }; + int cur, num, ret; + + if (!dev) + return -EINVAL; + + cur = 0; + while (num_configs) { + if (num_configs < SCMI_PINCTRL_CONFIG_ENTRY_MAX) + num = num_configs; + else + num = SCMI_PINCTRL_CONFIG_ENTRY_MAX; + + in.id = id; + in.attributes = SCMI_PINCTRL_CONFIG_SET_ATTRS(num, selector); + memcpy(&in.configs[cur], configs, + sizeof(struct scmi_pin_entry) * num); + ret = devm_scmi_process_msg(dev, &msg); + if (ret) + return ret; + if (status) + return scmi_to_linux_errno(status); + + num_configs -= num; + cur += num; + } + + return 0; +} + +int scmi_pinctrl_function_select(struct udevice *dev, u32 id, u32 function_id, + u32 flags) +{ + s32 status; + struct scmi_pinctrl_function_select_in in; + struct scmi_msg msg = { + .protocol_id = SCMI_PROTOCOL_ID_PIN_CONTROL, + .message_id = SCMI_PINCTRL_FUNCTION_SELECT, + .in_msg = (u8 *)&in, + .in_msg_sz = sizeof(in), + .out_msg = (u8 *)&status, + .out_msg_sz = sizeof(status), + }; + int ret; + + if (!dev) + return -EINVAL; + + in.id = id; + in.function_id = function_id; + in.flags = flags; + ret = devm_scmi_process_msg(dev, &msg); + if (ret) + return ret; + if (status) + return scmi_to_linux_errno(status); + + return 0; +} + +int scmi_pinctrl_request(struct udevice *dev, u32 id, u32 flags) +{ + s32 status; + struct scmi_pinctrl_request_in in; + struct scmi_msg msg = { + .protocol_id = SCMI_PROTOCOL_ID_PIN_CONTROL, + .message_id = SCMI_PINCTRL_REQUEST, + .in_msg = (u8 *)&in, + .in_msg_sz = sizeof(in), + .out_msg = (u8 *)&status, + .out_msg_sz = sizeof(status), + }; + int ret; + + if (!dev) + return -EINVAL; + + in.id = id; + in.flags = flags; + ret = devm_scmi_process_msg(dev, &msg); + if (ret) + return ret; + if (status) + return scmi_to_linux_errno(status); + + return 0; +} + +int scmi_pinctrl_release(struct udevice *dev, u32 id, u32 flags) +{ + s32 status; + struct scmi_pinctrl_release_in in; + struct scmi_msg msg = { + .protocol_id = SCMI_PROTOCOL_ID_PIN_CONTROL, + .message_id = SCMI_PINCTRL_RELEASE, + .in_msg = (u8 *)&in, + .in_msg_sz = sizeof(in), + .out_msg = (u8 *)&status, + .out_msg_sz = sizeof(status), + }; + int ret; + + if (!dev) + return -EINVAL; + + in.id = id; + in.flags = flags; + ret = devm_scmi_process_msg(dev, &msg); + if (ret) + return ret; + if (status) + return scmi_to_linux_errno(status); + + return 0; +} + +int scmi_pinctrl_name_get(struct udevice *dev, u32 id, u32 flags, u8 **name) +{ + struct scmi_pinctrl_name_get_in in; + struct scmi_pinctrl_name_get_out out; + struct scmi_msg msg = { + .protocol_id = SCMI_PROTOCOL_ID_PIN_CONTROL, + .message_id = SCMI_PINCTRL_NAME_GET, + .in_msg = (u8 *)&in, + .in_msg_sz = sizeof(in), + .out_msg = (u8 *)&out, + .out_msg_sz = sizeof(out), + }; + int ret; + + if (!dev || !name) + return -EINVAL; + + in.id = id; + in.flags = flags; + ret = devm_scmi_process_msg(dev, &msg); + if (ret) + return ret; + if (out.status) + return scmi_to_linux_errno(out.status); + + *name = strdup(out.name); + if (!*name) + return -ENOMEM; + + return 0; +} + +int scmi_pinctrl_set_permissions(struct udevice *dev, u32 agent_id, u32 id, + u32 flags) +{ + s32 status; + struct scmi_pinctrl_set_permissions_in in; + struct scmi_msg msg = { + .protocol_id = SCMI_PROTOCOL_ID_PIN_CONTROL, + .message_id = SCMI_PINCTRL_SET_PERMISSIONS, + .in_msg = (u8 *)&in, + .in_msg_sz = sizeof(in), + .out_msg = (u8 *)&status, + .out_msg_sz = sizeof(status), + }; + int ret; + + if (!dev) + return -EINVAL; + + in.agent_id = agent_id; + in.id = id; + in.flags = flags; + ret = devm_scmi_process_msg(dev, &msg); + if (ret) + return ret; + if (status) + return scmi_to_linux_errno(status); + + return 0; +} diff --git a/drivers/firmware/scmi/scmi_agent-uclass.c b/drivers/firmware/scmi/scmi_agent-uclass.c index 79584c00a066..a5953cabbcee 100644 --- a/drivers/firmware/scmi/scmi_agent-uclass.c +++ b/drivers/firmware/scmi/scmi_agent-uclass.c @@ -95,6 +95,9 @@ struct udevice *scmi_get_protocol(struct udevice *dev, case SCMI_PROTOCOL_ID_CLOCK: proto = priv->clock_dev; break; + case SCMI_PROTOCOL_ID_PIN_CONTROL: + proto = priv->pinctrl_dev; + break; case SCMI_PROTOCOL_ID_RESET_DOMAIN: proto = priv->resetdom_dev; break; @@ -142,6 +145,9 @@ static int scmi_add_protocol(struct udevice *dev, case SCMI_PROTOCOL_ID_CLOCK: priv->clock_dev = proto; break; + case SCMI_PROTOCOL_ID_PIN_CONTROL: + priv->pinctrl_dev = proto; + break; case SCMI_PROTOCOL_ID_RESET_DOMAIN: priv->resetdom_dev = proto; break; @@ -414,6 +420,11 @@ static int scmi_bind_protocols(struct udevice *dev) scmi_protocol_is_supported(dev, protocol_id)) drv = DM_DRIVER_GET(scmi_clock); break; + case SCMI_PROTOCOL_ID_PIN_CONTROL: + if (IS_ENABLED(CONFIG_PINCTRL_SCMI) && + scmi_protocol_is_supported(dev, protocol_id)) + drv = DM_DRIVER_GET(scmi_pinctrl); + break; case SCMI_PROTOCOL_ID_RESET_DOMAIN: if (IS_ENABLED(CONFIG_RESET_SCMI) && scmi_protocol_is_supported(dev, protocol_id)) diff --git a/include/scmi_agent-uclass.h b/include/scmi_agent-uclass.h index 6fd6d54d6a5a..993ea81e09c8 100644 --- a/include/scmi_agent-uclass.h +++ b/include/scmi_agent-uclass.h @@ -25,6 +25,7 @@ struct scmi_channel; * @base_dev: SCMI base protocol device * @clock_dev: SCMI clock protocol device * @resetdom_dev: SCMI reset domain protocol device + * @pinctrl_dev: SCMI pin control protocol device * @voltagedom_dev: SCMI voltage domain protocol device */ struct scmi_agent_priv { @@ -40,6 +41,7 @@ struct scmi_agent_priv { struct udevice *base_dev; struct udevice *clock_dev; struct udevice *resetdom_dev; + struct udevice *pinctrl_dev; struct udevice *voltagedom_dev; }; diff --git a/include/scmi_protocols.h b/include/scmi_protocols.h index f41d3f317ce2..699e27e0a84f 100644 --- a/include/scmi_protocols.h +++ b/include/scmi_protocols.h @@ -24,6 +24,7 @@ enum scmi_std_protocol { SCMI_PROTOCOL_ID_SENSOR = 0x15, SCMI_PROTOCOL_ID_RESET_DOMAIN = 0x16, SCMI_PROTOCOL_ID_VOLTAGE_DOMAIN = 0x17, + SCMI_PROTOCOL_ID_PIN_CONTROL = 0x19, }; enum scmi_status_code { @@ -683,4 +684,438 @@ struct scmi_voltd_level_get_out { s32 voltage_level; }; +/* + * SCMI Pin Control Protocol + */ +#define SCMI_PIN_CONTROL_PROTOCOL_VERSION 0x10000 + +enum scmi_pin_control_id { + SCMI_PINCTRL_ATTRIBUTES = 0x3, + SCMI_PINCTRL_LIST_ASSOCIATIONS = 0x4, + SCMI_PINCTRL_CONFIG_GET = 0x5, + SCMI_PINCTRL_CONFIG_SET = 0x6, + SCMI_PINCTRL_FUNCTION_SELECT = 0x7, + SCMI_PINCTRL_REQUEST = 0x8, + SCMI_PINCTRL_RELEASE = 0x9, + SCMI_PINCTRL_NAME_GET = 0xa, + SCMI_PINCTRL_SET_PERMISSIONS = 0xb, +}; + +#define SCMI_PINCTRL_NAME_LENGTH_MAX 16 + +/** + * struct scmi_pinctrl_protocol_attrs_out - Response for PINCTRL's + * PROTOCOL_ATTRIBUTES command + * @status: SCMI command status + * @attributes_low: Protocol attributes (lower bytes) + * @attributes_high: Protocol attributes (higher bytes) + */ +struct scmi_pinctrl_protocol_attrs_out { + s32 status; + u32 attributes_low; + u32 attributes_high; +}; + +#define SCMI_PINCTRL_ATTRS_NUM_GROUPS(attributes_low) \ + (((attributes_low) & GENMASK(31, 16)) >> 16) +#define SCMI_PINCTRL_ATTRS_NUM_PINS(attributes_low) \ + ((attributes_low) & GENMASK(15, 0)) +#define SCMI_PINCTRL_ATTRS_NUM_FUNCTIONS(attributes_high) \ + ((attributes_high) & GENMASK(15, 0)) + +/** + * struct scmi_pinctrl_attrs_in - Message payload for + * SCMI_PINCTRL_ATTRIBUTES command + * @id: Identifier of pin, group or function + * @flags: A set of flags + */ +struct scmi_pinctrl_attrs_in { + u32 id; + u32 flags; +}; + +/** + * struct scmi_pinctrl_attrs_out - Response payload for + * SCMI_PINCTRL_ATTRIBUTES command + * @status: SCMI command status + * @attributes: Attributes of pin, group for function + * @name: Name of pin, group or function + */ +struct scmi_pinctrl_attrs_out { + u32 status; + u32 attributes; + u8 name[SCMI_PINCTRL_NAME_LENGTH_MAX]; +}; + +#define SCMI_PINCTRL_TYPE(flags) ((flags) & GENMASK(1, 0)) +#define SCMI_PINCTRL_TYPE_PIN 0x0 +#define SCMI_PINCTRL_TYPE_GROUP 0x1 +#define SCMI_PINCTRL_TYPE_FUNCTION 0x2 + +#define SCMI_PINCTRL_ATTRS_EXTENDED_NAME(attributes) \ + ((attributes) & BIT(31)) +#define SCMI_PINCTRL_ATTRS_NUM_PINGROUP(attributes) \ + ((attributes) & GENMASK(15, 0)) + +/** + * struct scmi_pinctrl_list_assocs_in - Message payload for + * SCMI_PINCTRL_LIST_ASSOCIATIONS command + * @id: Identifier of group or function + * @flags: A set of flags + * @index: Index of first group to be described + */ +struct scmi_pinctrl_list_assocs_in { + u32 id; + u32 flags; + u32 index; +}; + +#define SCMI_PINCTRL_ARRAY_SIZE 8 + +/** + * struct scmi_pinctrl_list_assocs_out - Response payload for + * SCMI_PINCTRL_LIST_ASSOCIATIONS command + * @status: SCMI command status + * @attributes: A set of flags + * @array: Array of pin or group identifiers + */ +struct scmi_pinctrl_list_assocs_out { + u32 status; + u32 flags; + u16 array[SCMI_PINCTRL_ARRAY_SIZE]; +}; + +#define SCMI_PINCTRL_LIST_NUM_REMAINING(flags) \ + (((flags) & GENMASK(31, 16)) >> 16) +#define SCMI_PINCTRL_LIST_NUM_PINGROUP(flags) \ + ((flags) & GENMASK(11, 0)) + +/* FIXME: depends on transport */ +#define SCMI_PINCTRL_CONFIG_ENTRY_MAX 8 + +struct scmi_pin_entry { + u32 type; + u32 value; +}; + +/** + * struct scmi_pinctrl_config_get_in - Message payload for + * SCMI_PINCTRL_CONFIG_GET command + * @id: Identifier of pin or group + * @attributes: Configuration attributes + */ +struct scmi_pinctrl_config_get_in { + u32 id; + u32 attributes; +}; + +#define SCMI_PINCTRL_CONFIG_GET_ATTRS(all, selector, skip, type) \ + (((all) << 18) | ((selector) << 16) | \ + (((skip) << 8) | (type))) + +#define SCMI_PINCTRL_CONFIG_GET_ALL BIT(18) +#define SCMI_PINCTRL_CONFIG_GET_PINCTRL_TYPE(attributes) \ + (((attributes) & GENMASK(17, 16)) >> 16) +#define SCMI_PINCTRL_CONFIG_GET_SKIP(attributes) \ + (((attributes) & GENMASK(15, 8)) >> 8) +#define SCMI_PINCTRL_CONFIG_GET_TYPE(attributes) \ + ((attributes) & GENMASK(7, 0)) + +/** + * struct scmi_pinctrl_confige_get_out - Response payload for + * SCMI_PINCTRL_CONFIG_GET command + * @status: SCMI command status + * @num_configs: Number of configuration types + * @configs: Values of configuration types + */ +struct scmi_pinctrl_config_get_out { + u32 status; + u32 num_configs; + struct scmi_pin_entry configs[SCMI_PINCTRL_CONFIG_ENTRY_MAX]; +}; + +#define SCMI_PINCTRL_CONFIG_GET_REMAINING(attributes) \ + (((attributes) & GENMASK(31, 24)) >> 24) +#define SCMI_PINCTRL_CONFIG_GET_NUM_RET(attributes) \ + ((attributes) & GENMASK(7, 0)) +#define SCMI_PINCTRL_CONFIG_GET_NUM_CONFIGS(remaining, num) \ + (((remaining) << 24) | (num)) + +#define SCMI_PINCTRL_CONFIG_ID_SHIFT 8 + +#define SCMI_PINCTRL_CONFIG_DEFAULT 0 +#define SCMI_PINCTRL_CONFIG_BIAS_BUS_HOLD 1 +#define SCMI_PINCTRL_CONFIG_BIAS_DISABLE 2 +#define SCMI_PINCTRL_CONFIG_BIAS_HI_IMPEDANCE 3 +#define SCMI_PINCTRL_CONFIG_BIAS_PULL_UP 4 +#define SCMI_PINCTRL_CONFIG_BIAS_PULL_DEF 5 +#define SCMI_PINCTRL_CONFIG_BIAS_PULL_DOWN 6 +#define SCMI_PINCTRL_CONFIG_DRIVE_OPEN_DRAIN 7 +#define SCMI_PINCTRL_CONFIG_DRIVE_OPEN_SOURCE 8 +#define SCMI_PINCTRL_CONFIG_DRIVE_PUSH_PULL 9 +#define SCMI_PINCTRL_CONFIG_DRIVE_STRENGTH 10 +#define SCMI_PINCTRL_CONFIG_INPUT_DEBOUNCE 11 +#define SCMI_PINCTRL_CONFIG_INPUT_MODE 12 +#define SCMI_PINCTRL_CONFIG_PULL_MODE 13 +#define SCMI_PINCTRL_CONFIG_INPUT_VALUE 14 +#define SCMI_PINCTRL_CONFIG_INPUT_SCHMITT 15 +#define SCMI_PINCTRL_CONFIG_LOW_POWER_MODE 16 +#define SCMI_PINCTRL_CONFIG_OUTPUT_MODE 17 +#define SCMI_PINCTRL_CONFIG_OUTPUT_VALUE 18 +#define SCMI_PINCTRL_CONFIG_POWER_SOURCE 19 +#define SCMI_PINCTRL_CONFIG_SLEW_RATE 20 +#define SCMI_PINCTRL_CONFIG_RESERVED 21 +#define SCMI_PINCTRL_CONFIG_OEM 192 + +/** + * struct scmi_pinctrl_config_set_in - Message payload for + * SCMI_PINCTRL_CONFIG_GET command + * @id: Identifier of pin or group + * @attributes: Configuration attributes + * @configs: Values of configuration types + */ +struct scmi_pinctrl_config_set_in { + u32 id; + u32 attributes; + struct scmi_pin_entry configs[SCMI_PINCTRL_CONFIG_ENTRY_MAX]; +}; + +#define SCMI_PINCTRL_CONFIG_SET_ATTRS(num, type) \ + (((num) << 2) | (type)) +#define SCMI_PINCTRL_CONFIG_SET_NUM_CONFIGS(attributes) \ + (((attributes) & GENMASK(9, 2)) >> 2) +#define SCMI_PINCTRL_CONFIG_SET_PINCTRL_TYPE(attributes) \ + ((attributes) & GENMASK(1, 0)) + +/** + * struct scmi_pinctrl_function_select_in - Message payload for + * SCMI_PINCTRL_FUNCTION_SELECT command + * @id: Identifier of pin or group + * @function_id: Identifier of function + * @flags: A set of flags + */ +struct scmi_pinctrl_function_select_in { + u32 id; + u32 function_id; + u32 flags; +}; + +/** + * struct scmi_pinctrl_request_in - Message payload for + * SCMI_PINCTRL_REQUEST command + * @id: Identifier of pin or group + * @flags: A set of flags + */ +struct scmi_pinctrl_request_in { + u32 id; + u32 flags; +}; + +/** + * struct scmi_pinctrl_release_in - Message payload for + * SCMI_PINCTRL_RELEASE command + * @id: Identifier of pin or group + * @flags: A set of flags + */ +struct scmi_pinctrl_release_in { + u32 id; + u32 flags; +}; + +/** + * struct scmi_pinctrl_name_get_in - Message payload for + * SCMI_PINCTRL_NAME_GET command + * @id: Identifier of pin, group or function + * @flags: A set of flags + */ +struct scmi_pinctrl_name_get_in { + u32 id; + u32 flags; +}; + +/** + * struct scmi_pinctrl_name_get_out - Response payload for + * SCMI_PINCTRL_NAME_GET command + * @status: SCMI command status + * @flags: A set of flags (reserved) + * @name: Name in string + */ +struct scmi_pinctrl_name_get_out { + u32 status; + u32 flags; + u8 name[64]; +}; + +/** + * struct scmi_pinctrl_set_permissions_in - Message payload for + * SCMI_PINCTRL_SET_PERMISSIONS command + * @agent_id: Identifier of the agent + * @id: Identifier of pin or group + * @flags: A set of flags + */ +struct scmi_pinctrl_set_permissions_in { + u32 agent_id; + u32 id; + u32 flags; +}; + +#define SCMI_PINCTRL_PERMISSION BIT(2) + +/** + * scmi_pinctrl_protocol_attrs - get attributes of pinctrl protocol + * @dev: SCMI pinctrl device + * @num_pins: A number of pins + * @num_groups: A number of groups + * @num_functions: A number of functions + * + * Get a number of available pins, groups and functions, respectively, + * in @num_pins, @num_groups, @num_functions. + * + * Return: 0 on success, error code otherwise + */ +int scmi_pinctrl_protocol_attrs(struct udevice *dev, u32 *num_pins, + u32 *num_groups, u32 *num_functions); + +/** + * scmi_pinctrl_attrs - get attributes of pin, group or function + * @dev: SCMI pinctrl device + * @id: Identifier of pin, group or function + * @flags: A set of flags + * @extended_name: Bit flag for extended name + * @name: Name of pin, group or function + * + * Get the name of @id in @name. + * @flags can be SCMI_PINCTRL_TYPE_PIN, GROUP or FUNCTION. + * If @id has an extended name, @extended_name is set to true. + * + * Return: 0 on success, error code otherwise + */ +int scmi_pinctrl_attrs(struct udevice *dev, u32 id, u32 flags, + bool *extended_name, u8 **name); + +/** + * scmi_pinctrl_list_assocs - Get a list of pins or groups + * @dev: SCMI pinctrl device + * @id: Identifier of group or function + * @flags: A set of flags + * @array: A pointer to a list of pins, groups or functions + * + * Get a list of pins or groups associated with @id in @array. + * @flags can be SCMI_PINCTRL_TYPE_GROUP or FUNCTION. + * + * Return: 0 on success, error code otherwise + */ +int scmi_pinctrl_list_assocs(struct udevice *dev, u32 id, u32 flags, + u16 **array); + +/** + * scmi_pinctrl_config_get - Get configuration + * @dev: SCMI pinctrl device + * @id: Identifier of pin or group + * @all_configs: Identifier of pin or group + * @selector: Type of id + * @config_type: Type of configuration + * @configs: A pointer to an array of configuration data + * + * If @all_configs is set, get a list of values of all configuration types + * associated with @id in @configs, otherwise get the configuration for + * a specific @config_type. Each configuration data is presented in a form + * of struct scmi_pin_entry. + * @selector can be SCMI_PINCTRL_TYPE_PIN or GROUP. + * + * Return: 0 on success, error code otherwise + */ +int scmi_pinctrl_config_get(struct udevice *dev, u32 id, bool all_configs, + int selector, unsigned int config_type, + struct scmi_pin_entry **configs); + +/** + * scmi_pinctrl_config_set - Set configuration + * @dev: SCMI pinctrl device + * @id: Identifier of pin or group + * @selector: Type of id + * @num_configs: A number of configuration data + * @configs: A pointer to an array of configuration data + * + * Configure a pin or group associated with @id using @configs. + * Each configuration data is presented in a form of struct scmi_pin_entry. + * @selector can be SCMI_PINCTRL_TYPE_PIN or GROUP. + * + * Return: 0 on success, error code otherwise + */ +int scmi_pinctrl_config_set(struct udevice *dev, u32 id, int selector, + int num_configs, struct scmi_pin_entry *configs); + +/** + * scmi_pinctrl_function_select - Select a function + * @dev: SCMI pinctrl device + * @id: Identifier of pin or group + * @function_id: Identifier of function + * @flags: A set of flags + * + * Select a function, @function_id, for a pin or group with @id. + * @flags can be SCMI_PINCTRL_TYPE_PIN or GROUP. + * + * Return: 0 on success, error code otherwise + */ +int scmi_pinctrl_function_select(struct udevice *dev, u32 id, u32 function_id, + u32 flags); + +/** + * scmi_pinctrl_request - Request exclusive control + * @dev: SCMI pinctrl device + * @id: Identifier of pin or group + * @flags: A set of flags + * + * Make a request for exclusive control of pin or group with @id by this agent. + * Once granted, no other agent can access @id until released. + * @flags can be SCMI_PINCTRL_TYPE_PIN or GROUP. + * + * Return: 0 on success, error code otherwise + */ +int scmi_pinctrl_request(struct udevice *dev, u32 id, u32 flags); + +/** + * scmi_pinctrl_release - Release exclusive control + * @dev: SCMI pinctrl device + * @id: Identifier of pin or group + * @flags: A set of flags + * + * Release exclusive control of pin or group with @id by this agent. + * @flags can be SCMI_PINCTRL_TYPE_PIN or GROUP. + * + * Return: 0 on success, error code otherwise + */ +int scmi_pinctrl_release(struct udevice *dev, u32 id, u32 flags); + +/** + * scmi_pinctrl_name_get - Get extended name + * @dev: SCMI pinctrl device + * @id: Identifier of pin, group or function + * @flags: A set of flags + * + * Get an extended name of pin, group or function with @id. + * @flags can be SCMI_PINCTRL_TYPE_PIN, GROUP or FUNCTION. + * + * Return: 0 on success, error code otherwise + */ +int scmi_pinctrl_name_get(struct udevice *dev, u32 id, u32 flags, u8 **name); + +/** + * scmi_pinctrl_set_permissions - Claim access permission + * @dev: SCMI pinctrl device + * @agent_id: Identifier of SCMI agent + * @id: Identifier of pin or group + * @flags: A set of flags + * + * Request to set or deny access permission against @id for the agent + * with @agent_id. + * Bit[2] of @flags indicates "allow access" if set, otherwise "deny access". + * @flags should have SCMI_PINCTRL_TYPE_PIN or GROUP. + * + * Return: 0 on success, error code otherwise + */ +int scmi_pinctrl_set_permissions(struct udevice *dev, u32 agent_id, u32 id, + u32 flags); + #endif /* _SCMI_PROTOCOLS_H */ -- 2.34.1