€•¿€      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ1/translations/zh_CN/driver-api/gpio/legacy-boards”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/zh_TW/driver-api/gpio/legacy-boards”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/it_IT/driver-api/gpio/legacy-boards”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/ja_JP/driver-api/gpio/legacy-boards”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/ko_KR/driver-api/gpio/legacy-boards”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/pt_BR/driver-api/gpio/legacy-boards”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ1/translations/sp_SP/driver-api/gpio/legacy-boards”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒSupporting Legacy Boards”h]”hŒSupporting Legacy Boards”…””}”(hh¼h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhh·h²hh³ŒK/var/lib/git/docbuild/linux/Documentation/driver-api/gpio/legacy-boards.rst”h´KubhŒ	paragraph”“”)”}”(hX  Many drivers in the kernel, such as ``leds-gpio`` and ``gpio-keys``, are
migrating away from using board-specific ``platform_data`` to a unified device
properties interface. This interface allows drivers to be simpler and more
generic, as they can query properties in a standardized way.”h]”(hŒ$Many drivers in the kernel, such as ”…””}”(hhÍh²hh³Nh´NubhŒliteral”“”)”}”(hŒ``leds-gpio``”h]”hŒ	leds-gpio”…””}”(hh×h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhhÍubhŒ and ”…””}”(hhÍh²hh³Nh´NubhÖ)”}”(hŒ``gpio-keys``”h]”hŒ	gpio-keys”…””}”(hhéh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhhÍubhŒ/, are
migrating away from using board-specific ”…””}”(hhÍh²hh³Nh´NubhÖ)”}”(hŒ``platform_data``”h]”hŒplatform_data”…””}”(hhûh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhhÍubhŒœ to a unified device
properties interface. This interface allows drivers to be simpler and more
generic, as they can query properties in a standardized way.”…””}”(hhÍh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhÌ)”}”(hXb  On modern systems, these properties are provided via device tree. However, some
older platforms have not been converted to device tree and instead rely on
board files to describe their hardware configuration. To bridge this gap and
allow these legacy boards to work with modern, generic drivers, the kernel
provides a mechanism called **software nodes**.”h]”(hXO  On modern systems, these properties are provided via device tree. However, some
older platforms have not been converted to device tree and instead rely on
board files to describe their hardware configuration. To bridge this gap and
allow these legacy boards to work with modern, generic drivers, the kernel
provides a mechanism called ”…””}”(hj  h²hh³Nh´NubhŒstrong”“”)”}”(hŒ**software nodes**”h]”hŒsoftware nodes”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj  ubhŒ.”…””}”(hj  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K	hh·h²hubhÌ)”}”(hŒÈThis document provides a guide on how to convert a legacy board file from using
``platform_data`` and ``gpiod_lookup_table`` to the modern software node
approach for describing GPIO-connected devices.”h]”(hŒPThis document provides a guide on how to convert a legacy board file from using
”…””}”(hj5  h²hh³Nh´NubhÖ)”}”(hŒ``platform_data``”h]”hŒplatform_data”…””}”(hj=  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj5  ubhŒ and ”…””}”(hj5  h²hh³Nh´NubhÖ)”}”(hŒ``gpiod_lookup_table``”h]”hŒgpiod_lookup_table”…””}”(hjO  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj5  ubhŒL to the modern software node
approach for describing GPIO-connected devices.”…””}”(hj5  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubh¶)”}”(hhh]”(h»)”}”(hŒThe Core Idea: Software Nodes”h]”hŒThe Core Idea: Software Nodes”…””}”(hjj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjg  h²hh³hÊh´KubhÌ)”}”(hXœ  Software nodes allow board-specific code to construct an in-memory,
device-tree-like structure using struct software_node and struct
property_entry. This structure can then be associated with a platform device,
allowing drivers to use the standard device properties API (e.g.,
device_property_read_u32(), device_property_read_string()) to query
configuration, just as they would on an ACPI or device tree system.”h]”hXœ  Software nodes allow board-specific code to construct an in-memory,
device-tree-like structure using struct software_node and struct
property_entry. This structure can then be associated with a platform device,
allowing drivers to use the standard device properties API (e.g.,
device_property_read_u32(), device_property_read_string()) to query
configuration, just as they would on an ACPI or device tree system.”…””}”(hjx  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khjg  h²hubhÌ)”}”(hŒÞThe gpiolib code has support for handling software nodes, so that if GPIO is
described properly, as detailed in the section below, then regular gpiolib APIs,
such as gpiod_get(), gpiod_get_optional(), and others will work.”h]”hŒÞThe gpiolib code has support for handling software nodes, so that if GPIO is
described properly, as detailed in the section below, then regular gpiolib APIs,
such as gpiod_get(), gpiod_get_optional(), and others will work.”…””}”(hj†  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khjg  h²hubh¶)”}”(hhh]”(h»)”}”(hŒ Requirements for GPIO Properties”h]”hŒ Requirements for GPIO Properties”…””}”(hj—  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj”  h²hh³hÊh´K"ubhÌ)”}”(hŒ”When using software nodes to describe GPIO connections, the following
requirements must be met for the GPIO core to correctly resolve the reference:”h]”hŒ”When using software nodes to describe GPIO connections, the following
requirements must be met for the GPIO core to correctly resolve the reference:”…””}”(hj¥  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K$hj”  h²hubhŒenumerated_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hX  **The GPIO controller's software node must be registered and attached to
the controller's ``struct device`` either as its primary or secondary
firmware node.** The gpiolib core uses the address of the firmware node to
find the corresponding ``struct gpio_chip`` at runtime.
”h]”hÌ)”}”(hX  **The GPIO controller's software node must be registered and attached to
the controller's ``struct device`` either as its primary or secondary
firmware node.** The gpiolib core uses the address of the firmware node to
find the corresponding ``struct gpio_chip`` at runtime.”h]”(j  )”}”(hŒŸ**The GPIO controller's software node must be registered and attached to
the controller's ``struct device`` either as its primary or secondary
firmware node.**”h]”hŒŸThe GPIO controllerâ€™s software node must be registered and attached to
the controllerâ€™s ``struct device`` either as its primary or secondary
firmware node.”…””}”(hjÂ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj¾  ubhŒR The gpiolib core uses the address of the firmware node to
find the corresponding ”…””}”(hj¾  h²hh³Nh´NubhÖ)”}”(hŒ``struct gpio_chip``”h]”hŒstruct gpio_chip”…””}”(hjÔ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj¾  ubhŒ at runtime.”…””}”(hj¾  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K'hjº  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hjµ  h²hh³hÊh´Nubj¹  )”}”(hŒŒ**The GPIO property must be a reference.** The ``PROPERTY_ENTRY_GPIO()``
macro handles this as it is an alias for ``PROPERTY_ENTRY_REF()``.
”h]”hÌ)”}”(hŒ‹**The GPIO property must be a reference.** The ``PROPERTY_ENTRY_GPIO()``
macro handles this as it is an alias for ``PROPERTY_ENTRY_REF()``.”h]”(j  )”}”(hŒ***The GPIO property must be a reference.**”h]”hŒ&The GPIO property must be a reference.”…””}”(hjú  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hjö  ubhŒ The ”…””}”(hjö  h²hh³Nh´NubhÖ)”}”(hŒ``PROPERTY_ENTRY_GPIO()``”h]”hŒPROPERTY_ENTRY_GPIO()”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhjö  ubhŒ*
macro handles this as it is an alias for ”…””}”(hjö  h²hh³Nh´NubhÖ)”}”(hŒ``PROPERTY_ENTRY_REF()``”h]”hŒPROPERTY_ENTRY_REF()”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhjö  ubhŒ.”…””}”(hjö  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K,hjò  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hjµ  h²hh³hÊh´Nubj¹  )”}”(hŒÕ**The reference must have exactly two arguments:**

- The first argument is the GPIO offset within the controller.
- The second argument is the flags for the GPIO line (e.g.,
  GPIO_ACTIVE_HIGH, GPIO_ACTIVE_LOW).
”h]”(hÌ)”}”(hŒ2**The reference must have exactly two arguments:**”h]”j  )”}”(hjB  h]”hŒ.The reference must have exactly two arguments:”…””}”(hjD  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hj@  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K/hj<  ubhŒbullet_list”“”)”}”(hhh]”(j¹  )”}”(hŒ<The first argument is the GPIO offset within the controller.”h]”hÌ)”}”(hj^  h]”hŒ<The first argument is the GPIO offset within the controller.”…””}”(hj`  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K1hj\  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hjY  ubj¹  )”}”(hŒ^The second argument is the flags for the GPIO line (e.g.,
GPIO_ACTIVE_HIGH, GPIO_ACTIVE_LOW).
”h]”hÌ)”}”(hŒ]The second argument is the flags for the GPIO line (e.g.,
GPIO_ACTIVE_HIGH, GPIO_ACTIVE_LOW).”h]”hŒ]The second argument is the flags for the GPIO line (e.g.,
GPIO_ACTIVE_HIGH, GPIO_ACTIVE_LOW).”…””}”(hjw  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K2hjs  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hjY  ubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1jW  h³hÊh´K1hj<  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j¸  hjµ  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ.”uh1j³  hj”  h²hh³hÊh´K'ubhÌ)”}”(hŒgThe ``PROPERTY_ENTRY_GPIO()`` macro is the preferred way of defining GPIO
properties in software nodes.”h]”(hŒThe ”…””}”(hj¤  h²hh³Nh´NubhÖ)”}”(hŒ``PROPERTY_ENTRY_GPIO()``”h]”hŒPROPERTY_ENTRY_GPIO()”…””}”(hj¬  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj¤  ubhŒJ macro is the preferred way of defining GPIO
properties in software nodes.”…””}”(hj¤  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K5hj”  h²hubeh}”(h]”Œ requirements-for-gpio-properties”ah ]”h"]”Œ requirements for gpio properties”ah$]”h&]”uh1hµhjg  h²hh³hÊh´K"ubeh}”(h]”Œthe-core-idea-software-nodes”ah ]”h"]”Œthe core idea: software nodes”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kubh¶)”}”(hhh]”(h»)”}”(hŒConversion Example”h]”hŒConversion Example”…””}”(hj×  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjÔ  h²hh³hÊh´K9ubhÌ)”}”(hŒiLet's walk through an example of converting a board file that defines a GPIO-
connected LED and a button.”h]”hŒkLetâ€™s walk through an example of converting a board file that defines a GPIO-
connected LED and a button.”…””}”(hjå  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K;hjÔ  h²hubh¶)”}”(hhh]”(h»)”}”(hŒBefore: Using Platform Data”h]”hŒBefore: Using Platform Data”…””}”(hjö  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjó  h²hh³hÊh´K?ubhÌ)”}”(hŒ1A typical legacy board file might look like this:”h]”hŒ1A typical legacy board file might look like this:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KAhjó  h²hubhŒliteral_block”“”)”}”(hXû  #include <linux/platform_device.h>
#include <linux/leds.h>
#include <linux/gpio_keys.h>
#include <linux/gpio/machine.h>

#define MYBOARD_GPIO_CONTROLLER "gpio-foo"

/* LED setup */
static const struct gpio_led myboard_leds[] = {
      {
              .name = "myboard:green:status",
              .default_trigger = "heartbeat",
      },
};

static const struct gpio_led_platform_data myboard_leds_pdata = {
      .num_leds = ARRAY_SIZE(myboard_leds),
      .leds = myboard_leds,
};

static struct gpiod_lookup_table myboard_leds_gpios = {
      .dev_id = "leds-gpio",
      .table = {
              GPIO_LOOKUP_IDX(MYBOARD_GPIO_CONTROLLER, 42, NULL, 0, GPIO_ACTIVE_HIGH),
              { },
      },
};

/* Button setup */
static struct gpio_keys_button myboard_buttons[] = {
      {
              .code = KEY_WPS_BUTTON,
              .desc = "WPS Button",
              .active_low = 1,
      },
};

static const struct gpio_keys_platform_data myboard_buttons_pdata = {
      .buttons = myboard_buttons,
      .nbuttons = ARRAY_SIZE(myboard_buttons),
};

static struct gpiod_lookup_table myboard_buttons_gpios = {
      .dev_id = "gpio-keys",
      .table = {
              GPIO_LOOKUP_IDX(MYBOARD_GPIO_CONTROLLER, 15, NULL, 0, GPIO_ACTIVE_LOW),
              { },
      },
};

/* Device registration */
static int __init myboard_init(void)
{
      struct platform_device_info pdev_info = {
              .name = MYBOARD_GPIO_CONTROLLER,
              .id = PLATFORM_DEVID_NONE,
              .swnode = &gpio_controller_node
      };

      gpiod_add_lookup_table(&myboard_leds_gpios);
      gpiod_add_lookup_table(&myboard_buttons_gpios);

      platform_device_register_full(&pdev_info);
      platform_device_register_data(NULL, "leds-gpio", -1,
                                    &myboard_leds_pdata, sizeof(myboard_leds_pdata));
      platform_device_register_data(NULL, "gpio-keys", -1,
                                    &myboard_buttons_pdata,
                                    sizeof(myboard_buttons_pdata));

      return 0;
}”h]”hXû  #include <linux/platform_device.h>
#include <linux/leds.h>
#include <linux/gpio_keys.h>
#include <linux/gpio/machine.h>

#define MYBOARD_GPIO_CONTROLLER "gpio-foo"

/* LED setup */
static const struct gpio_led myboard_leds[] = {
      {
              .name = "myboard:green:status",
              .default_trigger = "heartbeat",
      },
};

static const struct gpio_led_platform_data myboard_leds_pdata = {
      .num_leds = ARRAY_SIZE(myboard_leds),
      .leds = myboard_leds,
};

static struct gpiod_lookup_table myboard_leds_gpios = {
      .dev_id = "leds-gpio",
      .table = {
              GPIO_LOOKUP_IDX(MYBOARD_GPIO_CONTROLLER, 42, NULL, 0, GPIO_ACTIVE_HIGH),
              { },
      },
};

/* Button setup */
static struct gpio_keys_button myboard_buttons[] = {
      {
              .code = KEY_WPS_BUTTON,
              .desc = "WPS Button",
              .active_low = 1,
      },
};

static const struct gpio_keys_platform_data myboard_buttons_pdata = {
      .buttons = myboard_buttons,
      .nbuttons = ARRAY_SIZE(myboard_buttons),
};

static struct gpiod_lookup_table myboard_buttons_gpios = {
      .dev_id = "gpio-keys",
      .table = {
              GPIO_LOOKUP_IDX(MYBOARD_GPIO_CONTROLLER, 15, NULL, 0, GPIO_ACTIVE_LOW),
              { },
      },
};

/* Device registration */
static int __init myboard_init(void)
{
      struct platform_device_info pdev_info = {
              .name = MYBOARD_GPIO_CONTROLLER,
              .id = PLATFORM_DEVID_NONE,
              .swnode = &gpio_controller_node
      };

      gpiod_add_lookup_table(&myboard_leds_gpios);
      gpiod_add_lookup_table(&myboard_buttons_gpios);

      platform_device_register_full(&pdev_info);
      platform_device_register_data(NULL, "leds-gpio", -1,
                                    &myboard_leds_pdata, sizeof(myboard_leds_pdata));
      platform_device_register_data(NULL, "gpio-keys", -1,
                                    &myboard_buttons_pdata,
                                    sizeof(myboard_buttons_pdata));

      return 0;
}”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”Œforce”‰Œlanguage”Œc”Œhighlight_args”}”uh1j  h³hÊh´KChjó  h²hubeh}”(h]”Œbefore-using-platform-data”ah ]”h"]”Œbefore: using platform data”ah$]”h&]”uh1hµhjÔ  h²hh³hÊh´K?ubh¶)”}”(hhh]”(h»)”}”(hŒAfter: Using Software Nodes”h]”hŒAfter: Using Software Nodes”…””}”(hj4  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj1  h²hh³hÊh´KŽubhÌ)”}”(hŒIHere is how the same configuration can be expressed using software nodes.”h]”hŒIHere is how the same configuration can be expressed using software nodes.”…””}”(hjB  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khj1  h²hubh¶)”}”(hhh]”(h»)”}”(hŒ'Step 1: Define the GPIO Controller Node”h]”hŒ'Step 1: Define the GPIO Controller Node”…””}”(hjS  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjP  h²hh³hÊh´K“ubhÌ)”}”(hŒ”First, define a software node that represents the GPIO controller that the
LEDs and buttons are connected to. The ``name`` of this node is optional.”h]”(hŒrFirst, define a software node that represents the GPIO controller that the
LEDs and buttons are connected to. The ”…””}”(hja  h²hh³Nh´NubhÖ)”}”(hŒ``name``”h]”hŒname”…””}”(hji  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhja  ubhŒ of this node is optional.”…””}”(hja  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K•hjP  h²hubj  )”}”(hŒÖ#include <linux/property.h>
#include <linux/gpio/property.h>

#define MYBOARD_GPIO_CONTROLLER "gpio-foo"

static const struct software_node myboard_gpio_controller_node = {
      .name = MYBOARD_GPIO_CONTROLLER,
};”h]”hŒÖ#include <linux/property.h>
#include <linux/gpio/property.h>

#define MYBOARD_GPIO_CONTROLLER "gpio-foo"

static const struct software_node myboard_gpio_controller_node = {
      .name = MYBOARD_GPIO_CONTROLLER,
};”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”j"  j#  j$  ‰j%  j&  j'  }”uh1j  h³hÊh´K˜hjP  h²hubeh}”(h]”Œ&step-1-define-the-gpio-controller-node”ah ]”h"]”Œ'step 1: define the gpio controller node”ah$]”h&]”uh1hµhj1  h²hh³hÊh´K“ubh¶)”}”(hhh]”(h»)”}”(hŒ3Step 2: Define Consumer Device Nodes and Properties”h]”hŒ3Step 2: Define Consumer Device Nodes and Properties”…””}”(hj›  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj˜  h²hh³hÊh´K¤ubhÌ)”}”(hŒ½Next, define the software nodes for the consumer devices (the LEDs and buttons).
This involves creating a parent node for each device type and child nodes for
each individual LED or button.”h]”hŒ½Next, define the software nodes for the consumer devices (the LEDs and buttons).
This involves creating a parent node for each device type and child nodes for
each individual LED or button.”…””}”(hj©  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¦hj˜  h²hubj  )”}”(hXw  /* LED setup */
static const struct software_node myboard_leds_node = {
      .name = "myboard-leds",
};

static const struct property_entry myboard_status_led_props[] = {
      PROPERTY_ENTRY_STRING("label", "myboard:green:status"),
      PROPERTY_ENTRY_STRING("linux,default-trigger", "heartbeat"),
      PROPERTY_ENTRY_GPIO("gpios", &myboard_gpio_controller_node, 42, GPIO_ACTIVE_HIGH),
      { }
};

static const struct software_node myboard_status_led_swnode = {
      .name = "status-led",
      .parent = &myboard_leds_node,
      .properties = myboard_status_led_props,
};

/* Button setup */
static const struct software_node myboard_keys_node = {
      .name = "myboard-keys",
};

static const struct property_entry myboard_wps_button_props[] = {
      PROPERTY_ENTRY_STRING("label", "WPS Button"),
      PROPERTY_ENTRY_U32("linux,code", KEY_WPS_BUTTON),
      PROPERTY_ENTRY_GPIO("gpios", &myboard_gpio_controller_node, 15, GPIO_ACTIVE_LOW),
      { }
};

static const struct software_node myboard_wps_button_swnode = {
      .name = "wps-button",
      .parent = &myboard_keys_node,
      .properties = myboard_wps_button_props,
};”h]”hXw  /* LED setup */
static const struct software_node myboard_leds_node = {
      .name = "myboard-leds",
};

static const struct property_entry myboard_status_led_props[] = {
      PROPERTY_ENTRY_STRING("label", "myboard:green:status"),
      PROPERTY_ENTRY_STRING("linux,default-trigger", "heartbeat"),
      PROPERTY_ENTRY_GPIO("gpios", &myboard_gpio_controller_node, 42, GPIO_ACTIVE_HIGH),
      { }
};

static const struct software_node myboard_status_led_swnode = {
      .name = "status-led",
      .parent = &myboard_leds_node,
      .properties = myboard_status_led_props,
};

/* Button setup */
static const struct software_node myboard_keys_node = {
      .name = "myboard-keys",
};

static const struct property_entry myboard_wps_button_props[] = {
      PROPERTY_ENTRY_STRING("label", "WPS Button"),
      PROPERTY_ENTRY_U32("linux,code", KEY_WPS_BUTTON),
      PROPERTY_ENTRY_GPIO("gpios", &myboard_gpio_controller_node, 15, GPIO_ACTIVE_LOW),
      { }
};

static const struct software_node myboard_wps_button_swnode = {
      .name = "wps-button",
      .parent = &myboard_keys_node,
      .properties = myboard_wps_button_props,
};”…””}”hj·  sbah}”(h]”h ]”h"]”h$]”h&]”j"  j#  j$  ‰j%  j&  j'  }”uh1j  h³hÊh´Kªhj˜  h²hubeh}”(h]”Œ2step-2-define-consumer-device-nodes-and-properties”ah ]”h"]”Œ3step 2: define consumer device nodes and properties”ah$]”h&]”uh1hµhj1  h²hh³hÊh´K¤ubh¶)”}”(hhh]”(h»)”}”(hŒ$Step 3: Group and Register the Nodes”h]”hŒ$Step 3: Group and Register the Nodes”…””}”(hjÑ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjÎ  h²hh³hÊh´KÓubhÌ)”}”(hŒ|For maintainability, it is often beneficial to group all software nodes into a
single array and register them with one call.”h]”hŒ|For maintainability, it is often beneficial to group all software nodes into a
single array and register them with one call.”…””}”(hjß  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÕhjÎ  h²hubj  )”}”(hX  static const struct software_node * const myboard_swnodes[] = {
      &myboard_gpio_controller_node,
      &myboard_leds_node,
      &myboard_status_led_swnode,
      &myboard_keys_node,
      &myboard_wps_button_swnode,
      NULL
};

static int __init myboard_init(void)
{
      int error;

      error = software_node_register_node_group(myboard_swnodes);
      if (error) {
              pr_err("Failed to register software nodes: %d\n", error);
              return error;
      }

      // ... platform device registration follows
}”h]”hX  static const struct software_node * const myboard_swnodes[] = {
      &myboard_gpio_controller_node,
      &myboard_leds_node,
      &myboard_status_led_swnode,
      &myboard_keys_node,
      &myboard_wps_button_swnode,
      NULL
};

static int __init myboard_init(void)
{
      int error;

      error = software_node_register_node_group(myboard_swnodes);
      if (error) {
              pr_err("Failed to register software nodes: %d\n", error);
              return error;
      }

      // ... platform device registration follows
}”…””}”hjí  sbah}”(h]”h ]”h"]”h$]”h&]”j"  j#  j$  ‰j%  j&  j'  }”uh1j  h³hÊh´KØhjÎ  h²hubhŒnote”“”)”}”(hŒÓWhen splitting registration of nodes by devices that they represent, it is
essential that the software node representing the GPIO controller itself
is registered first, before any of the nodes that reference it.”h]”hÌ)”}”(hŒÓWhen splitting registration of nodes by devices that they represent, it is
essential that the software node representing the GPIO controller itself
is registered first, before any of the nodes that reference it.”h]”hŒÓWhen splitting registration of nodes by devices that they represent, it is
essential that the software node representing the GPIO controller itself
is registered first, before any of the nodes that reference it.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kñhjþ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jü  hjÎ  h²hh³hÊh´Nubeh}”(h]”Œ#step-3-group-and-register-the-nodes”ah ]”h"]”Œ$step 3: group and register the nodes”ah$]”h&]”uh1hµhj1  h²hh³hÊh´KÓubh¶)”}”(hhh]”(h»)”}”(hŒ5Step 4: Register Platform Devices with Software Nodes”h]”hŒ5Step 4: Register Platform Devices with Software Nodes”…””}”(hj!  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj  h²hh³hÊh´KöubhÌ)”}”(hŒ™Finally, register the platform devices and associate them with their respective
software nodes using the ``fwnode`` field in struct platform_device_info.”h]”(hŒiFinally, register the platform devices and associate them with their respective
software nodes using the ”…””}”(hj/  h²hh³Nh´NubhÖ)”}”(hŒ
``fwnode``”h]”hŒfwnode”…””}”(hj7  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj/  ubhŒ& field in struct platform_device_info.”…””}”(hj/  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Køhj  h²hubj  )”}”(hXœ  static struct platform_device *leds_pdev;
static struct platform_device *keys_pdev;

static int __init myboard_init(void)
{
      struct platform_device_info pdev_info;
      int error;

      error = software_node_register_node_group(myboard_swnodes);
      if (error)
              return error;

      memset(&pdev_info, 0, sizeof(pdev_info));
      pdev_info.name = MYBOARD_GPIO_CONTROLLER;
      pdev_info.id = PLATFORM_DEVID_NONE;
      pdev_info.swnode = &myboard_gpio_controller_node;
      gpio_pdev = platform_device_register_full(&pdev_info);
      if (IS_ERR(gpio_pdev)) {
              error = PTR_ERR(gpio_pdev);
              goto err_unregister_nodes;
      }

      memset(&pdev_info, 0, sizeof(pdev_info));
      pdev_info.name = "leds-gpio";
      pdev_info.id = PLATFORM_DEVID_NONE;
      pdev_info.fwnode = software_node_fwnode(&myboard_leds_node);
      leds_pdev = platform_device_register_full(&pdev_info);
      if (IS_ERR(leds_pdev)) {
              error = PTR_ERR(leds_pdev);
              platform_device_unregister(gpio_pdev);
              goto err_unregister_nodes;
      }

      memset(&pdev_info, 0, sizeof(pdev_info));
      pdev_info.name = "gpio-keys";
      pdev_info.id = PLATFORM_DEVID_NONE;
      pdev_info.fwnode = software_node_fwnode(&myboard_keys_node);
      keys_pdev = platform_device_register_full(&pdev_info);
      if (IS_ERR(keys_pdev)) {
              error = PTR_ERR(keys_pdev);
              platform_device_unregister(gpio_pdev);
              platform_device_unregister(leds_pdev);
              goto err_unregister_nodes;
      }

      return 0;

err_unregister_nodes:
      software_node_unregister_node_group(myboard_swnodes);
      return error;
}

static void __exit myboard_exit(void)
{
      platform_device_unregister(keys_pdev);
      platform_device_unregister(leds_pdev);
      platform_device_unregister(gpio_pdev);
      software_node_unregister_node_group(myboard_swnodes);
}”h]”hXœ  static struct platform_device *leds_pdev;
static struct platform_device *keys_pdev;

static int __init myboard_init(void)
{
      struct platform_device_info pdev_info;
      int error;

      error = software_node_register_node_group(myboard_swnodes);
      if (error)
              return error;

      memset(&pdev_info, 0, sizeof(pdev_info));
      pdev_info.name = MYBOARD_GPIO_CONTROLLER;
      pdev_info.id = PLATFORM_DEVID_NONE;
      pdev_info.swnode = &myboard_gpio_controller_node;
      gpio_pdev = platform_device_register_full(&pdev_info);
      if (IS_ERR(gpio_pdev)) {
              error = PTR_ERR(gpio_pdev);
              goto err_unregister_nodes;
      }

      memset(&pdev_info, 0, sizeof(pdev_info));
      pdev_info.name = "leds-gpio";
      pdev_info.id = PLATFORM_DEVID_NONE;
      pdev_info.fwnode = software_node_fwnode(&myboard_leds_node);
      leds_pdev = platform_device_register_full(&pdev_info);
      if (IS_ERR(leds_pdev)) {
              error = PTR_ERR(leds_pdev);
              platform_device_unregister(gpio_pdev);
              goto err_unregister_nodes;
      }

      memset(&pdev_info, 0, sizeof(pdev_info));
      pdev_info.name = "gpio-keys";
      pdev_info.id = PLATFORM_DEVID_NONE;
      pdev_info.fwnode = software_node_fwnode(&myboard_keys_node);
      keys_pdev = platform_device_register_full(&pdev_info);
      if (IS_ERR(keys_pdev)) {
              error = PTR_ERR(keys_pdev);
              platform_device_unregister(gpio_pdev);
              platform_device_unregister(leds_pdev);
              goto err_unregister_nodes;
      }

      return 0;

err_unregister_nodes:
      software_node_unregister_node_group(myboard_swnodes);
      return error;
}

static void __exit myboard_exit(void)
{
      platform_device_unregister(keys_pdev);
      platform_device_unregister(leds_pdev);
      platform_device_unregister(gpio_pdev);
      software_node_unregister_node_group(myboard_swnodes);
}”…””}”hjO  sbah}”(h]”h ]”h"]”h$]”h&]”j"  j#  j$  ‰j%  j&  j'  }”uh1j  h³hÊh´Kûhj  h²hubhÌ)”}”(hŒíWith these changes, the generic ``leds-gpio`` and ``gpio-keys`` drivers will
be able to probe successfully and get their configuration from the properties
defined in the software nodes, removing the need for board-specific platform
data.”h]”(hŒ With these changes, the generic ”…””}”(hj^  h²hh³Nh´NubhÖ)”}”(hŒ``leds-gpio``”h]”hŒ	leds-gpio”…””}”(hjf  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj^  ubhŒ and ”…””}”(hj^  h²hh³Nh´NubhÖ)”}”(hŒ``gpio-keys``”h]”hŒ	gpio-keys”…””}”(hjx  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÕhj^  ubhŒ® drivers will
be able to probe successfully and get their configuration from the properties
defined in the software nodes, removing the need for board-specific platform
data.”…””}”(hj^  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M9hj  h²hubeh}”(h]”Œ4step-4-register-platform-devices-with-software-nodes”ah ]”h"]”Œ5step 4: register platform devices with software nodes”ah$]”h&]”uh1hµhj1  h²hh³hÊh´Köubeh}”(h]”Œafter-using-software-nodes”ah ]”h"]”Œafter: using software nodes”ah$]”h&]”uh1hµhjÔ  h²hh³hÊh´KŽubeh}”(h]”Œconversion-example”ah ]”h"]”Œconversion example”ah$]”h&]”uh1hµhh·h²hh³hÊh´K9ubeh}”(h]”Œsupporting-legacy-boards”ah ]”h"]”Œsupporting legacy boards”ah$]”h&]”uh1hµhhh²hh³hÊh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÊuh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hºNŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”jÓ  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÊŒ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j­  jª  jÑ  jÎ  jÉ  jÆ  j¥  j¢  j.  j+  j  jš  j•  j’  jË  jÈ  j  j  j•  j’  uŒ	nametypes”}”(j­  ‰jÑ  ‰jÉ  ‰j¥  ‰j.  ‰j  ‰j•  ‰jË  ‰j  ‰j•  ‰uh}”(jª  h·jÎ  jg  jÆ  j”  j¢  jÔ  j+  jó  jš  j1  j’  jP  jÈ  j˜  j  jÎ  j’  j  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nh²hub.