From b317a23045e01697888424bb477d6f4f7b31cbc2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Benjamin=20Cab=C3=A9?= Date: Mon, 1 Dec 2025 17:30:18 +0100 Subject: [PATCH 1/7] doc: services: uuid: Add dedicated page for JWT API MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add more complete/dedicated documentation page for JWT API Signed-off-by: Benjamin Cabé --- doc/services/jwt/index.rst | 75 ++++++++++++++++++++++++++++++++++++++ doc/services/misc.rst | 13 ------- 2 files changed, 75 insertions(+), 13 deletions(-) create mode 100644 doc/services/jwt/index.rst diff --git a/doc/services/jwt/index.rst b/doc/services/jwt/index.rst new file mode 100644 index 0000000000000..bdb842dd2a0ea --- /dev/null +++ b/doc/services/jwt/index.rst @@ -0,0 +1,75 @@ +.. _jwt_api: + +JSON Web Token (JWT) +#################### + +Overview +******** + +JSON Web Tokens (JWT) are an open, industry standard (:rfc:`7519`) method for representing claims +securely between two parties. Although JWT is fairly flexible, this API is limited to creating the +simplistic tokens needed to authenticate with the Google Core IoT infrastructure. + +At a high level, a JWT is just a signed blob of JSON that a client can present as a token instead +of sending, for example, their username/password every time. + +Usage +===== + +To use the JWT API, include the header file: + +.. code-block:: c + + #include + +Generating a JWT +---------------- + +The JWT subsystem provides a lightweight, builder-based API for constructing JSON Web Tokens (JWT). +It allows for the creation of tokens where the payload (claims) contains: expiration time, issued-at +time, and audience. The token is then signed using a provided private key. + +.. code-block:: c + + #include + + struct jwt_builder builder; + char buffer[1024]; + int ret; + + /* Initialize the builder */ + ret = jwt_init_builder(&builder, buffer, sizeof(buffer)); + if (ret < 0) { + /* Handle error */ + } + + /* Add payload: expiration, issued at, audience */ + ret = jwt_add_payload(&builder, 1767221999, 1764605987, "project-id"); + if (ret < 0) { + /* Handle error */ + } + + /* Sign the token using a DER-encoded private key */ + ret = jwt_sign(&builder, private_key_der, private_key_der_len); + if (ret < 0) { + /* Handle error */ + } + + /* + * buffer now contains the JWT ; it can be passed to a third-party service that will be able + * to validate it against the public key associated with `private_key_der`. + */ + +Configuration +************* + +Related configuration options: + +* :kconfig:option:`CONFIG_JWT` +* :kconfig:option-regex:`CONFIG_JWT_.*` + + +API Reference +************* + +.. doxygengroup:: jwt diff --git a/doc/services/misc.rst b/doc/services/misc.rst index 6af6778684b71..337b5512a7a90 100644 --- a/doc/services/misc.rst +++ b/doc/services/misc.rst @@ -8,19 +8,6 @@ Miscellaneous .. doxygengroup:: checksum .. doxygengroup:: structured_data -Structured Data APIs -******************** - -JWT -=== - -JSON Web Tokens (JWT) are an open, industry standard (:rfc:`7519`) method for representing -claims securely between two parties. Although JWT is fairly flexible, -this API is limited to creating the simplistic tokens needed to -authenticate with the Google Core IoT infrastructure. - -.. doxygengroup:: jwt - Identifier APIs *************** From dc3183883f07cb6e04aa76401d9b8ad9a2edbb2b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Benjamin=20Cab=C3=A9?= Date: Mon, 1 Dec 2025 16:55:56 +0100 Subject: [PATCH 2/7] doc: services: uuid: Add dedicated page for UUID API MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add more complete/dedicated documentation page for UUID API Signed-off-by: Benjamin Cabé --- doc/services/misc.rst | 21 ---------- doc/services/uuid/index.rst | 77 +++++++++++++++++++++++++++++++++++++ 2 files changed, 77 insertions(+), 21 deletions(-) delete mode 100644 doc/services/misc.rst create mode 100644 doc/services/uuid/index.rst diff --git a/doc/services/misc.rst b/doc/services/misc.rst deleted file mode 100644 index 337b5512a7a90..0000000000000 --- a/doc/services/misc.rst +++ /dev/null @@ -1,21 +0,0 @@ -.. _misc_api: - -Miscellaneous -############# - -.. comment - not documenting - .. doxygengroup:: checksum - .. doxygengroup:: structured_data - -Identifier APIs -*************** - -UUID -==== - -Universally Unique Identifiers (UUID), also known as Globally Unique -IDentifiers (GUIDs) are an open, industry standard (:rfc:`9562`) 128 bits long identifiers -intended to guarantee uniqueness across space and time. - -.. doxygengroup:: uuid diff --git a/doc/services/uuid/index.rst b/doc/services/uuid/index.rst new file mode 100644 index 0000000000000..d33257b6b17f5 --- /dev/null +++ b/doc/services/uuid/index.rst @@ -0,0 +1,77 @@ +.. _uuid_api: + +UUID +#### + +Overview +******** + +Universally Unique Identifiers (UUID), also known as Globally Unique IDentifiers (GUIDs), are +128-bit identifiers intended to guarantee uniqueness across space and time. They are defined by +:rfc:`9562`. + +The UUID subsystem provides utility functions for the generation, parsing, and manipulation of +UUIDs. It supports generating version 4 (random) and version 5 (name-based) UUIDs. + +Usage +===== + +To use the UUID API, include the header file: + +.. code-block:: c + + #include + +Generating a UUIDv4 +------------------- + +UUIDv4 is based on random number (hence requires an entropy generator), and can be generated using +the :c:func:`uuid_generate_v4` function. :kconfig:option:`CONFIG_UUID_V4` must also be enabled. + +.. code-block:: c + + struct uuid my_uuid; + char uuid_str[UUID_STR_LEN]; + int ret = uuid_generate_v4(&my_uuid); + if (ret == 0) { + uuid_to_string(&my_uuid, uuid_str); + printk("UUID: %s\n", uuid_str); + } + +Generating a UUIDv5 +------------------- + +UUIDv5 is generated from a namespace UUID and a name (binary data), and can be generated using the +:c:func:`uuid_generate_v5` function. :kconfig:option:`CONFIG_UUID_V5` must also be enabled. + +UUIDv5 is deterministic: the same namespace and name will always result in the same UUID. + +.. code-block:: c + + struct uuid ns_uuid; /* Initialize with a namespace UUID */ + struct uuid my_uuid; + const char *name = "zephyrproject.org"; + + /* Initialize ns_uuid with a valid UUID, here the well-known namespace ID for URLs */ + uuid_from_str("6ba7b811-9dad-11d1-80b4-00c04fd430c8", &ns_uuid); + + int ret = uuid_generate_v5(&ns_uuid, name, strlen(name), &my_uuid); + if (ret == 0) { + uuid_to_string(&my_uuid, uuid_str); + printk("UUID: %s\n", uuid_str); /* outputs: "UUID: 16ff8549-ea80-53be-a6d0-96b064c39bc6" */ + } + +Configuration +************* + +Related configuration options: + +* :kconfig:option:`CONFIG_UUID` +* :kconfig:option:`CONFIG_UUID_V4` +* :kconfig:option:`CONFIG_UUID_V5` +* :kconfig:option:`CONFIG_UUID_BASE64` + +API Reference +************* + +.. doxygengroup:: uuid From 1845015c2d1c2a40e0f1d71bca9324d52d1baf21 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Benjamin=20Cab=C3=A9?= Date: Thu, 27 Nov 2025 12:02:42 +0100 Subject: [PATCH 3/7] doc: conf: add sphinx-design extension MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add sphinx-design to the list of Sphinx extensions in conf.py to enable additional design components for documentation, starting with cards. https://sphinx-design.readthedocs.io/en/latest/ Signed-off-by: Benjamin Cabé --- doc/_static/css/custom.css | 476 ++++++++++++++++++++++++++----------- doc/conf.py | 1 + doc/requirements.in | 1 + doc/requirements.txt | 5 + 4 files changed, 344 insertions(+), 139 deletions(-) diff --git a/doc/_static/css/custom.css b/doc/_static/css/custom.css index e6c0853b1c48c..9472bbec3d727 100644 --- a/doc/_static/css/custom.css +++ b/doc/_static/css/custom.css @@ -8,12 +8,12 @@ * visual identity. Many colors are also overridden to use CSS variables. */ - :root { - /* Use system font stacks for better performance (no Web fonts required) */ - --system-font-family: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; - --header-font-family: Seravek, 'Gill Sans Nova', Ubuntu, Calibri, 'DejaVu Sans', source-sans-pro, sans-serif; - --monospace-font-family: 'SF Mono', 'Monaco', 'Inconsolata', 'Fira Mono', 'Droid Sans Mono', 'Source Code Pro', monospace; - } +:root { + /* Use system font stacks for better performance (no Web fonts required) */ + --system-font-family: system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; + --header-font-family: Seravek, 'Gill Sans Nova', Ubuntu, Calibri, 'DejaVu Sans', source-sans-pro, sans-serif; + --monospace-font-family: 'SF Mono', 'Monaco', 'Inconsolata', 'Fira Mono', 'Droid Sans Mono', 'Source Code Pro', monospace; +} body, h1, @@ -123,16 +123,18 @@ hr, /* JavaScript documentation directives */ html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) dt, -html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) dl:not(.field-list) > dt { +html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) dl:not(.field-list)>dt { background-color: var(--admonition-note-background-color); border-color: var(--admonition-note-title-background-color); color: var(--admonition-note-color); } + html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) dl dt { background-color: transparent; border-color: transparent; color: var(--footer-color); } + html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).class dt, html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).function dt, html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).method dt, @@ -142,10 +144,11 @@ html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not( margin-bottom: 1px; width: 100%; } -html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).class > dt, -html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).function > dt, -html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).method > dt, -html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).attribute > dt { + +html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).class>dt, +html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).function>dt, +html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).method>dt, +html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).attribute>dt { font-family: var(--monospace-font-family); font-variant-ligatures: none; font-size: 90%; @@ -153,59 +156,74 @@ html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not( margin-bottom: 16px; padding: 6px 8px; } + html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .sig-prename.descclassname { color: var(--highlight-type2-color); font-weight: normal; } + html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .sig-name.descname { color: var(--highlight-function-color); font-weight: 700; } + html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .sig-paren, html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .optional { color: var(--highlight-operator-color) !important; font-weight: normal; padding: 0 2px; } + html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .optional { font-style: italic; } + html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .sig-param, -html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).class dt > em, -html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).function dt > em, -html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).method dt > em { +html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).class dt>em, +html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).function dt>em, +html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).method dt>em { color: var(--code-literal-color); font-style: normal; padding: 0 4px; } + html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .k { font-style: normal; } -html.writer-html5 .rst-content dl:not(.docutils) > dt, html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) > dt { + +html.writer-html5 .rst-content dl:not(.docutils)>dt, +html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt { border-top-color: var(--highlight-background-emph-color); background: var(--highlight-background-color); } -html.writer-html5 .rst-content dl:not(.docutils) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) > dt, html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) > dt { + +html.writer-html5 .rst-content dl:not(.docutils) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt, +html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple) dl:not(.option-list):not(.field-list):not(.footnote):not(.citation):not(.glossary):not(.simple)>dt { border-left-color: var(--highlight-background-emph-color); background: var(--highlight-background-color); } + html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) .sig-param, -html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).class dt > .optional ~ em, -html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).function dt > .optional ~ em, -html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).method dt > .optional ~ em { +html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).class dt>.optional~em, +html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).function dt>.optional~em, +html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).method dt>.optional~em { color: var(--highlight-number-color); font-style: italic; } -html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).class dt > em.property { + +html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple).class dt>em.property { color: var(--highlight-keyword-color); } + html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) dt a.headerlink { color: var(--link-color) !important; } + html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(.footnote):not(.glossary):not(.simple) dt a.headerlink:visited { color: var(--link-color-visited); } -html.writer-html5 .rst-content dl.field-list > dd strong { + +html.writer-html5 .rst-content dl.field-list>dd strong { font-family: var(--monospace-font-family); font-variant-ligatures: none; } @@ -255,9 +273,12 @@ a.icon-home:visited { border-color: var(--code-border-color); } -.rst-content table.docutils caption, .rst-content table.field-list caption, .wy-table caption { +.rst-content table.docutils caption, +.rst-content table.field-list caption, +.wy-table caption { color: var(--body-color); } + .wy-table-odd td, .wy-table-striped tr:nth-child(2n-1) td, .rst-content table.docutils:not(.field-list) tr:nth-child(2n-1) td { @@ -284,7 +305,7 @@ a.icon-home:visited { /* Force table content font-size in responsive tables to be 100% * fixing larger font size for paragraphs in the kconfig tables */ - .wy-table-responsive td p { +.wy-table-responsive td p { font-size: 100%; } @@ -354,7 +375,9 @@ a.internal:visited code.literal { margin-bottom: 1em; } -.rst-content tt.literal, .rst-content code.literal, .highlight { +.rst-content tt.literal, +.rst-content code.literal, +.highlight { border-radius: 0.25rem; } @@ -367,95 +390,224 @@ a.internal:visited code.literal { background-color: var(--highlight-background-emph-color); } -.highlight .gh /* Generic.Heading */, -.highlight .gu /* Generic.Subheading */, -.highlight .go /* Generic.Output */, -.highlight .gt /* Generic.Traceback */ { +.highlight .gh +/* Generic.Heading */ +, +.highlight .gu +/* Generic.Subheading */ +, +.highlight .go +/* Generic.Output */ +, +.highlight .gt + +/* Generic.Traceback */ + { color: var(--highlight-default-color); } -.highlight .c /* Comment */, -.highlight .c1 /* Comment.Single */, -.highlight .cm /* Comment.Multiline */, -.highlight .cs /* Comment.Special */ { +.highlight .c +/* Comment */ +, +.highlight .c1 +/* Comment.Single */ +, +.highlight .cm +/* Comment.Multiline */ +, +.highlight .cs + +/* Comment.Special */ + { color: var(--highlight-comment-color); } -.highlight .bp /* Name.Builtin.Pseudo */, -.highlight .k /* Keyword */, -.highlight .kc /* Keyword.Constant */, -.highlight .kd /* Keyword.Declaration */, -.highlight .kn /* Keyword.Namespace */, -.highlight .kp /* Keyword.Pseudo */, -.highlight .kr /* Keyword.Reserved */, -.highlight .kt /* Keyword.Type */, -.highlight .ow /* Operator.Word */ { +.highlight .bp +/* Name.Builtin.Pseudo */ +, +.highlight .k +/* Keyword */ +, +.highlight .kc +/* Keyword.Constant */ +, +.highlight .kd +/* Keyword.Declaration */ +, +.highlight .kn +/* Keyword.Namespace */ +, +.highlight .kp +/* Keyword.Pseudo */ +, +.highlight .kr +/* Keyword.Reserved */ +, +.highlight .kt +/* Keyword.Type */ +, +.highlight .ow + +/* Operator.Word */ + { color: var(--highlight-keyword-color); } -.highlight .ch /* Comment.Hashbang */, -.highlight .cp /* Comment.Preproc */ { +.highlight .ch +/* Comment.Hashbang */ +, +.highlight .cp + +/* Comment.Preproc */ + { color: var(--highlight-keyword2-color); } -.highlight .m /* Literal.Number */, -.highlight .mf /* Literal.Number.Float */, -.highlight .mi /* Literal.Number.Integer */, -.highlight .il /* Literal.Number.Integer.Long */, -.highlight .mb /* Literal.Number.Bin */, -.highlight .mh /* Literal.Number.Hex */, -.highlight .mo /* Literal.Number.Oct */ { +.highlight .m +/* Literal.Number */ +, +.highlight .mf +/* Literal.Number.Float */ +, +.highlight .mi +/* Literal.Number.Integer */ +, +.highlight .il +/* Literal.Number.Integer.Long */ +, +.highlight .mb +/* Literal.Number.Bin */ +, +.highlight .mh +/* Literal.Number.Hex */ +, +.highlight .mo + +/* Literal.Number.Oct */ + { color: var(--highlight-number-color); } -.highlight .na /* Name.Attribute */, -.highlight .nd /* Name.Decorator */, -.highlight .ni /* Name.Entity */, -.highlight .nl /* Name.Label */ { +.highlight .na +/* Name.Attribute */ +, +.highlight .nd +/* Name.Decorator */ +, +.highlight .ni +/* Name.Entity */ +, +.highlight .nl + +/* Name.Label */ + { color: var(--highlight-decorator-color); } -.highlight .nb /* Name.Builtin */, -.highlight .ne /* Name.Exception */ { +.highlight .nb +/* Name.Builtin */ +, +.highlight .ne + +/* Name.Exception */ + { color: var(--highlight-type-color); } -.highlight .nc /* Name.Class */, -.highlight .nn /* Name.Namespace */, -.highlight .no /* Name.Constant */, -.highlight .nv /* Name.Variable */, -.highlight .vc /* Name.Variable.Class */, -.highlight .vg /* Name.Variable.Global */, -.highlight .vi /* Name.Variable.Instance */, -.highlight .vm /* Name.Variable.Magic */ { +.highlight .nc +/* Name.Class */ +, +.highlight .nn +/* Name.Namespace */ +, +.highlight .no +/* Name.Constant */ +, +.highlight .nv +/* Name.Variable */ +, +.highlight .vc +/* Name.Variable.Class */ +, +.highlight .vg +/* Name.Variable.Global */ +, +.highlight .vi +/* Name.Variable.Instance */ +, +.highlight .vm + +/* Name.Variable.Magic */ + { color: var(--highlight-type2-color); } -.highlight .nf /* Name.Function */, -.highlight .fm /* Name.Function.Magic */, -.highlight .nt /* Name.Tag */ { +.highlight .nf +/* Name.Function */ +, +.highlight .fm +/* Name.Function.Magic */ +, +.highlight .nt + +/* Name.Tag */ + { color: var(--highlight-function-color); } -.highlight .o /* Operator */, -.highlight .si /* Literal.String.Interpol */, -.highlight .sx /* Literal.String.Other */, -.highlight .sr /* Literal.String.Regex */, -.highlight .ss /* Literal.String.Symbol */ { +.highlight .o +/* Operator */ +, +.highlight .si +/* Literal.String.Interpol */ +, +.highlight .sx +/* Literal.String.Other */ +, +.highlight .sr +/* Literal.String.Regex */ +, +.highlight .ss + +/* Literal.String.Symbol */ + { color: var(--highlight-operator-color); } -.highlight .cpf/* Comment.PreprocFile */, -.highlight .s /* Literal.String */, -.highlight .s1 /* Literal.String.Single */, -.highlight .s2 /* Literal.String.Double */, -.highlight .sc /* Literal.String.Char */, -.highlight .se /* Literal.String.Escape */, -.highlight .sa /* Literal.String.Affix */, -.highlight .sb /* Literal.String.Backtick */, -.highlight .dl /* Literal.String.Delimiter */, -.highlight .sd /* Literal.String.Doc */, -.highlight .sh /* Literal.String.Heredoc */ { +.highlight .cpf +/* Comment.PreprocFile */ +, +.highlight .s +/* Literal.String */ +, +.highlight .s1 +/* Literal.String.Single */ +, +.highlight .s2 +/* Literal.String.Double */ +, +.highlight .sc +/* Literal.String.Char */ +, +.highlight .se +/* Literal.String.Escape */ +, +.highlight .sa +/* Literal.String.Affix */ +, +.highlight .sb +/* Literal.String.Backtick */ +, +.highlight .dl +/* Literal.String.Delimiter */ +, +.highlight .sd +/* Literal.String.Doc */ +, +.highlight .sh + +/* Literal.String.Heredoc */ + { color: var(--highlight-string-color); } @@ -532,9 +684,10 @@ a.internal:visited code.literal { } /* Keyboard shortcuts tweaks */ -kbd, .kbd, -.rst-content :not(dl.option-list) > :not(dt):not(kbd):not(.kbd) > kbd, -.rst-content :not(dl.option-list) > :not(dt):not(kbd):not(.kbd) > .kbd { +kbd, +.kbd, +.rst-content :not(dl.option-list)> :not(dt):not(kbd):not(.kbd)>kbd, +.rst-content :not(dl.option-list)> :not(dt):not(kbd):not(.kbd)>.kbd { background-color: var(--kbd-background-color); border: 1px solid var(--kbd-outline-color); border-radius: 3px; @@ -557,7 +710,7 @@ kbd, .kbd, /* heading tweaks to make document hierarchy easier to grasp */ -.rst-content section > h1 { +.rst-content section>h1 { font-weight: 700; margin-bottom: 2.5rem; position: relative; @@ -565,22 +718,23 @@ kbd, .kbd, z-index: 1; } -.rst-content section > h1::before { +.rst-content section>h1::before { content: ''; position: absolute; - z-index:-1; + z-index: -1; left: 0; right: 0; height: 4px; bottom: -1px; - background: linear-gradient(to right, var(--admonition-note-title-background-color), var(--admonition-note-title-background-color) 50%, var(--admonition-note-background-color) 80%, transparent); /* Example gradient */ - opacity:50%; + background: linear-gradient(to right, var(--admonition-note-title-background-color), var(--admonition-note-title-background-color) 50%, var(--admonition-note-background-color) 80%, transparent); + /* Example gradient */ + opacity: 50%; } -.rst-content section > h2, -.rst-content section > h3, -.rst-content section > h4, -.rst-content section > h5 { +.rst-content section>h2, +.rst-content section>h3, +.rst-content section>h4, +.rst-content section>h5 { font-weight: 500; padding-inline-start: 8px; margin-inline-start: 0px; @@ -589,20 +743,20 @@ kbd, .kbd, padding-bottom: 0.2em; } -.rst-content section > h2 { +.rst-content section>h2 { border-color: var(--admonition-note-title-background-color); } -.rst-content section > h3 { +.rst-content section>h3 { border-color: var(--admonition-note-background-color); } -.rst-content section > h4 { +.rst-content section>h4 { border-color: transparent; font-weight: 400; } -.rst-content section > h5 { +.rst-content section>h5 { border-color: transparent; font-weight: 100; } @@ -628,7 +782,7 @@ kbd, .kbd, opacity: var(--logo-opacity); } -.wy-side-nav-search > a img.logo { +.wy-side-nav-search>a img.logo { /* Fixed size to prevent reflows and support hiDPI displays */ /* A 5 pixel margin is added on each side. The logo itself displays at 200×100 at 100% scaling. */ width: 210px; @@ -644,6 +798,7 @@ kbd, .kbd, } @media only screen and (min-width: 769px) { + /* Simulate a drop shadow that only affects the bottom edge */ /* This is used to indicate the search bar is fixed */ .wy-side-nav-search.fixed-and-scrolled::after { @@ -658,13 +813,13 @@ kbd, .kbd, } } -.wy-side-nav-search > a:hover, -.wy-side-nav-search .wy-dropdown > a:hover { +.wy-side-nav-search>a:hover, +.wy-side-nav-search .wy-dropdown>a:hover { background-color: var(--navbar-background-color-hover); } -.wy-side-nav-search > a:active, -.wy-side-nav-search .wy-dropdown > a:active { +.wy-side-nav-search>a:active, +.wy-side-nav-search .wy-dropdown>a:active { background-color: var(--navbar-background-color-active); } @@ -714,7 +869,7 @@ kbd, .kbd, } /* Version branch label below the logo */ -.wy-side-nav-search > div.version { +.wy-side-nav-search>div.version { color: var(--navbar-level-3-color); opacity: 0.9; } @@ -734,7 +889,7 @@ kbd, .kbd, background-color: var(--navbar-background-color-active); } -.wy-menu-vertical li.toctree-l1.current > a { +.wy-menu-vertical li.toctree-l1.current>a { border: none; } @@ -766,25 +921,25 @@ kbd, .kbd, } .wy-menu-vertical li.current a, -.wy-menu-vertical li.toctree-l2.current > a, -.wy-menu-vertical li.toctree-l2.current li.toctree-l3 > a, -.wy-menu-vertical li.toctree-l2.current li.toctree-l4 > a { +.wy-menu-vertical li.toctree-l2.current>a, +.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a, +.wy-menu-vertical li.toctree-l2.current li.toctree-l4>a { background-color: var(--navbar-current-background-color); color: var(--navbar-level-2-color); border-color: var(--navbar-current-background-color); } .wy-menu-vertical li.current a:hover, -.wy-menu-vertical li.toctree-l2.current > a:hover, -.wy-menu-vertical li.toctree-l2.current li.toctree-l3 > a:hover, -.wy-menu-vertical li.toctree-l3.current li.toctree-l4 > a:hover { +.wy-menu-vertical li.toctree-l2.current>a:hover, +.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a:hover, +.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a:hover { background-color: var(--navbar-current-background-color-hover); } .wy-menu-vertical li.current a:active, -.wy-menu-vertical li.toctree-l2.current > a:active, -.wy-menu-vertical li.toctree-l2.current li.toctree-l3 > a:active, -.wy-menu-vertical li.toctree-l3.current li.toctree-l4 > a:active { +.wy-menu-vertical li.toctree-l2.current>a:active, +.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a:active, +.wy-menu-vertical li.toctree-l3.current li.toctree-l4>a:active { background-color: var(--navbar-current-background-color-active); } @@ -857,19 +1012,23 @@ kbd, .kbd, padding: 0 0 0 1em; } } + .wy-menu.wy-menu-vertical { overflow-y: auto; overflow-x: hidden; max-height: calc(100% - 243px); } + @media screen and (max-width: 768px) { .wy-nav-side { padding-bottom: 44px; } + .wy-menu.wy-menu-vertical { overflow-y: initial; max-height: initial; } + .wy-nav-content { min-height: calc(100vh - 64px); min-height: calc(100dvh - 64px); @@ -880,19 +1039,24 @@ kbd, .kbd, .wy-menu.wy-menu-vertical { scrollbar-color: var(--navbar-scrollbar-color) var(--navbar-scrollbar-background); } + .wy-menu.wy-menu-vertical::-webkit-scrollbar { width: .75rem; } + .wy-menu.wy-menu-vertical::-webkit-scrollbar-track { background-color: var(--navbar-scrollbar-background); } + .wy-menu.wy-menu-vertical::-webkit-scrollbar-thumb { background-color: var(--navbar-scrollbar-color); } + /* Firefox does the dimming on hover automatically. We emulate it for Webkit-based browsers. */ .wy-menu.wy-menu-vertical::-webkit-scrollbar-thumb:hover { background-color: var(--navbar-scrollbar-hover-color); } + .wy-menu.wy-menu-vertical::-webkit-scrollbar-thumb:active { background-color: var(--navbar-scrollbar-active-color); } @@ -903,7 +1067,8 @@ kbd, .kbd, column-width: 18em; } -.rst-content div.figure, .rst-content figure { +.rst-content div.figure, +.rst-content figure { text-align: center; } @@ -913,17 +1078,17 @@ kbd, .kbd, dark-mode-toggle::part(fieldset) { - padding-inline: 0.75rem; - padding-block: 0; + padding-inline: 0.75rem; + padding-block: 0; } dark-mode-toggle::part(darkLabel), dark-mode-toggle::part(lightLabel), -dark-mode-toggle::part(toggleLabel){ - font-size: unset; +dark-mode-toggle::part(toggleLabel) { + font-size: unset; } -div.graphviz > object { +div.graphviz>object { filter: var(--graphviz-filter); } @@ -998,10 +1163,10 @@ div.graphviz > object { display: -ms-flexbox; display: flex; -ms-flex-wrap: wrap; - flex-wrap: wrap; + flex-wrap: wrap; -webkit-box-pack: center; - -ms-flex-pack: center; - justify-content: center; + -ms-flex-pack: center; + justify-content: center; margin: 1rem auto; max-width: calc((160px + 2rem) * 4); } @@ -1009,8 +1174,8 @@ div.graphviz > object { .grid-item { list-style-type: none !important; -webkit-box-flex: 0; - -ms-flex: 0 0 auto; - flex: 0 0 auto; + -ms-flex: 0 0 auto; + flex: 0 0 auto; width: 150px; text-align: center; margin: 1rem; @@ -1026,14 +1191,14 @@ div.graphviz > object { display: flex; -webkit-box-orient: vertical; -webkit-box-direction: normal; - -ms-flex-direction: column; - flex-direction: column; + -ms-flex-direction: column; + flex-direction: column; -webkit-box-pack: center; - -ms-flex-pack: center; - justify-content: center; + -ms-flex-pack: center; + justify-content: center; -webkit-box-align: center; - -ms-flex-align: center; - align-items: center; + -ms-flex-align: center; + align-items: center; border-radius: 1rem; background: linear-gradient(135deg, #0070c5 0%, #5c13a5 100%); color: white; @@ -1063,9 +1228,9 @@ div.graphviz > object { } .grid-icon { - line-height: 1.5; - font-size: 3rem; - color: white; + line-height: 1.5; + font-size: 3rem; + color: white; } .lastupdated { @@ -1138,11 +1303,11 @@ div.graphviz > object { #search-se-menu ul li .fa-check { display: none; - } +} - #search-se-menu ul li.selected .fa-check { +#search-se-menu ul li.selected .fa-check { display: inline; - } +} .doxygroup::after { content: 'Doxygen'; @@ -1159,6 +1324,7 @@ div.graphviz > object { .code-sample-list li { margin-bottom: 0.25em; } + .code-sample-name { font-weight: bold; padding-right: 0.5em; @@ -1169,7 +1335,8 @@ div.graphviz > object { } .code-sample-description::before { - content: '\F0A9'; /* arrow-circle-right */ + content: '\F0A9'; + /* arrow-circle-right */ font-family: 'FontAwesome'; padding-right: 0.5em; } @@ -1181,3 +1348,34 @@ li>a.code-sample-link.reference.internal { li>a.code-sample-link.reference.internal.current { text-decoration: underline; } + +/* sphinx-design classes */ + +.sd-card { + background-color: var(--navbar-background-color) !important; + border-radius: 0.75rem !important; + border: 1px solid transparent !important; + transition: all 0.15s ease; + box-shadow: none !important; +} + +.sd-card:hover { + transform: translateY(-3px); + box-shadow: 0 6px 12px rgba(0, 0, 0, 0.25) !important; + border-color: rgba(255, 255, 255, 0.05); +} + +.sd-card-title { + font-size: 1.125rem !important; + font-weight: bold !important; + margin-bottom: 0.25rem !important; + color: #fff !important; +} + +.sd-card-text { + color: var(--navbar-level-1-color) !important; + font-weight: 300 !important; + font-size: 0.9rem !important; + margin: 0 !important; + opacity: 0.85; +} diff --git a/doc/conf.py b/doc/conf.py index 805e3b42b90dc..6373a15d0a733 100644 --- a/doc/conf.py +++ b/doc/conf.py @@ -77,6 +77,7 @@ "sphinx.ext.graphviz", "sphinxcontrib.jquery", "sphinxcontrib.programoutput", + "sphinx_design", "zephyr.application", "zephyr.html_redirects", "zephyr.kconfig", diff --git a/doc/requirements.in b/doc/requirements.in index 9cbe4deb82327..59e9112ff39d7 100644 --- a/doc/requirements.in +++ b/doc/requirements.in @@ -11,6 +11,7 @@ sphinx-togglebutton sphinx-sitemap sphinx-autobuild sphinxcontrib.programoutput +sphinx-design # YAML validation. Used by zephyr_module. PyYAML>=6.0 diff --git a/doc/requirements.txt b/doc/requirements.txt index f400610549748..91cd8f7ba9dac 100644 --- a/doc/requirements.txt +++ b/doc/requirements.txt @@ -529,6 +529,7 @@ sphinx==8.2.3 \ # -r requirements.in # sphinx-autobuild # sphinx-copybutton + # sphinx-design # sphinx-last-updated-by-git # sphinx-notfound-page # sphinx-rtd-theme @@ -545,6 +546,10 @@ sphinx-copybutton==0.5.2 \ --hash=sha256:4cf17c82fb9646d1bc9ca92ac280813a3b605d8c421225fd9913154103ee1fbd \ --hash=sha256:fb543fd386d917746c9a2c50360c7905b605726b9355cd26e9974857afeae06e # via -r requirements.in +sphinx-design==0.6.1 \ + --hash=sha256:b11f37db1a802a183d61b159d9a202314d4d2fe29c163437001324fe2f19549c \ + --hash=sha256:b44eea3719386d04d765c1a8257caca2b3e6f8421d7b3a5e742c0fd45f84e632 + # via -r requirements.in sphinx-last-updated-by-git==0.3.8 \ --hash=sha256:6382c8285ac1f222483a58569b78c0371af5e55f7fbf9c01e5e8a72d6fdfa499 \ --hash=sha256:c145011f4609d841805b69a9300099fc02fed8f5bb9e5bcef77d97aea97b7761 From 9687a1377f21a50856f4d1e3f2831e16fb38d51e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Benjamin=20Cab=C3=A9?= Date: Fri, 28 Nov 2025 22:38:28 +0100 Subject: [PATCH 4/7] doc: peripherals: add structure/categorization to peripherals index MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The very flat and unorganized list of peripherals deserved a bit of love and this commit introduced some grouping Signed-off-by: Benjamin Cabé --- doc/hardware/peripherals/index.rst | 251 +++++++++++++++++++++++------ 1 file changed, 206 insertions(+), 45 deletions(-) diff --git a/doc/hardware/peripherals/index.rst b/doc/hardware/peripherals/index.rst index 2ef752c27dfed..6bc2a5b7d53c2 100644 --- a/doc/hardware/peripherals/index.rst +++ b/doc/hardware/peripherals/index.rst @@ -4,65 +4,226 @@ Peripherals ########### .. - Please keep the ToC tree sorted based on the titles of the pages included + Please keep the ToC trees sorted based on the titles of the pages included + +.. grid:: 1 1 2 3 + :gutter: 2 + + .. grid-item-card:: :material-twotone:`show_chart;36px` Analog + :link: analog_peripherals + :link-type: ref + + Analog-to-Digital and Digital-to-Analog converters, Comparators, and Amplifiers. + + .. grid-item-card:: :material-twotone:`speaker;36px` Audio + :link: audio_reference + :link-type: ref + + Audio interfaces and sound processing. + + .. grid-item-card:: :material-twotone:`settings_ethernet;36px` Communication + :link: communication_peripherals + :link-type: ref + + Serial buses (I2C, SPI, UART, CAN) and other communication interfaces. + + .. grid-item-card:: :material-twotone:`monitor;36px` Display + :link: display_peripherals + :link-type: ref + + Visual output, video interfaces, and LED control. + + .. grid-item-card:: :material-twotone:`touch_app;36px` GPIO & Input + :link: gpio_input_peripherals + :link-type: ref + + General Purpose I/O, tactile feedback, and input devices. + + .. grid-item-card:: :material-twotone:`save;36px` Memory & Storage + :link: memory_storage_peripherals + :link-type: ref + + Non-volatile memory, flash storage, and EEPROM. + + .. grid-item-card:: :material-twotone:`battery_charging_full;36px` Power + :link: power_peripherals + :link-type: ref + + Power management, charging, regulators, and reset controllers. + + .. grid-item-card:: :material-twotone:`sensors;36px` Sensors + :link: sensor_peripherals + :link-type: ref + + Environmental and motion sensors, GNSS, and sensor interfaces. + + .. grid-item-card:: :material-twotone:`precision_manufacturing;36px` Motion & Actuation + :link: motion_actuation_peripherals + :link-type: ref + + PWM, stepper motors, haptics, and other actuators. + + .. grid-item-card:: :material-twotone:`bug_report;36px` System + :link: system_diagnostics_peripherals + :link-type: ref + + System information, synchronization, DMA, buses, and diagnostics. + + .. grid-item-card:: :material-twotone:`schedule;36px` Timing + :link: timing_peripherals + :link-type: ref + + Timers, clocks, watchdogs, and timekeeping primitives. + +.. toctree:: + :maxdepth: 2 + :hidden: + + audio/index.rst + + +.. _analog_peripherals: + +Analog +****** .. toctree:: :maxdepth: 1 - w1.rst adc.rst - auxdisplay.rst - audio/index.rst - bbram.rst - bc12.rst - clock_control.rst - can/index.rst - charger.rst - comparator.rst - coredump.rst - counter.rst - crc.rst dac.rst - dma.rst - display/index.rst - eeprom/index.rst - espi.rst - entropy.rst - edac/index.rst - flash.rst - fuel_gauge.rst - gnss.rst - gpio.rst - haptics.rst - hwinfo.rst - hwspinlock.rst - i2c_eeprom_target.rst - i3c.rst + comparator.rst + opamp.rst + +.. _communication_peripherals: + +Communication +************* + +.. toctree:: + :maxdepth: 1 + + can/index.rst i2c.rst - ipm.rst - led.rst + i3c.rst + spi.rst + pcie.rst + uart.rst + espi.rst mdio.rst mspi.rst + smbus.rst + ipm.rst mbox.rst - opamp.rst - pcie.rst - peci.rst + w1.rst + +.. _display_peripherals: + +Display +******* + +.. toctree:: + :maxdepth: 1 + + display/index.rst + auxdisplay.rst + video.rst + led.rst + +.. _gpio_input_peripherals: + +GPIO & Input +************ + +.. toctree:: + :maxdepth: 1 + + gpio.rst ps2.rst - psi5.rst - pwm.rst - rtc.rst + tgpio.rst + +.. _memory_storage_peripherals: + +Memory & Storage +**************** + +.. toctree:: + :maxdepth: 1 + + flash.rst + eeprom/index.rst + sdhc.rst + bbram.rst + retained_mem.rst + i2c_eeprom_target.rst + +.. _power_peripherals: + +Power +***** + +.. toctree:: + :maxdepth: 1 + + bc12.rst + charger.rst + fuel_gauge.rst regulators.rst reset.rst - retained_mem.rst - sdhc.rst + tcpc.rst + usbc_vbus.rst + +.. _sensor_peripherals: + +Sensors +******* + +.. toctree:: + :maxdepth: 1 + sensor/index.rst + gnss.rst + psi5.rst sent.rst - spi.rst + +.. _motion_actuation_peripherals: + +Motion & Actuation +****************** + +.. toctree:: + :maxdepth: 1 + + haptics.rst + pwm.rst stepper.rst - smbus.rst - uart.rst - usbc_vbus.rst - tcpc.rst - tgpio.rst - video.rst + +.. _system_diagnostics_peripherals: + +System & Diagnostics +******************** + +.. toctree:: + :maxdepth: 1 + + hwinfo.rst + hwspinlock.rst + entropy.rst + edac/index.rst + coredump.rst + crc.rst + peci.rst + dma.rst + +.. _timing_peripherals: + +Timing +****** + +.. toctree:: + :maxdepth: 1 + + clock_control.rst + counter.rst + rtc.rst watchdog.rst From ac8a0453fa58d2d63b6c5b3d5dd14b0b6f4d69fa Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Benjamin=20Cab=C3=A9?= Date: Wed, 26 Nov 2025 22:30:57 +0100 Subject: [PATCH 5/7] doc: services: add structure/categorization to services index MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The very flat and unorganized list of services was really difficult to navigate, and not really helping people _discover_ services if they didn't already know what they were looking for. This tries to address that by adding some grouping. Signed-off-by: Benjamin Cabé --- doc/services/algorithms.rst | 13 +++ doc/services/application_services.rst | 14 +++ doc/services/communication.rst | 14 +++ doc/services/debugging.rst | 17 +++ doc/services/index.rst | 109 ++++++++++++------- doc/services/io.rst | 13 +++ doc/services/power_management.rst | 14 +++ doc/services/security.rst | 14 +++ doc/services/storage/flash_map/flash_map.rst | 2 +- doc/services/storage/index.rst | 6 +- doc/services/system.rst | 17 +++ 11 files changed, 192 insertions(+), 41 deletions(-) create mode 100644 doc/services/algorithms.rst create mode 100644 doc/services/application_services.rst create mode 100644 doc/services/communication.rst create mode 100644 doc/services/debugging.rst create mode 100644 doc/services/io.rst create mode 100644 doc/services/power_management.rst create mode 100644 doc/services/security.rst create mode 100644 doc/services/system.rst diff --git a/doc/services/algorithms.rst b/doc/services/algorithms.rst new file mode 100644 index 0000000000000..47ffb5d72252e --- /dev/null +++ b/doc/services/algorithms.rst @@ -0,0 +1,13 @@ +.. _algorithms_services: + +Algorithms +********** + +Algorithms for data transformation, encoding, and validation. + +.. toctree:: + :maxdepth: 1 + + crc/index.rst + dsp/index.rst + serialization/index.rst diff --git a/doc/services/application_services.rst b/doc/services/application_services.rst new file mode 100644 index 0000000000000..cce1d672aa6f7 --- /dev/null +++ b/doc/services/application_services.rst @@ -0,0 +1,14 @@ +.. _application_framework_services: + +Application Services +******************** + +High-level frameworks and libraries for application development. + +.. toctree:: + :maxdepth: 1 + + smf/index.rst + sensing/index.rst + device_mgmt/index + llext/index.rst diff --git a/doc/services/communication.rst b/doc/services/communication.rst new file mode 100644 index 0000000000000..c175da393efd3 --- /dev/null +++ b/doc/services/communication.rst @@ -0,0 +1,14 @@ +.. _communication_services: + +Communication +************* + +Inter-thread, inter-processor, and external communication mechanisms. + +.. toctree:: + :maxdepth: 1 + + zbus/index.rst + ipc/index.rst + modem/index.rst + virtualization/index.rst diff --git a/doc/services/debugging.rst b/doc/services/debugging.rst new file mode 100644 index 0000000000000..782c1f666d22f --- /dev/null +++ b/doc/services/debugging.rst @@ -0,0 +1,17 @@ +.. _debugging_observability_services: + +Debugging & Observability +************************* + +Logging, tracing, shell, and other debugging and observability tools. + +.. toctree:: + :maxdepth: 1 + + logging/index.rst + tracing/index.rst + debugging/index.rst + profiling/index.rst + instrumentation/index.rst + cpu_load/index.rst + shell/index.rst diff --git a/doc/services/index.rst b/doc/services/index.rst index 695df407e5f4e..0d20245646b94 100644 --- a/doc/services/index.rst +++ b/doc/services/index.rst @@ -3,42 +3,77 @@ OS Services ########### +Zephyr provides a comprehensive set of subsystems and associated services that applications can +leverage. These services provide standardized APIs that abstract hardware implementation details, +enabling application portability across different platforms. + +.. grid:: 1 1 2 2 + :gutter: 2 + + .. grid-item-card:: :material-twotone:`memory;36px` System + :link: system_services + :link-type: ref + + Memory management, low-level infrastructure, and other utility APIs. + + .. grid-item-card:: :material-twotone:`bug_report;36px` Debugging & Observability + :link: debugging_observability_services + :link-type: ref + + Logging, tracing, shell, and other debugging and observability tools. + + .. grid-item-card:: :material-twotone:`import_export;36px` Input / Output + :link: io_services + :link-type: ref + + Console, input devices abstraction, and other I/O utilities. + + .. grid-item-card:: :material-twotone:`save;36px` Storage & Configuration + :link: storage_services + :link-type: ref + + Flash access, file systems, key-value stores, and persistent data. + + .. grid-item-card:: :material-twotone:`battery_charging_80;36px` Power Management + :link: power_management_services + :link-type: ref + + Energy consumption, performance scaling, and resource lifecycle control. + + .. grid-item-card:: :material-twotone:`chat_bubble;36px` Communication + :link: communication_services + :link-type: ref + + Inter-thread, inter-processor, and external communication mechanisms. + + .. grid-item-card:: :material-twotone:`security;36px` Security & Identity + :link: security_services + :link-type: ref + + Cryptographic primitives, trusted execution environments, and identity services. + + .. grid-item-card:: :material-twotone:`data_object;36px` Algorithms + :link: algorithms_services + :link-type: ref + + Algorithms for data transformation, encoding, and validation. + + .. grid-item-card:: :material-twotone:`widgets;36px` Application Services + :link: application_framework_services + :link-type: ref + + High-level frameworks and libraries for application development. + .. toctree:: - :maxdepth: 1 - - binary_descriptors/index.rst - console.rst - cpu_freq/index.rst - cpu_load/index.rst - crc/index.rst - crypto/index - debugging/index.rst - device_mgmt/index - dsp/index.rst - formatted_output.rst - input/index.rst - instrumentation/index.rst - ipc/index.rst - llext/index.rst - logging/index.rst - tracing/index.rst - resource_management/index.rst - mem_mgmt/index.rst - net_buf/index.rst - modem/index.rst - notify.rst - pm/index.rst - portability/index.rst - poweroff.rst - profiling/index.rst - shell/index.rst - serialization/index.rst - smf/index.rst + :maxdepth: 2 + :hidden: + + system.rst + debugging.rst + io.rst storage/index.rst - sensing/index.rst - task_wdt/index.rst - tfm/index - virtualization/index.rst - rtio/index.rst - zbus/index.rst - misc.rst + power_management.rst + communication.rst + security.rst + algorithms.rst + application_services.rst diff --git a/doc/services/io.rst b/doc/services/io.rst new file mode 100644 index 0000000000000..09d67fddcc489 --- /dev/null +++ b/doc/services/io.rst @@ -0,0 +1,13 @@ +.. _io_services: + +Input / Output +************** + +Input and Output (I/O) services for handling user interaction and data formatting. + +.. toctree:: + :maxdepth: 1 + + console.rst + input/index.rst + formatted_output.rst diff --git a/doc/services/power_management.rst b/doc/services/power_management.rst new file mode 100644 index 0000000000000..36f39db3905aa --- /dev/null +++ b/doc/services/power_management.rst @@ -0,0 +1,14 @@ +.. _power_management_services: + +Power Management +**************** + +Energy consumption, performance scaling, and resource lifecycle control. + +.. toctree:: + :maxdepth: 1 + + pm/index.rst + cpu_freq/index.rst + poweroff.rst + resource_management/index.rst diff --git a/doc/services/security.rst b/doc/services/security.rst new file mode 100644 index 0000000000000..fd66ef68a27f3 --- /dev/null +++ b/doc/services/security.rst @@ -0,0 +1,14 @@ +.. _security_services: + +Security & Identity +******************* + +Cryptographic primitives, trusted execution environments, and identity services. + +.. toctree:: + :maxdepth: 1 + + crypto/index + tfm/index + uuid/index + jwt/index diff --git a/doc/services/storage/flash_map/flash_map.rst b/doc/services/storage/flash_map/flash_map.rst index 6a90cc628f275..0e34b1aa4e752 100644 --- a/doc/services/storage/flash_map/flash_map.rst +++ b/doc/services/storage/flash_map/flash_map.rst @@ -52,7 +52,7 @@ The flash_map.h API uses data generated from the :ref:`devicetree_api`, in particular its :ref:`devicetree-flash-api`. Zephyr additionally has some partitioning conventions used for :ref:`dfu` via the MCUboot bootloader, as well as defining partitions usable by :ref:`file systems ` or -other nonvolatile :ref:`storage `. +other non-volatile :ref:`storage `. Here is an example devicetree fragment which uses fixed flash partitions for both MCUboot and a storage partition. Some details were left out for clarity. diff --git a/doc/services/storage/index.rst b/doc/services/storage/index.rst index 046f34dfb6044..5ebc441108913 100644 --- a/doc/services/storage/index.rst +++ b/doc/services/storage/index.rst @@ -1,7 +1,7 @@ -.. _storage_reference: +.. _storage_services: -Storage -####### +Storage & Configuration +####################### .. toctree:: :maxdepth: 1 diff --git a/doc/services/system.rst b/doc/services/system.rst new file mode 100644 index 0000000000000..3a5df7c2065bf --- /dev/null +++ b/doc/services/system.rst @@ -0,0 +1,17 @@ +.. _system_services: + +System +****** + +Memory management, low-level infrastructure, and other utility APIs. + +.. toctree:: + :maxdepth: 1 + + mem_mgmt/index.rst + net_buf/index.rst + rtio/index.rst + notify.rst + binary_descriptors/index.rst + portability/index.rst + task_wdt/index.rst From d3e2d8d8b0aff91c47c450ff4d60a32106a7645d Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 1 Dec 2025 23:12:16 +0000 Subject: [PATCH 6/7] Initial plan From 09cfb9743d5e368a3310a31ae7006bffd6de88a9 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 1 Dec 2025 23:17:06 +0000 Subject: [PATCH 7/7] Move connectivity/ to services/connectivity/ and update references Co-authored-by: kartben <128251+kartben@users.noreply.github.com> --- doc/index.rst | 1 - doc/releases/release-notes-4.2.rst | 2 +- .../connectivity/bluetooth/api/a2dp.rst | 0 .../connectivity/bluetooth/api/att.rst | 0 .../connectivity/bluetooth/api/audio/audio.rst | 0 .../connectivity/bluetooth/api/audio/bap.rst | 0 .../bluetooth/api/audio/bluetooth-le-audio-arch.rst | 0 .../connectivity/bluetooth/api/audio/cap.rst | 0 .../bluetooth/api/audio/coordinated_sets.rst | 0 .../bluetooth/api/audio/img/cap_proc.svg | 0 .../connectivity/bluetooth/api/audio/media.rst | 0 .../connectivity/bluetooth/api/audio/microphone.rst | 0 .../connectivity/bluetooth/api/audio/volume.rst | 0 .../connectivity/bluetooth/api/connection_mgmt.rst | 0 .../connectivity/bluetooth/api/controller.rst | 0 .../connectivity/bluetooth/api/crypto.rst | 0 .../connectivity/bluetooth/api/data_buffer.rst | 0 .../connectivity/bluetooth/api/gap.rst | 0 .../connectivity/bluetooth/api/gatt.rst | 0 .../connectivity/bluetooth/api/hci.txt | 0 .../connectivity/bluetooth/api/hci_drivers.rst | 0 .../connectivity/bluetooth/api/hci_raw.rst | 0 .../connectivity/bluetooth/api/hfp.rst | 0 .../connectivity/bluetooth/api/index.rst | 0 .../connectivity/bluetooth/api/l2cap.rst | 0 .../connectivity/bluetooth/api/mesh.rst | 0 .../connectivity/bluetooth/api/mesh/access.rst | 0 .../connectivity/bluetooth/api/mesh/blob.rst | 0 .../connectivity/bluetooth/api/mesh/blob_cli.rst | 0 .../connectivity/bluetooth/api/mesh/blob_flash.rst | 0 .../connectivity/bluetooth/api/mesh/blob_srv.rst | 0 .../connectivity/bluetooth/api/mesh/brg_cfg.rst | 0 .../connectivity/bluetooth/api/mesh/brg_cfg_cli.rst | 0 .../connectivity/bluetooth/api/mesh/brg_cfg_srv.rst | 0 .../connectivity/bluetooth/api/mesh/cfg.rst | 0 .../connectivity/bluetooth/api/mesh/cfg_cli.rst | 0 .../connectivity/bluetooth/api/mesh/cfg_srv.rst | 0 .../connectivity/bluetooth/api/mesh/core.rst | 0 .../connectivity/bluetooth/api/mesh/dfd_srv.rst | 0 .../connectivity/bluetooth/api/mesh/dfu.rst | 0 .../connectivity/bluetooth/api/mesh/dfu_cli.rst | 0 .../connectivity/bluetooth/api/mesh/dfu_srv.rst | 0 .../connectivity/bluetooth/api/mesh/health_cli.rst | 0 .../connectivity/bluetooth/api/mesh/health_srv.rst | 0 .../connectivity/bluetooth/api/mesh/heartbeat.rst | 0 .../bluetooth/api/mesh/images/blob_srv.svg | 0 .../bluetooth/api/mesh/images/blob_srv.xml | 0 .../bluetooth/api/mesh/images/dfu_roles_mesh.svg | 0 .../bluetooth/api/mesh/images/dfu_srv.svg | 0 .../bluetooth/api/mesh/images/dfu_srv.xml | 0 .../api/mesh/images/dfu_stages_procedures_mesh.svg | 0 .../connectivity/bluetooth/api/mesh/lcd_cli.rst | 0 .../connectivity/bluetooth/api/mesh/lcd_srv.rst | 0 .../connectivity/bluetooth/api/mesh/models.rst | 0 .../connectivity/bluetooth/api/mesh/msg.rst | 0 .../connectivity/bluetooth/api/mesh/od_cli.rst | 0 .../connectivity/bluetooth/api/mesh/od_srv.rst | 0 .../connectivity/bluetooth/api/mesh/op_agg_cli.rst | 0 .../connectivity/bluetooth/api/mesh/op_agg_srv.rst | 0 .../bluetooth/api/mesh/priv_beacon_cli.rst | 0 .../bluetooth/api/mesh/priv_beacon_srv.rst | 0 .../bluetooth/api/mesh/provisioning.rst | 0 .../connectivity/bluetooth/api/mesh/proxy.rst | 0 .../connectivity/bluetooth/api/mesh/rpr_cli.rst | 0 .../connectivity/bluetooth/api/mesh/rpr_srv.rst | 0 .../connectivity/bluetooth/api/mesh/sar_cfg.rst | 0 .../connectivity/bluetooth/api/mesh/sar_cfg_cli.rst | 0 .../connectivity/bluetooth/api/mesh/sar_cfg_srv.rst | 0 .../connectivity/bluetooth/api/mesh/shell.rst | 0 .../connectivity/bluetooth/api/mesh/srpl_cli.rst | 0 .../connectivity/bluetooth/api/mesh/srpl_srv.rst | 0 .../connectivity/bluetooth/api/mesh/statistic.rst | 0 .../connectivity/bluetooth/api/rfcomm.rst | 0 .../connectivity/bluetooth/api/sdp.rst | 0 .../connectivity/bluetooth/api/services.rst | 0 .../connectivity/bluetooth/api/uuid.rst | 0 .../bluetooth/autopts/add_socat_to_path.png | Bin .../bluetooth/autopts/allow_firewall.png | Bin .../bluetooth/autopts/allow_firewall_2.png | Bin .../bluetooth/autopts/autopts-linux.rst | 0 .../bluetooth/autopts/autopts-win10.rst | 0 .../bluetooth/autopts/autoptsclient_run.png | Bin .../bluetooth/autopts/autoptsclient_run_2.png | Bin .../bluetooth/autopts/autoptsserver_run.png | Bin .../bluetooth/autopts/autoptsserver_run_2.png | Bin .../autopts/autoptsserver_typical_error.png | Bin .../bluetooth/autopts/device_manager.png | Bin .../connectivity/bluetooth/autopts/devices_1.png | Bin .../connectivity/bluetooth/autopts/devices_2.png | Bin .../bluetooth/autopts/download_nrftools_linux.png | Bin .../bluetooth/autopts/download_nrftools_windows.png | Bin .../bluetooth/autopts/download_socat.png | Bin .../connectivity/bluetooth/autopts/install_git.png | Bin .../bluetooth/autopts/install_pts_drivers.png | Bin .../bluetooth/autopts/install_python1.png | Bin .../bluetooth/autopts/install_python2.png | Bin .../bluetooth/autopts/install_ubuntu_on_wsl.png | Bin .../bluetooth/autopts/pts_automation_window.png | Bin .../bluetooth/autopts/ubuntu_first_launch.png | Bin .../bluetooth/autopts/usb-devices_output.png | Bin .../bluetooth/autopts/virtualbox_nat_1.png | Bin .../bluetooth/autopts/virtualbox_nat_2.png | Bin .../bluetooth/autopts/virtualbox_static_ip_1.png | Bin .../bluetooth/autopts/virtualbox_static_ip_2.png | Bin .../bluetooth/autopts/vmware_static_ip_1.png | Bin .../bluetooth/autopts/vmware_static_ip_2.png | Bin .../bluetooth/autopts/vmware_static_ip_3.png | Bin .../bluetooth/autopts/windows_static_ip.png | Bin .../connectivity/bluetooth/bluetooth-arch.rst | 2 +- .../connectivity/bluetooth/bluetooth-ctlr-arch.rst | 0 .../connectivity/bluetooth/bluetooth-dev.rst | 0 .../connectivity/bluetooth/bluetooth-le-host.rst | 0 .../connectivity/bluetooth/bluetooth-qual.rst | 0 .../connectivity/bluetooth/bluetooth-shell.rst | 0 .../connectivity/bluetooth/bluetooth-tools.rst | 0 .../connectivity/bluetooth/features.rst | 0 .../connectivity/bluetooth/img/att_timeout.svg | 0 .../connectivity/bluetooth/img/ble_cfg_dual.png | Bin .../connectivity/bluetooth/img/ble_cfg_dual.xml | 0 .../connectivity/bluetooth/img/ble_cfg_single.png | Bin .../connectivity/bluetooth/img/ble_cfg_single.xml | 0 .../connectivity/bluetooth/img/ble_host_layers.png | Bin .../connectivity/bluetooth/img/ble_host_layers.xml | 0 .../bluetooth/img/ctlr_arch_overview.png | Bin .../connectivity/bluetooth/img/ctlr_dataflow_rx.png | Bin .../connectivity/bluetooth/img/ctlr_dataflow_tx.png | Bin .../connectivity/bluetooth/img/ctlr_exec_lll.png | Bin .../bluetooth/img/ctlr_exec_lll_resume_bottom.png | Bin .../bluetooth/img/ctlr_exec_lll_resume_top.png | Bin .../bluetooth/img/ctlr_exec_overview.png | Bin .../connectivity/bluetooth/img/ctlr_exec_prio.png | Bin .../connectivity/bluetooth/img/ctlr_legacy.png | Bin .../connectivity/bluetooth/img/ctlr_mayfly.png | Bin .../connectivity/bluetooth/img/ctlr_mfifo_memq.png | Bin .../connectivity/bluetooth/img/ctlr_overview.png | Bin .../connectivity/bluetooth/img/ctlr_sched.png | Bin .../bluetooth/img/ctlr_sched_event_handling.png | Bin .../bluetooth/img/ctlr_sched_msc_close_events.png | Bin .../bluetooth/img/ctlr_sched_msc_event_abort.png | Bin .../bluetooth/img/ctlr_sched_msc_event_cancel.png | Bin .../bluetooth/img/ctlr_sched_msc_event_preempt.png | Bin .../bluetooth/img/ctlr_sched_ticker.png | Bin .../bluetooth/img/ctlr_sched_ull_lll.png | Bin .../bluetooth/img/ctlr_sched_ull_lll_timing.png | Bin .../bluetooth/img/ctlr_sched_variant.png | Bin .../bluetooth/img/l2cap_b_frame.drawio.svg | 0 .../bluetooth/img/l2cap_k_frame.drawio.svg | 0 .../bluetooth/img/l2cap_k_frame_1.drawio.svg | 0 doc/{ => services}/connectivity/bluetooth/index.rst | 0 .../connectivity/bluetooth/shell/audio/bap.rst | 0 .../shell/audio/bap_broadcast_assistant.rst | 0 .../bluetooth/shell/audio/bap_scan_delegator.rst | 0 .../connectivity/bluetooth/shell/audio/cap.rst | 0 .../connectivity/bluetooth/shell/audio/ccp.rst | 0 .../connectivity/bluetooth/shell/audio/csip.rst | 0 .../connectivity/bluetooth/shell/audio/gmap.rst | 0 .../connectivity/bluetooth/shell/audio/mcp.rst | 0 .../connectivity/bluetooth/shell/audio/pbp.rst | 0 .../connectivity/bluetooth/shell/audio/tbs.rst | 0 .../connectivity/bluetooth/shell/audio/tmap.rst | 0 .../connectivity/bluetooth/shell/classic/a2dp.rst | 0 .../connectivity/bluetooth/shell/classic/goep.rst | 0 .../connectivity/bluetooth/shell/classic/hfp.rst | 0 .../connectivity/bluetooth/shell/classic/l2cap.rst | 0 .../connectivity/bluetooth/shell/classic/rfcomm.rst | 0 .../connectivity/bluetooth/shell/host/gap.rst | 0 .../connectivity/bluetooth/shell/host/gatt.rst | 0 .../connectivity/bluetooth/shell/host/iso.rst | 0 .../connectivity/bluetooth/shell/host/l2cap.rst | 0 doc/{ => services}/connectivity/canbus/index.rst | 0 doc/{ => services}/connectivity/canbus/isotp.rst | 0 .../connectivity/canbus/isotp_sequence.svg | 0 doc/{ => services}/connectivity/index.rst | 0 .../connectivity/lora_lorawan/index.rst | 0 doc/{ => services}/connectivity/modbus/index.rst | 0 .../connectivity/networking/api/8021Qav.rst | 0 .../connectivity/networking/api/apis.rst | 0 .../connectivity/networking/api/buf_mgmt.rst | 0 .../connectivity/networking/api/capture.rst | 0 .../connectivity/networking/api/coap.rst | 0 .../connectivity/networking/api/coap_client.rst | 0 .../connectivity/networking/api/coap_server.rst | 0 .../connectivity/networking/api/dhcpv4.rst | 0 .../connectivity/networking/api/dhcpv6.rst | 0 .../connectivity/networking/api/dns_resolve.rst | 0 .../connectivity/networking/api/ethernet.rst | 0 .../connectivity/networking/api/ethernet_mgmt.rst | 0 .../connectivity/networking/api/gptp.rst | 0 .../connectivity/networking/api/http_client.rst | 0 .../connectivity/networking/api/http_server.rst | 0 .../connectivity/networking/api/ieee802154.rst | 0 .../api/images/lwm2m_engine_state_machine.svg | 0 .../networking/api/images/lwm2m_lifetime_both.png | Bin .../api/images/lwm2m_lifetime_seconds_early.png | Bin .../connectivity/networking/api/index.rst | 0 .../connectivity/networking/api/ip_4_6.rst | 0 .../connectivity/networking/api/latmon.rst | 0 .../connectivity/networking/api/lldp.rst | 0 .../connectivity/networking/api/lwm2m.rst | 0 .../connectivity/networking/api/mac_config.rst | 0 .../connectivity/networking/api/mqtt.rst | 0 .../connectivity/networking/api/mqtt_sn.rst | 0 .../connectivity/networking/api/net_config.rst | 0 .../connectivity/networking/api/net_context.rst | 0 .../connectivity/networking/api/net_core.rst | 0 .../connectivity/networking/api/net_hostname.rst | 0 .../connectivity/networking/api/net_if.rst | 0 .../connectivity/networking/api/net_l2.rst | 0 .../connectivity/networking/api/net_linkaddr.rst | 0 .../connectivity/networking/api/net_mgmt.rst | 0 .../connectivity/networking/api/net_offload.rst | 0 .../connectivity/networking/api/net_pkt.rst | 0 .../connectivity/networking/api/net_pkt_filter.rst | 0 .../connectivity/networking/api/net_shell.rst | 0 .../connectivity/networking/api/net_stats.rst | 0 .../connectivity/networking/api/net_tech.rst | 0 .../connectivity/networking/api/net_time.rst | 0 .../connectivity/networking/api/net_timeout.rst | 0 .../connectivity/networking/api/ocpp.rst | 0 .../connectivity/networking/api/ppp.rst | 0 .../connectivity/networking/api/promiscuous.rst | 0 .../connectivity/networking/api/protocols.rst | 0 .../connectivity/networking/api/ptp.rst | 0 .../connectivity/networking/api/ptp_time.rst | 0 .../connectivity/networking/api/sntp.rst | 0 .../connectivity/networking/api/socket_service.rst | 0 .../connectivity/networking/api/sockets.rst | 0 .../connectivity/networking/api/socks5.rst | 0 .../connectivity/networking/api/system_mgmt.rst | 0 .../connectivity/networking/api/tftp.rst | 0 .../connectivity/networking/api/thread.rst | 0 .../networking/api/tls_credentials_shell.rst | 0 .../connectivity/networking/api/traffic-class.rst | 0 .../connectivity/networking/api/trickle.rst | 0 .../connectivity/networking/api/tsn.rst | 0 .../connectivity/networking/api/vlan.rst | 0 .../connectivity/networking/api/websocket.rst | 0 .../connectivity/networking/api/wifi.rst | 0 .../networking/api/wifi_credentials.rst | 0 .../connectivity/networking/api/zperf.rst | 0 .../networking/armfvp_user_networking_setup.rst | 0 .../networking/conn_mgr/figures/.gitignore | 0 .../figures/integration_diagram_detailed.drawio | 0 .../figures/integration_diagram_detailed.svg | 0 .../figures/integration_diagram_simplified.drawio | 0 .../figures/integration_diagram_simplified.svg | 0 .../networking/conn_mgr/implementation.rst | 0 .../connectivity/networking/conn_mgr/index.rst | 0 .../connectivity/networking/conn_mgr/main.rst | 0 doc/{ => services}/connectivity/networking/dsa.rst | 0 .../connectivity/networking/dsa_txrx_process.svg | 0 .../networking/eth_bridge_native_sim_setup.rst | 0 .../connectivity/networking/index.rst | 0 .../connectivity/networking/native_sim_setup.rst | 0 .../networking/net-stack-architecture.rst | 0 .../connectivity/networking/net_config_guide.rst | 0 .../networking/net_pkt_processing_stats.rst | 0 .../connectivity/networking/network_monitoring.rst | 0 .../connectivity/networking/network_tracing.rst | 0 .../networking/networking_with_host.rst | 0 .../networking_with_multiple_instances.rst | 0 .../connectivity/networking/overview.rst | 0 .../connectivity/networking/qemu_802154_setup.rst | 0 .../connectivity/networking/qemu_eth_setup.rst | 0 .../connectivity/networking/qemu_setup.rst | 0 .../connectivity/networking/qemu_user_setup.rst | 0 .../connectivity/networking/usbnet_setup.rst | 0 .../zephyr_netstack_overview-rx_sequence.svg | 0 .../zephyr_netstack_overview-tx_sequence.svg | 0 .../networking/zephyr_netstack_overview.jpg | Bin .../networking/zephyr_netstack_overview.svg | 0 .../networking/zephyr_netstack_overview.vsdx | Bin doc/{ => services}/connectivity/usb/api/hid.rst | 0 .../connectivity/usb/device/api/index.rst | 0 .../connectivity/usb/device/api/usb_dc.rst | 0 .../connectivity/usb/device/api/usb_device.rst | 0 .../connectivity/usb/device/api/usb_device_bos.rst | 0 .../connectivity/usb/device/api/usb_device_hid.rst | 0 .../connectivity/usb/device/usb_device.rst | 0 .../connectivity/usb/device_next/api/index.rst | 0 .../usb/device_next/api/uac2_device.rst | 0 .../connectivity/usb/device_next/api/udc.rst | 0 .../connectivity/usb/device_next/api/usbd.rst | 0 .../connectivity/usb/device_next/api/usbd_dfu.rst | 0 .../usb/device_next/api/usbd_hid_device.rst | 0 .../connectivity/usb/device_next/api/usbd_midi2.rst | 0 .../usb/device_next/api/usbd_msc_device.rst | 0 .../connectivity/usb/device_next/usb_device.rst | 0 .../connectivity/usb/host/api/index.rst | 0 .../connectivity/usb/host/api/uhc.rst | 0 doc/{ => services}/connectivity/usb/host/usbip.rst | 0 doc/{ => services}/connectivity/usb/index.rst | 0 doc/{ => services}/connectivity/usb/pd/ucds.rst | 0 doc/services/index.rst | 7 +++++++ 294 files changed, 9 insertions(+), 3 deletions(-) rename doc/{ => services}/connectivity/bluetooth/api/a2dp.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/att.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/audio/audio.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/audio/bap.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/audio/bluetooth-le-audio-arch.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/audio/cap.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/audio/coordinated_sets.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/audio/img/cap_proc.svg (100%) rename doc/{ => services}/connectivity/bluetooth/api/audio/media.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/audio/microphone.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/audio/volume.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/connection_mgmt.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/controller.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/crypto.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/data_buffer.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/gap.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/gatt.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/hci.txt (100%) rename doc/{ => services}/connectivity/bluetooth/api/hci_drivers.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/hci_raw.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/hfp.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/index.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/l2cap.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/access.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/blob.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/blob_cli.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/blob_flash.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/blob_srv.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/brg_cfg.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/brg_cfg_cli.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/brg_cfg_srv.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/cfg.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/cfg_cli.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/cfg_srv.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/core.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/dfd_srv.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/dfu.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/dfu_cli.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/dfu_srv.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/health_cli.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/health_srv.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/heartbeat.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/images/blob_srv.svg (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/images/blob_srv.xml (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/images/dfu_roles_mesh.svg (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/images/dfu_srv.svg (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/images/dfu_srv.xml (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/images/dfu_stages_procedures_mesh.svg (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/lcd_cli.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/lcd_srv.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/models.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/msg.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/od_cli.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/od_srv.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/op_agg_cli.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/op_agg_srv.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/priv_beacon_cli.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/priv_beacon_srv.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/provisioning.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/proxy.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/rpr_cli.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/rpr_srv.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/sar_cfg.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/sar_cfg_cli.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/sar_cfg_srv.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/shell.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/srpl_cli.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/srpl_srv.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/mesh/statistic.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/rfcomm.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/sdp.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/services.rst (100%) rename doc/{ => services}/connectivity/bluetooth/api/uuid.rst (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/add_socat_to_path.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/allow_firewall.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/allow_firewall_2.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/autopts-linux.rst (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/autopts-win10.rst (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/autoptsclient_run.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/autoptsclient_run_2.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/autoptsserver_run.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/autoptsserver_run_2.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/autoptsserver_typical_error.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/device_manager.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/devices_1.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/devices_2.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/download_nrftools_linux.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/download_nrftools_windows.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/download_socat.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/install_git.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/install_pts_drivers.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/install_python1.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/install_python2.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/install_ubuntu_on_wsl.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/pts_automation_window.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/ubuntu_first_launch.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/usb-devices_output.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/virtualbox_nat_1.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/virtualbox_nat_2.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/virtualbox_static_ip_1.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/virtualbox_static_ip_2.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/vmware_static_ip_1.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/vmware_static_ip_2.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/vmware_static_ip_3.png (100%) rename doc/{ => services}/connectivity/bluetooth/autopts/windows_static_ip.png (100%) rename doc/{ => services}/connectivity/bluetooth/bluetooth-arch.rst (99%) rename doc/{ => services}/connectivity/bluetooth/bluetooth-ctlr-arch.rst (100%) rename doc/{ => services}/connectivity/bluetooth/bluetooth-dev.rst (100%) rename doc/{ => services}/connectivity/bluetooth/bluetooth-le-host.rst (100%) rename doc/{ => services}/connectivity/bluetooth/bluetooth-qual.rst (100%) rename doc/{ => services}/connectivity/bluetooth/bluetooth-shell.rst (100%) rename doc/{ => services}/connectivity/bluetooth/bluetooth-tools.rst (100%) rename doc/{ => services}/connectivity/bluetooth/features.rst (100%) rename doc/{ => services}/connectivity/bluetooth/img/att_timeout.svg (100%) rename doc/{ => services}/connectivity/bluetooth/img/ble_cfg_dual.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ble_cfg_dual.xml (100%) rename doc/{ => services}/connectivity/bluetooth/img/ble_cfg_single.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ble_cfg_single.xml (100%) rename doc/{ => services}/connectivity/bluetooth/img/ble_host_layers.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ble_host_layers.xml (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_arch_overview.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_dataflow_rx.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_dataflow_tx.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_exec_lll.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_exec_lll_resume_bottom.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_exec_lll_resume_top.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_exec_overview.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_exec_prio.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_legacy.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_mayfly.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_mfifo_memq.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_overview.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_sched.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_sched_event_handling.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_sched_msc_close_events.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_sched_msc_event_abort.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_sched_msc_event_cancel.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_sched_msc_event_preempt.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_sched_ticker.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_sched_ull_lll.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_sched_ull_lll_timing.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/ctlr_sched_variant.png (100%) rename doc/{ => services}/connectivity/bluetooth/img/l2cap_b_frame.drawio.svg (100%) rename doc/{ => services}/connectivity/bluetooth/img/l2cap_k_frame.drawio.svg (100%) rename doc/{ => services}/connectivity/bluetooth/img/l2cap_k_frame_1.drawio.svg (100%) rename doc/{ => services}/connectivity/bluetooth/index.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/audio/bap.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/audio/bap_broadcast_assistant.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/audio/bap_scan_delegator.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/audio/cap.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/audio/ccp.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/audio/csip.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/audio/gmap.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/audio/mcp.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/audio/pbp.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/audio/tbs.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/audio/tmap.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/classic/a2dp.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/classic/goep.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/classic/hfp.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/classic/l2cap.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/classic/rfcomm.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/host/gap.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/host/gatt.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/host/iso.rst (100%) rename doc/{ => services}/connectivity/bluetooth/shell/host/l2cap.rst (100%) rename doc/{ => services}/connectivity/canbus/index.rst (100%) rename doc/{ => services}/connectivity/canbus/isotp.rst (100%) rename doc/{ => services}/connectivity/canbus/isotp_sequence.svg (100%) rename doc/{ => services}/connectivity/index.rst (100%) rename doc/{ => services}/connectivity/lora_lorawan/index.rst (100%) rename doc/{ => services}/connectivity/modbus/index.rst (100%) rename doc/{ => services}/connectivity/networking/api/8021Qav.rst (100%) rename doc/{ => services}/connectivity/networking/api/apis.rst (100%) rename doc/{ => services}/connectivity/networking/api/buf_mgmt.rst (100%) rename doc/{ => services}/connectivity/networking/api/capture.rst (100%) rename doc/{ => services}/connectivity/networking/api/coap.rst (100%) rename doc/{ => services}/connectivity/networking/api/coap_client.rst (100%) rename doc/{ => services}/connectivity/networking/api/coap_server.rst (100%) rename doc/{ => services}/connectivity/networking/api/dhcpv4.rst (100%) rename doc/{ => services}/connectivity/networking/api/dhcpv6.rst (100%) rename doc/{ => services}/connectivity/networking/api/dns_resolve.rst (100%) rename doc/{ => services}/connectivity/networking/api/ethernet.rst (100%) rename doc/{ => services}/connectivity/networking/api/ethernet_mgmt.rst (100%) rename doc/{ => services}/connectivity/networking/api/gptp.rst (100%) rename doc/{ => services}/connectivity/networking/api/http_client.rst (100%) rename doc/{ => services}/connectivity/networking/api/http_server.rst (100%) rename doc/{ => services}/connectivity/networking/api/ieee802154.rst (100%) rename doc/{ => services}/connectivity/networking/api/images/lwm2m_engine_state_machine.svg (100%) rename doc/{ => services}/connectivity/networking/api/images/lwm2m_lifetime_both.png (100%) rename doc/{ => services}/connectivity/networking/api/images/lwm2m_lifetime_seconds_early.png (100%) rename doc/{ => services}/connectivity/networking/api/index.rst (100%) rename doc/{ => services}/connectivity/networking/api/ip_4_6.rst (100%) rename doc/{ => services}/connectivity/networking/api/latmon.rst (100%) rename doc/{ => services}/connectivity/networking/api/lldp.rst (100%) rename doc/{ => services}/connectivity/networking/api/lwm2m.rst (100%) rename doc/{ => services}/connectivity/networking/api/mac_config.rst (100%) rename doc/{ => services}/connectivity/networking/api/mqtt.rst (100%) rename doc/{ => services}/connectivity/networking/api/mqtt_sn.rst (100%) rename doc/{ => services}/connectivity/networking/api/net_config.rst (100%) rename doc/{ => services}/connectivity/networking/api/net_context.rst (100%) rename doc/{ => services}/connectivity/networking/api/net_core.rst (100%) rename doc/{ => services}/connectivity/networking/api/net_hostname.rst (100%) rename doc/{ => services}/connectivity/networking/api/net_if.rst (100%) rename doc/{ => services}/connectivity/networking/api/net_l2.rst (100%) rename doc/{ => services}/connectivity/networking/api/net_linkaddr.rst (100%) rename doc/{ => services}/connectivity/networking/api/net_mgmt.rst (100%) rename doc/{ => services}/connectivity/networking/api/net_offload.rst (100%) rename doc/{ => services}/connectivity/networking/api/net_pkt.rst (100%) rename doc/{ => services}/connectivity/networking/api/net_pkt_filter.rst (100%) rename doc/{ => services}/connectivity/networking/api/net_shell.rst (100%) rename doc/{ => services}/connectivity/networking/api/net_stats.rst (100%) rename doc/{ => services}/connectivity/networking/api/net_tech.rst (100%) rename doc/{ => services}/connectivity/networking/api/net_time.rst (100%) rename doc/{ => services}/connectivity/networking/api/net_timeout.rst (100%) rename doc/{ => services}/connectivity/networking/api/ocpp.rst (100%) rename doc/{ => services}/connectivity/networking/api/ppp.rst (100%) rename doc/{ => services}/connectivity/networking/api/promiscuous.rst (100%) rename doc/{ => services}/connectivity/networking/api/protocols.rst (100%) rename doc/{ => services}/connectivity/networking/api/ptp.rst (100%) rename doc/{ => services}/connectivity/networking/api/ptp_time.rst (100%) rename doc/{ => services}/connectivity/networking/api/sntp.rst (100%) rename doc/{ => services}/connectivity/networking/api/socket_service.rst (100%) rename doc/{ => services}/connectivity/networking/api/sockets.rst (100%) rename doc/{ => services}/connectivity/networking/api/socks5.rst (100%) rename doc/{ => services}/connectivity/networking/api/system_mgmt.rst (100%) rename doc/{ => services}/connectivity/networking/api/tftp.rst (100%) rename doc/{ => services}/connectivity/networking/api/thread.rst (100%) rename doc/{ => services}/connectivity/networking/api/tls_credentials_shell.rst (100%) rename doc/{ => services}/connectivity/networking/api/traffic-class.rst (100%) rename doc/{ => services}/connectivity/networking/api/trickle.rst (100%) rename doc/{ => services}/connectivity/networking/api/tsn.rst (100%) rename doc/{ => services}/connectivity/networking/api/vlan.rst (100%) rename doc/{ => services}/connectivity/networking/api/websocket.rst (100%) rename doc/{ => services}/connectivity/networking/api/wifi.rst (100%) rename doc/{ => services}/connectivity/networking/api/wifi_credentials.rst (100%) rename doc/{ => services}/connectivity/networking/api/zperf.rst (100%) rename doc/{ => services}/connectivity/networking/armfvp_user_networking_setup.rst (100%) rename doc/{ => services}/connectivity/networking/conn_mgr/figures/.gitignore (100%) rename doc/{ => services}/connectivity/networking/conn_mgr/figures/integration_diagram_detailed.drawio (100%) rename doc/{ => services}/connectivity/networking/conn_mgr/figures/integration_diagram_detailed.svg (100%) rename doc/{ => services}/connectivity/networking/conn_mgr/figures/integration_diagram_simplified.drawio (100%) rename doc/{ => services}/connectivity/networking/conn_mgr/figures/integration_diagram_simplified.svg (100%) rename doc/{ => services}/connectivity/networking/conn_mgr/implementation.rst (100%) rename doc/{ => services}/connectivity/networking/conn_mgr/index.rst (100%) rename doc/{ => services}/connectivity/networking/conn_mgr/main.rst (100%) rename doc/{ => services}/connectivity/networking/dsa.rst (100%) rename doc/{ => services}/connectivity/networking/dsa_txrx_process.svg (100%) rename doc/{ => services}/connectivity/networking/eth_bridge_native_sim_setup.rst (100%) rename doc/{ => services}/connectivity/networking/index.rst (100%) rename doc/{ => services}/connectivity/networking/native_sim_setup.rst (100%) rename doc/{ => services}/connectivity/networking/net-stack-architecture.rst (100%) rename doc/{ => services}/connectivity/networking/net_config_guide.rst (100%) rename doc/{ => services}/connectivity/networking/net_pkt_processing_stats.rst (100%) rename doc/{ => services}/connectivity/networking/network_monitoring.rst (100%) rename doc/{ => services}/connectivity/networking/network_tracing.rst (100%) rename doc/{ => services}/connectivity/networking/networking_with_host.rst (100%) rename doc/{ => services}/connectivity/networking/networking_with_multiple_instances.rst (100%) rename doc/{ => services}/connectivity/networking/overview.rst (100%) rename doc/{ => services}/connectivity/networking/qemu_802154_setup.rst (100%) rename doc/{ => services}/connectivity/networking/qemu_eth_setup.rst (100%) rename doc/{ => services}/connectivity/networking/qemu_setup.rst (100%) rename doc/{ => services}/connectivity/networking/qemu_user_setup.rst (100%) rename doc/{ => services}/connectivity/networking/usbnet_setup.rst (100%) rename doc/{ => services}/connectivity/networking/zephyr_netstack_overview-rx_sequence.svg (100%) rename doc/{ => services}/connectivity/networking/zephyr_netstack_overview-tx_sequence.svg (100%) rename doc/{ => services}/connectivity/networking/zephyr_netstack_overview.jpg (100%) rename doc/{ => services}/connectivity/networking/zephyr_netstack_overview.svg (100%) rename doc/{ => services}/connectivity/networking/zephyr_netstack_overview.vsdx (100%) rename doc/{ => services}/connectivity/usb/api/hid.rst (100%) rename doc/{ => services}/connectivity/usb/device/api/index.rst (100%) rename doc/{ => services}/connectivity/usb/device/api/usb_dc.rst (100%) rename doc/{ => services}/connectivity/usb/device/api/usb_device.rst (100%) rename doc/{ => services}/connectivity/usb/device/api/usb_device_bos.rst (100%) rename doc/{ => services}/connectivity/usb/device/api/usb_device_hid.rst (100%) rename doc/{ => services}/connectivity/usb/device/usb_device.rst (100%) rename doc/{ => services}/connectivity/usb/device_next/api/index.rst (100%) rename doc/{ => services}/connectivity/usb/device_next/api/uac2_device.rst (100%) rename doc/{ => services}/connectivity/usb/device_next/api/udc.rst (100%) rename doc/{ => services}/connectivity/usb/device_next/api/usbd.rst (100%) rename doc/{ => services}/connectivity/usb/device_next/api/usbd_dfu.rst (100%) rename doc/{ => services}/connectivity/usb/device_next/api/usbd_hid_device.rst (100%) rename doc/{ => services}/connectivity/usb/device_next/api/usbd_midi2.rst (100%) rename doc/{ => services}/connectivity/usb/device_next/api/usbd_msc_device.rst (100%) rename doc/{ => services}/connectivity/usb/device_next/usb_device.rst (100%) rename doc/{ => services}/connectivity/usb/host/api/index.rst (100%) rename doc/{ => services}/connectivity/usb/host/api/uhc.rst (100%) rename doc/{ => services}/connectivity/usb/host/usbip.rst (100%) rename doc/{ => services}/connectivity/usb/index.rst (100%) rename doc/{ => services}/connectivity/usb/pd/ucds.rst (100%) diff --git a/doc/index.rst b/doc/index.rst index 861cf6189faba..d6c4b5334a55e 100644 --- a/doc/index.rst +++ b/doc/index.rst @@ -59,7 +59,6 @@ Zephyr Project Documentation kernel/index.rst services/index.rst build/index.rst - connectivity/index.rst hardware/index.rst contribute/index.rst project/index.rst diff --git a/doc/releases/release-notes-4.2.rst b/doc/releases/release-notes-4.2.rst index 9ae5ba4618fc1..e22aeb4a80559 100644 --- a/doc/releases/release-notes-4.2.rst +++ b/doc/releases/release-notes-4.2.rst @@ -400,7 +400,7 @@ New APIs and options * :kconfig:option:`CONFIG_WIFI_USAGE_MODE` * Added a new section to the Wi-Fi Management documentation - (``doc/connectivity/networking/api/wifi.rst``) with step-by-step instructions for generating + (``doc/services/connectivity/networking/api/wifi.rst``) with step-by-step instructions for generating test certificates for Wi-Fi using FreeRADIUS scripts. This helps users reproduce the process for their own test environments. * Changed the hostap IPC mechanism from socketpair to k_fifo. Depending on the enabled Wi-Fi configuration options, this can save up to 6-8 kB memory when using native Wi-Fi stack. diff --git a/doc/connectivity/bluetooth/api/a2dp.rst b/doc/services/connectivity/bluetooth/api/a2dp.rst similarity index 100% rename from doc/connectivity/bluetooth/api/a2dp.rst rename to doc/services/connectivity/bluetooth/api/a2dp.rst diff --git a/doc/connectivity/bluetooth/api/att.rst b/doc/services/connectivity/bluetooth/api/att.rst similarity index 100% rename from doc/connectivity/bluetooth/api/att.rst rename to doc/services/connectivity/bluetooth/api/att.rst diff --git a/doc/connectivity/bluetooth/api/audio/audio.rst b/doc/services/connectivity/bluetooth/api/audio/audio.rst similarity index 100% rename from doc/connectivity/bluetooth/api/audio/audio.rst rename to doc/services/connectivity/bluetooth/api/audio/audio.rst diff --git a/doc/connectivity/bluetooth/api/audio/bap.rst b/doc/services/connectivity/bluetooth/api/audio/bap.rst similarity index 100% rename from doc/connectivity/bluetooth/api/audio/bap.rst rename to doc/services/connectivity/bluetooth/api/audio/bap.rst diff --git a/doc/connectivity/bluetooth/api/audio/bluetooth-le-audio-arch.rst b/doc/services/connectivity/bluetooth/api/audio/bluetooth-le-audio-arch.rst similarity index 100% rename from doc/connectivity/bluetooth/api/audio/bluetooth-le-audio-arch.rst rename to doc/services/connectivity/bluetooth/api/audio/bluetooth-le-audio-arch.rst diff --git a/doc/connectivity/bluetooth/api/audio/cap.rst b/doc/services/connectivity/bluetooth/api/audio/cap.rst similarity index 100% rename from doc/connectivity/bluetooth/api/audio/cap.rst rename to doc/services/connectivity/bluetooth/api/audio/cap.rst diff --git a/doc/connectivity/bluetooth/api/audio/coordinated_sets.rst b/doc/services/connectivity/bluetooth/api/audio/coordinated_sets.rst similarity index 100% rename from doc/connectivity/bluetooth/api/audio/coordinated_sets.rst rename to doc/services/connectivity/bluetooth/api/audio/coordinated_sets.rst diff --git a/doc/connectivity/bluetooth/api/audio/img/cap_proc.svg b/doc/services/connectivity/bluetooth/api/audio/img/cap_proc.svg similarity index 100% rename from doc/connectivity/bluetooth/api/audio/img/cap_proc.svg rename to doc/services/connectivity/bluetooth/api/audio/img/cap_proc.svg diff --git a/doc/connectivity/bluetooth/api/audio/media.rst b/doc/services/connectivity/bluetooth/api/audio/media.rst similarity index 100% rename from doc/connectivity/bluetooth/api/audio/media.rst rename to doc/services/connectivity/bluetooth/api/audio/media.rst diff --git a/doc/connectivity/bluetooth/api/audio/microphone.rst b/doc/services/connectivity/bluetooth/api/audio/microphone.rst similarity index 100% rename from doc/connectivity/bluetooth/api/audio/microphone.rst rename to doc/services/connectivity/bluetooth/api/audio/microphone.rst diff --git a/doc/connectivity/bluetooth/api/audio/volume.rst b/doc/services/connectivity/bluetooth/api/audio/volume.rst similarity index 100% rename from doc/connectivity/bluetooth/api/audio/volume.rst rename to doc/services/connectivity/bluetooth/api/audio/volume.rst diff --git a/doc/connectivity/bluetooth/api/connection_mgmt.rst b/doc/services/connectivity/bluetooth/api/connection_mgmt.rst similarity index 100% rename from doc/connectivity/bluetooth/api/connection_mgmt.rst rename to doc/services/connectivity/bluetooth/api/connection_mgmt.rst diff --git a/doc/connectivity/bluetooth/api/controller.rst b/doc/services/connectivity/bluetooth/api/controller.rst similarity index 100% rename from doc/connectivity/bluetooth/api/controller.rst rename to doc/services/connectivity/bluetooth/api/controller.rst diff --git a/doc/connectivity/bluetooth/api/crypto.rst b/doc/services/connectivity/bluetooth/api/crypto.rst similarity index 100% rename from doc/connectivity/bluetooth/api/crypto.rst rename to doc/services/connectivity/bluetooth/api/crypto.rst diff --git a/doc/connectivity/bluetooth/api/data_buffer.rst b/doc/services/connectivity/bluetooth/api/data_buffer.rst similarity index 100% rename from doc/connectivity/bluetooth/api/data_buffer.rst rename to doc/services/connectivity/bluetooth/api/data_buffer.rst diff --git a/doc/connectivity/bluetooth/api/gap.rst b/doc/services/connectivity/bluetooth/api/gap.rst similarity index 100% rename from doc/connectivity/bluetooth/api/gap.rst rename to doc/services/connectivity/bluetooth/api/gap.rst diff --git a/doc/connectivity/bluetooth/api/gatt.rst b/doc/services/connectivity/bluetooth/api/gatt.rst similarity index 100% rename from doc/connectivity/bluetooth/api/gatt.rst rename to doc/services/connectivity/bluetooth/api/gatt.rst diff --git a/doc/connectivity/bluetooth/api/hci.txt b/doc/services/connectivity/bluetooth/api/hci.txt similarity index 100% rename from doc/connectivity/bluetooth/api/hci.txt rename to doc/services/connectivity/bluetooth/api/hci.txt diff --git a/doc/connectivity/bluetooth/api/hci_drivers.rst b/doc/services/connectivity/bluetooth/api/hci_drivers.rst similarity index 100% rename from doc/connectivity/bluetooth/api/hci_drivers.rst rename to doc/services/connectivity/bluetooth/api/hci_drivers.rst diff --git a/doc/connectivity/bluetooth/api/hci_raw.rst b/doc/services/connectivity/bluetooth/api/hci_raw.rst similarity index 100% rename from doc/connectivity/bluetooth/api/hci_raw.rst rename to doc/services/connectivity/bluetooth/api/hci_raw.rst diff --git a/doc/connectivity/bluetooth/api/hfp.rst b/doc/services/connectivity/bluetooth/api/hfp.rst similarity index 100% rename from doc/connectivity/bluetooth/api/hfp.rst rename to doc/services/connectivity/bluetooth/api/hfp.rst diff --git a/doc/connectivity/bluetooth/api/index.rst b/doc/services/connectivity/bluetooth/api/index.rst similarity index 100% rename from doc/connectivity/bluetooth/api/index.rst rename to doc/services/connectivity/bluetooth/api/index.rst diff --git a/doc/connectivity/bluetooth/api/l2cap.rst b/doc/services/connectivity/bluetooth/api/l2cap.rst similarity index 100% rename from doc/connectivity/bluetooth/api/l2cap.rst rename to doc/services/connectivity/bluetooth/api/l2cap.rst diff --git a/doc/connectivity/bluetooth/api/mesh.rst b/doc/services/connectivity/bluetooth/api/mesh.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh.rst rename to doc/services/connectivity/bluetooth/api/mesh.rst diff --git a/doc/connectivity/bluetooth/api/mesh/access.rst b/doc/services/connectivity/bluetooth/api/mesh/access.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/access.rst rename to doc/services/connectivity/bluetooth/api/mesh/access.rst diff --git a/doc/connectivity/bluetooth/api/mesh/blob.rst b/doc/services/connectivity/bluetooth/api/mesh/blob.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/blob.rst rename to doc/services/connectivity/bluetooth/api/mesh/blob.rst diff --git a/doc/connectivity/bluetooth/api/mesh/blob_cli.rst b/doc/services/connectivity/bluetooth/api/mesh/blob_cli.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/blob_cli.rst rename to doc/services/connectivity/bluetooth/api/mesh/blob_cli.rst diff --git a/doc/connectivity/bluetooth/api/mesh/blob_flash.rst b/doc/services/connectivity/bluetooth/api/mesh/blob_flash.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/blob_flash.rst rename to doc/services/connectivity/bluetooth/api/mesh/blob_flash.rst diff --git a/doc/connectivity/bluetooth/api/mesh/blob_srv.rst b/doc/services/connectivity/bluetooth/api/mesh/blob_srv.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/blob_srv.rst rename to doc/services/connectivity/bluetooth/api/mesh/blob_srv.rst diff --git a/doc/connectivity/bluetooth/api/mesh/brg_cfg.rst b/doc/services/connectivity/bluetooth/api/mesh/brg_cfg.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/brg_cfg.rst rename to doc/services/connectivity/bluetooth/api/mesh/brg_cfg.rst diff --git a/doc/connectivity/bluetooth/api/mesh/brg_cfg_cli.rst b/doc/services/connectivity/bluetooth/api/mesh/brg_cfg_cli.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/brg_cfg_cli.rst rename to doc/services/connectivity/bluetooth/api/mesh/brg_cfg_cli.rst diff --git a/doc/connectivity/bluetooth/api/mesh/brg_cfg_srv.rst b/doc/services/connectivity/bluetooth/api/mesh/brg_cfg_srv.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/brg_cfg_srv.rst rename to doc/services/connectivity/bluetooth/api/mesh/brg_cfg_srv.rst diff --git a/doc/connectivity/bluetooth/api/mesh/cfg.rst b/doc/services/connectivity/bluetooth/api/mesh/cfg.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/cfg.rst rename to doc/services/connectivity/bluetooth/api/mesh/cfg.rst diff --git a/doc/connectivity/bluetooth/api/mesh/cfg_cli.rst b/doc/services/connectivity/bluetooth/api/mesh/cfg_cli.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/cfg_cli.rst rename to doc/services/connectivity/bluetooth/api/mesh/cfg_cli.rst diff --git a/doc/connectivity/bluetooth/api/mesh/cfg_srv.rst b/doc/services/connectivity/bluetooth/api/mesh/cfg_srv.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/cfg_srv.rst rename to doc/services/connectivity/bluetooth/api/mesh/cfg_srv.rst diff --git a/doc/connectivity/bluetooth/api/mesh/core.rst b/doc/services/connectivity/bluetooth/api/mesh/core.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/core.rst rename to doc/services/connectivity/bluetooth/api/mesh/core.rst diff --git a/doc/connectivity/bluetooth/api/mesh/dfd_srv.rst b/doc/services/connectivity/bluetooth/api/mesh/dfd_srv.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/dfd_srv.rst rename to doc/services/connectivity/bluetooth/api/mesh/dfd_srv.rst diff --git a/doc/connectivity/bluetooth/api/mesh/dfu.rst b/doc/services/connectivity/bluetooth/api/mesh/dfu.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/dfu.rst rename to doc/services/connectivity/bluetooth/api/mesh/dfu.rst diff --git a/doc/connectivity/bluetooth/api/mesh/dfu_cli.rst b/doc/services/connectivity/bluetooth/api/mesh/dfu_cli.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/dfu_cli.rst rename to doc/services/connectivity/bluetooth/api/mesh/dfu_cli.rst diff --git a/doc/connectivity/bluetooth/api/mesh/dfu_srv.rst b/doc/services/connectivity/bluetooth/api/mesh/dfu_srv.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/dfu_srv.rst rename to doc/services/connectivity/bluetooth/api/mesh/dfu_srv.rst diff --git a/doc/connectivity/bluetooth/api/mesh/health_cli.rst b/doc/services/connectivity/bluetooth/api/mesh/health_cli.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/health_cli.rst rename to doc/services/connectivity/bluetooth/api/mesh/health_cli.rst diff --git a/doc/connectivity/bluetooth/api/mesh/health_srv.rst b/doc/services/connectivity/bluetooth/api/mesh/health_srv.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/health_srv.rst rename to doc/services/connectivity/bluetooth/api/mesh/health_srv.rst diff --git a/doc/connectivity/bluetooth/api/mesh/heartbeat.rst b/doc/services/connectivity/bluetooth/api/mesh/heartbeat.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/heartbeat.rst rename to doc/services/connectivity/bluetooth/api/mesh/heartbeat.rst diff --git a/doc/connectivity/bluetooth/api/mesh/images/blob_srv.svg b/doc/services/connectivity/bluetooth/api/mesh/images/blob_srv.svg similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/images/blob_srv.svg rename to doc/services/connectivity/bluetooth/api/mesh/images/blob_srv.svg diff --git a/doc/connectivity/bluetooth/api/mesh/images/blob_srv.xml b/doc/services/connectivity/bluetooth/api/mesh/images/blob_srv.xml similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/images/blob_srv.xml rename to doc/services/connectivity/bluetooth/api/mesh/images/blob_srv.xml diff --git a/doc/connectivity/bluetooth/api/mesh/images/dfu_roles_mesh.svg b/doc/services/connectivity/bluetooth/api/mesh/images/dfu_roles_mesh.svg similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/images/dfu_roles_mesh.svg rename to doc/services/connectivity/bluetooth/api/mesh/images/dfu_roles_mesh.svg diff --git a/doc/connectivity/bluetooth/api/mesh/images/dfu_srv.svg b/doc/services/connectivity/bluetooth/api/mesh/images/dfu_srv.svg similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/images/dfu_srv.svg rename to doc/services/connectivity/bluetooth/api/mesh/images/dfu_srv.svg diff --git a/doc/connectivity/bluetooth/api/mesh/images/dfu_srv.xml b/doc/services/connectivity/bluetooth/api/mesh/images/dfu_srv.xml similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/images/dfu_srv.xml rename to doc/services/connectivity/bluetooth/api/mesh/images/dfu_srv.xml diff --git a/doc/connectivity/bluetooth/api/mesh/images/dfu_stages_procedures_mesh.svg b/doc/services/connectivity/bluetooth/api/mesh/images/dfu_stages_procedures_mesh.svg similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/images/dfu_stages_procedures_mesh.svg rename to doc/services/connectivity/bluetooth/api/mesh/images/dfu_stages_procedures_mesh.svg diff --git a/doc/connectivity/bluetooth/api/mesh/lcd_cli.rst b/doc/services/connectivity/bluetooth/api/mesh/lcd_cli.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/lcd_cli.rst rename to doc/services/connectivity/bluetooth/api/mesh/lcd_cli.rst diff --git a/doc/connectivity/bluetooth/api/mesh/lcd_srv.rst b/doc/services/connectivity/bluetooth/api/mesh/lcd_srv.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/lcd_srv.rst rename to doc/services/connectivity/bluetooth/api/mesh/lcd_srv.rst diff --git a/doc/connectivity/bluetooth/api/mesh/models.rst b/doc/services/connectivity/bluetooth/api/mesh/models.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/models.rst rename to doc/services/connectivity/bluetooth/api/mesh/models.rst diff --git a/doc/connectivity/bluetooth/api/mesh/msg.rst b/doc/services/connectivity/bluetooth/api/mesh/msg.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/msg.rst rename to doc/services/connectivity/bluetooth/api/mesh/msg.rst diff --git a/doc/connectivity/bluetooth/api/mesh/od_cli.rst b/doc/services/connectivity/bluetooth/api/mesh/od_cli.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/od_cli.rst rename to doc/services/connectivity/bluetooth/api/mesh/od_cli.rst diff --git a/doc/connectivity/bluetooth/api/mesh/od_srv.rst b/doc/services/connectivity/bluetooth/api/mesh/od_srv.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/od_srv.rst rename to doc/services/connectivity/bluetooth/api/mesh/od_srv.rst diff --git a/doc/connectivity/bluetooth/api/mesh/op_agg_cli.rst b/doc/services/connectivity/bluetooth/api/mesh/op_agg_cli.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/op_agg_cli.rst rename to doc/services/connectivity/bluetooth/api/mesh/op_agg_cli.rst diff --git a/doc/connectivity/bluetooth/api/mesh/op_agg_srv.rst b/doc/services/connectivity/bluetooth/api/mesh/op_agg_srv.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/op_agg_srv.rst rename to doc/services/connectivity/bluetooth/api/mesh/op_agg_srv.rst diff --git a/doc/connectivity/bluetooth/api/mesh/priv_beacon_cli.rst b/doc/services/connectivity/bluetooth/api/mesh/priv_beacon_cli.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/priv_beacon_cli.rst rename to doc/services/connectivity/bluetooth/api/mesh/priv_beacon_cli.rst diff --git a/doc/connectivity/bluetooth/api/mesh/priv_beacon_srv.rst b/doc/services/connectivity/bluetooth/api/mesh/priv_beacon_srv.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/priv_beacon_srv.rst rename to doc/services/connectivity/bluetooth/api/mesh/priv_beacon_srv.rst diff --git a/doc/connectivity/bluetooth/api/mesh/provisioning.rst b/doc/services/connectivity/bluetooth/api/mesh/provisioning.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/provisioning.rst rename to doc/services/connectivity/bluetooth/api/mesh/provisioning.rst diff --git a/doc/connectivity/bluetooth/api/mesh/proxy.rst b/doc/services/connectivity/bluetooth/api/mesh/proxy.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/proxy.rst rename to doc/services/connectivity/bluetooth/api/mesh/proxy.rst diff --git a/doc/connectivity/bluetooth/api/mesh/rpr_cli.rst b/doc/services/connectivity/bluetooth/api/mesh/rpr_cli.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/rpr_cli.rst rename to doc/services/connectivity/bluetooth/api/mesh/rpr_cli.rst diff --git a/doc/connectivity/bluetooth/api/mesh/rpr_srv.rst b/doc/services/connectivity/bluetooth/api/mesh/rpr_srv.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/rpr_srv.rst rename to doc/services/connectivity/bluetooth/api/mesh/rpr_srv.rst diff --git a/doc/connectivity/bluetooth/api/mesh/sar_cfg.rst b/doc/services/connectivity/bluetooth/api/mesh/sar_cfg.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/sar_cfg.rst rename to doc/services/connectivity/bluetooth/api/mesh/sar_cfg.rst diff --git a/doc/connectivity/bluetooth/api/mesh/sar_cfg_cli.rst b/doc/services/connectivity/bluetooth/api/mesh/sar_cfg_cli.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/sar_cfg_cli.rst rename to doc/services/connectivity/bluetooth/api/mesh/sar_cfg_cli.rst diff --git a/doc/connectivity/bluetooth/api/mesh/sar_cfg_srv.rst b/doc/services/connectivity/bluetooth/api/mesh/sar_cfg_srv.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/sar_cfg_srv.rst rename to doc/services/connectivity/bluetooth/api/mesh/sar_cfg_srv.rst diff --git a/doc/connectivity/bluetooth/api/mesh/shell.rst b/doc/services/connectivity/bluetooth/api/mesh/shell.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/shell.rst rename to doc/services/connectivity/bluetooth/api/mesh/shell.rst diff --git a/doc/connectivity/bluetooth/api/mesh/srpl_cli.rst b/doc/services/connectivity/bluetooth/api/mesh/srpl_cli.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/srpl_cli.rst rename to doc/services/connectivity/bluetooth/api/mesh/srpl_cli.rst diff --git a/doc/connectivity/bluetooth/api/mesh/srpl_srv.rst b/doc/services/connectivity/bluetooth/api/mesh/srpl_srv.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/srpl_srv.rst rename to doc/services/connectivity/bluetooth/api/mesh/srpl_srv.rst diff --git a/doc/connectivity/bluetooth/api/mesh/statistic.rst b/doc/services/connectivity/bluetooth/api/mesh/statistic.rst similarity index 100% rename from doc/connectivity/bluetooth/api/mesh/statistic.rst rename to doc/services/connectivity/bluetooth/api/mesh/statistic.rst diff --git a/doc/connectivity/bluetooth/api/rfcomm.rst b/doc/services/connectivity/bluetooth/api/rfcomm.rst similarity index 100% rename from doc/connectivity/bluetooth/api/rfcomm.rst rename to doc/services/connectivity/bluetooth/api/rfcomm.rst diff --git a/doc/connectivity/bluetooth/api/sdp.rst b/doc/services/connectivity/bluetooth/api/sdp.rst similarity index 100% rename from doc/connectivity/bluetooth/api/sdp.rst rename to doc/services/connectivity/bluetooth/api/sdp.rst diff --git a/doc/connectivity/bluetooth/api/services.rst b/doc/services/connectivity/bluetooth/api/services.rst similarity index 100% rename from doc/connectivity/bluetooth/api/services.rst rename to doc/services/connectivity/bluetooth/api/services.rst diff --git a/doc/connectivity/bluetooth/api/uuid.rst b/doc/services/connectivity/bluetooth/api/uuid.rst similarity index 100% rename from doc/connectivity/bluetooth/api/uuid.rst rename to doc/services/connectivity/bluetooth/api/uuid.rst diff --git a/doc/connectivity/bluetooth/autopts/add_socat_to_path.png b/doc/services/connectivity/bluetooth/autopts/add_socat_to_path.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/add_socat_to_path.png rename to doc/services/connectivity/bluetooth/autopts/add_socat_to_path.png diff --git a/doc/connectivity/bluetooth/autopts/allow_firewall.png b/doc/services/connectivity/bluetooth/autopts/allow_firewall.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/allow_firewall.png rename to doc/services/connectivity/bluetooth/autopts/allow_firewall.png diff --git a/doc/connectivity/bluetooth/autopts/allow_firewall_2.png b/doc/services/connectivity/bluetooth/autopts/allow_firewall_2.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/allow_firewall_2.png rename to doc/services/connectivity/bluetooth/autopts/allow_firewall_2.png diff --git a/doc/connectivity/bluetooth/autopts/autopts-linux.rst b/doc/services/connectivity/bluetooth/autopts/autopts-linux.rst similarity index 100% rename from doc/connectivity/bluetooth/autopts/autopts-linux.rst rename to doc/services/connectivity/bluetooth/autopts/autopts-linux.rst diff --git a/doc/connectivity/bluetooth/autopts/autopts-win10.rst b/doc/services/connectivity/bluetooth/autopts/autopts-win10.rst similarity index 100% rename from doc/connectivity/bluetooth/autopts/autopts-win10.rst rename to doc/services/connectivity/bluetooth/autopts/autopts-win10.rst diff --git a/doc/connectivity/bluetooth/autopts/autoptsclient_run.png b/doc/services/connectivity/bluetooth/autopts/autoptsclient_run.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/autoptsclient_run.png rename to doc/services/connectivity/bluetooth/autopts/autoptsclient_run.png diff --git a/doc/connectivity/bluetooth/autopts/autoptsclient_run_2.png b/doc/services/connectivity/bluetooth/autopts/autoptsclient_run_2.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/autoptsclient_run_2.png rename to doc/services/connectivity/bluetooth/autopts/autoptsclient_run_2.png diff --git a/doc/connectivity/bluetooth/autopts/autoptsserver_run.png b/doc/services/connectivity/bluetooth/autopts/autoptsserver_run.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/autoptsserver_run.png rename to doc/services/connectivity/bluetooth/autopts/autoptsserver_run.png diff --git a/doc/connectivity/bluetooth/autopts/autoptsserver_run_2.png b/doc/services/connectivity/bluetooth/autopts/autoptsserver_run_2.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/autoptsserver_run_2.png rename to doc/services/connectivity/bluetooth/autopts/autoptsserver_run_2.png diff --git a/doc/connectivity/bluetooth/autopts/autoptsserver_typical_error.png b/doc/services/connectivity/bluetooth/autopts/autoptsserver_typical_error.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/autoptsserver_typical_error.png rename to doc/services/connectivity/bluetooth/autopts/autoptsserver_typical_error.png diff --git a/doc/connectivity/bluetooth/autopts/device_manager.png b/doc/services/connectivity/bluetooth/autopts/device_manager.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/device_manager.png rename to doc/services/connectivity/bluetooth/autopts/device_manager.png diff --git a/doc/connectivity/bluetooth/autopts/devices_1.png b/doc/services/connectivity/bluetooth/autopts/devices_1.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/devices_1.png rename to doc/services/connectivity/bluetooth/autopts/devices_1.png diff --git a/doc/connectivity/bluetooth/autopts/devices_2.png b/doc/services/connectivity/bluetooth/autopts/devices_2.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/devices_2.png rename to doc/services/connectivity/bluetooth/autopts/devices_2.png diff --git a/doc/connectivity/bluetooth/autopts/download_nrftools_linux.png b/doc/services/connectivity/bluetooth/autopts/download_nrftools_linux.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/download_nrftools_linux.png rename to doc/services/connectivity/bluetooth/autopts/download_nrftools_linux.png diff --git a/doc/connectivity/bluetooth/autopts/download_nrftools_windows.png b/doc/services/connectivity/bluetooth/autopts/download_nrftools_windows.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/download_nrftools_windows.png rename to doc/services/connectivity/bluetooth/autopts/download_nrftools_windows.png diff --git a/doc/connectivity/bluetooth/autopts/download_socat.png b/doc/services/connectivity/bluetooth/autopts/download_socat.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/download_socat.png rename to doc/services/connectivity/bluetooth/autopts/download_socat.png diff --git a/doc/connectivity/bluetooth/autopts/install_git.png b/doc/services/connectivity/bluetooth/autopts/install_git.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/install_git.png rename to doc/services/connectivity/bluetooth/autopts/install_git.png diff --git a/doc/connectivity/bluetooth/autopts/install_pts_drivers.png b/doc/services/connectivity/bluetooth/autopts/install_pts_drivers.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/install_pts_drivers.png rename to doc/services/connectivity/bluetooth/autopts/install_pts_drivers.png diff --git a/doc/connectivity/bluetooth/autopts/install_python1.png b/doc/services/connectivity/bluetooth/autopts/install_python1.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/install_python1.png rename to doc/services/connectivity/bluetooth/autopts/install_python1.png diff --git a/doc/connectivity/bluetooth/autopts/install_python2.png b/doc/services/connectivity/bluetooth/autopts/install_python2.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/install_python2.png rename to doc/services/connectivity/bluetooth/autopts/install_python2.png diff --git a/doc/connectivity/bluetooth/autopts/install_ubuntu_on_wsl.png b/doc/services/connectivity/bluetooth/autopts/install_ubuntu_on_wsl.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/install_ubuntu_on_wsl.png rename to doc/services/connectivity/bluetooth/autopts/install_ubuntu_on_wsl.png diff --git a/doc/connectivity/bluetooth/autopts/pts_automation_window.png b/doc/services/connectivity/bluetooth/autopts/pts_automation_window.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/pts_automation_window.png rename to doc/services/connectivity/bluetooth/autopts/pts_automation_window.png diff --git a/doc/connectivity/bluetooth/autopts/ubuntu_first_launch.png b/doc/services/connectivity/bluetooth/autopts/ubuntu_first_launch.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/ubuntu_first_launch.png rename to doc/services/connectivity/bluetooth/autopts/ubuntu_first_launch.png diff --git a/doc/connectivity/bluetooth/autopts/usb-devices_output.png b/doc/services/connectivity/bluetooth/autopts/usb-devices_output.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/usb-devices_output.png rename to doc/services/connectivity/bluetooth/autopts/usb-devices_output.png diff --git a/doc/connectivity/bluetooth/autopts/virtualbox_nat_1.png b/doc/services/connectivity/bluetooth/autopts/virtualbox_nat_1.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/virtualbox_nat_1.png rename to doc/services/connectivity/bluetooth/autopts/virtualbox_nat_1.png diff --git a/doc/connectivity/bluetooth/autopts/virtualbox_nat_2.png b/doc/services/connectivity/bluetooth/autopts/virtualbox_nat_2.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/virtualbox_nat_2.png rename to doc/services/connectivity/bluetooth/autopts/virtualbox_nat_2.png diff --git a/doc/connectivity/bluetooth/autopts/virtualbox_static_ip_1.png b/doc/services/connectivity/bluetooth/autopts/virtualbox_static_ip_1.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/virtualbox_static_ip_1.png rename to doc/services/connectivity/bluetooth/autopts/virtualbox_static_ip_1.png diff --git a/doc/connectivity/bluetooth/autopts/virtualbox_static_ip_2.png b/doc/services/connectivity/bluetooth/autopts/virtualbox_static_ip_2.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/virtualbox_static_ip_2.png rename to doc/services/connectivity/bluetooth/autopts/virtualbox_static_ip_2.png diff --git a/doc/connectivity/bluetooth/autopts/vmware_static_ip_1.png b/doc/services/connectivity/bluetooth/autopts/vmware_static_ip_1.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/vmware_static_ip_1.png rename to doc/services/connectivity/bluetooth/autopts/vmware_static_ip_1.png diff --git a/doc/connectivity/bluetooth/autopts/vmware_static_ip_2.png b/doc/services/connectivity/bluetooth/autopts/vmware_static_ip_2.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/vmware_static_ip_2.png rename to doc/services/connectivity/bluetooth/autopts/vmware_static_ip_2.png diff --git a/doc/connectivity/bluetooth/autopts/vmware_static_ip_3.png b/doc/services/connectivity/bluetooth/autopts/vmware_static_ip_3.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/vmware_static_ip_3.png rename to doc/services/connectivity/bluetooth/autopts/vmware_static_ip_3.png diff --git a/doc/connectivity/bluetooth/autopts/windows_static_ip.png b/doc/services/connectivity/bluetooth/autopts/windows_static_ip.png similarity index 100% rename from doc/connectivity/bluetooth/autopts/windows_static_ip.png rename to doc/services/connectivity/bluetooth/autopts/windows_static_ip.png diff --git a/doc/connectivity/bluetooth/bluetooth-arch.rst b/doc/services/connectivity/bluetooth/bluetooth-arch.rst similarity index 99% rename from doc/connectivity/bluetooth/bluetooth-arch.rst rename to doc/services/connectivity/bluetooth/bluetooth-arch.rst index 1525035bb4407..bbf17b537f613 100644 --- a/doc/connectivity/bluetooth/bluetooth-arch.rst +++ b/doc/services/connectivity/bluetooth/bluetooth-arch.rst @@ -210,7 +210,7 @@ The stack is split up as follows in the source tree: functionality of the Bluetooth stack, but are not necessary the best source for sample code (see ``samples/bluetooth`` instead). -``doc/connectivity/bluetooth/`` +``doc/services/connectivity/bluetooth/`` Extra documentation, such as PICS documents. .. _Bluetooth Specification: https://www.bluetooth.com/specifications/bluetooth-core-specification diff --git a/doc/connectivity/bluetooth/bluetooth-ctlr-arch.rst b/doc/services/connectivity/bluetooth/bluetooth-ctlr-arch.rst similarity index 100% rename from doc/connectivity/bluetooth/bluetooth-ctlr-arch.rst rename to doc/services/connectivity/bluetooth/bluetooth-ctlr-arch.rst diff --git a/doc/connectivity/bluetooth/bluetooth-dev.rst b/doc/services/connectivity/bluetooth/bluetooth-dev.rst similarity index 100% rename from doc/connectivity/bluetooth/bluetooth-dev.rst rename to doc/services/connectivity/bluetooth/bluetooth-dev.rst diff --git a/doc/connectivity/bluetooth/bluetooth-le-host.rst b/doc/services/connectivity/bluetooth/bluetooth-le-host.rst similarity index 100% rename from doc/connectivity/bluetooth/bluetooth-le-host.rst rename to doc/services/connectivity/bluetooth/bluetooth-le-host.rst diff --git a/doc/connectivity/bluetooth/bluetooth-qual.rst b/doc/services/connectivity/bluetooth/bluetooth-qual.rst similarity index 100% rename from doc/connectivity/bluetooth/bluetooth-qual.rst rename to doc/services/connectivity/bluetooth/bluetooth-qual.rst diff --git a/doc/connectivity/bluetooth/bluetooth-shell.rst b/doc/services/connectivity/bluetooth/bluetooth-shell.rst similarity index 100% rename from doc/connectivity/bluetooth/bluetooth-shell.rst rename to doc/services/connectivity/bluetooth/bluetooth-shell.rst diff --git a/doc/connectivity/bluetooth/bluetooth-tools.rst b/doc/services/connectivity/bluetooth/bluetooth-tools.rst similarity index 100% rename from doc/connectivity/bluetooth/bluetooth-tools.rst rename to doc/services/connectivity/bluetooth/bluetooth-tools.rst diff --git a/doc/connectivity/bluetooth/features.rst b/doc/services/connectivity/bluetooth/features.rst similarity index 100% rename from doc/connectivity/bluetooth/features.rst rename to doc/services/connectivity/bluetooth/features.rst diff --git a/doc/connectivity/bluetooth/img/att_timeout.svg b/doc/services/connectivity/bluetooth/img/att_timeout.svg similarity index 100% rename from doc/connectivity/bluetooth/img/att_timeout.svg rename to doc/services/connectivity/bluetooth/img/att_timeout.svg diff --git a/doc/connectivity/bluetooth/img/ble_cfg_dual.png b/doc/services/connectivity/bluetooth/img/ble_cfg_dual.png similarity index 100% rename from doc/connectivity/bluetooth/img/ble_cfg_dual.png rename to doc/services/connectivity/bluetooth/img/ble_cfg_dual.png diff --git a/doc/connectivity/bluetooth/img/ble_cfg_dual.xml b/doc/services/connectivity/bluetooth/img/ble_cfg_dual.xml similarity index 100% rename from doc/connectivity/bluetooth/img/ble_cfg_dual.xml rename to doc/services/connectivity/bluetooth/img/ble_cfg_dual.xml diff --git a/doc/connectivity/bluetooth/img/ble_cfg_single.png b/doc/services/connectivity/bluetooth/img/ble_cfg_single.png similarity index 100% rename from doc/connectivity/bluetooth/img/ble_cfg_single.png rename to doc/services/connectivity/bluetooth/img/ble_cfg_single.png diff --git a/doc/connectivity/bluetooth/img/ble_cfg_single.xml b/doc/services/connectivity/bluetooth/img/ble_cfg_single.xml similarity index 100% rename from doc/connectivity/bluetooth/img/ble_cfg_single.xml rename to doc/services/connectivity/bluetooth/img/ble_cfg_single.xml diff --git a/doc/connectivity/bluetooth/img/ble_host_layers.png b/doc/services/connectivity/bluetooth/img/ble_host_layers.png similarity index 100% rename from doc/connectivity/bluetooth/img/ble_host_layers.png rename to doc/services/connectivity/bluetooth/img/ble_host_layers.png diff --git a/doc/connectivity/bluetooth/img/ble_host_layers.xml b/doc/services/connectivity/bluetooth/img/ble_host_layers.xml similarity index 100% rename from doc/connectivity/bluetooth/img/ble_host_layers.xml rename to doc/services/connectivity/bluetooth/img/ble_host_layers.xml diff --git a/doc/connectivity/bluetooth/img/ctlr_arch_overview.png b/doc/services/connectivity/bluetooth/img/ctlr_arch_overview.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_arch_overview.png rename to doc/services/connectivity/bluetooth/img/ctlr_arch_overview.png diff --git a/doc/connectivity/bluetooth/img/ctlr_dataflow_rx.png b/doc/services/connectivity/bluetooth/img/ctlr_dataflow_rx.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_dataflow_rx.png rename to doc/services/connectivity/bluetooth/img/ctlr_dataflow_rx.png diff --git a/doc/connectivity/bluetooth/img/ctlr_dataflow_tx.png b/doc/services/connectivity/bluetooth/img/ctlr_dataflow_tx.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_dataflow_tx.png rename to doc/services/connectivity/bluetooth/img/ctlr_dataflow_tx.png diff --git a/doc/connectivity/bluetooth/img/ctlr_exec_lll.png b/doc/services/connectivity/bluetooth/img/ctlr_exec_lll.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_exec_lll.png rename to doc/services/connectivity/bluetooth/img/ctlr_exec_lll.png diff --git a/doc/connectivity/bluetooth/img/ctlr_exec_lll_resume_bottom.png b/doc/services/connectivity/bluetooth/img/ctlr_exec_lll_resume_bottom.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_exec_lll_resume_bottom.png rename to doc/services/connectivity/bluetooth/img/ctlr_exec_lll_resume_bottom.png diff --git a/doc/connectivity/bluetooth/img/ctlr_exec_lll_resume_top.png b/doc/services/connectivity/bluetooth/img/ctlr_exec_lll_resume_top.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_exec_lll_resume_top.png rename to doc/services/connectivity/bluetooth/img/ctlr_exec_lll_resume_top.png diff --git a/doc/connectivity/bluetooth/img/ctlr_exec_overview.png b/doc/services/connectivity/bluetooth/img/ctlr_exec_overview.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_exec_overview.png rename to doc/services/connectivity/bluetooth/img/ctlr_exec_overview.png diff --git a/doc/connectivity/bluetooth/img/ctlr_exec_prio.png b/doc/services/connectivity/bluetooth/img/ctlr_exec_prio.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_exec_prio.png rename to doc/services/connectivity/bluetooth/img/ctlr_exec_prio.png diff --git a/doc/connectivity/bluetooth/img/ctlr_legacy.png b/doc/services/connectivity/bluetooth/img/ctlr_legacy.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_legacy.png rename to doc/services/connectivity/bluetooth/img/ctlr_legacy.png diff --git a/doc/connectivity/bluetooth/img/ctlr_mayfly.png b/doc/services/connectivity/bluetooth/img/ctlr_mayfly.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_mayfly.png rename to doc/services/connectivity/bluetooth/img/ctlr_mayfly.png diff --git a/doc/connectivity/bluetooth/img/ctlr_mfifo_memq.png b/doc/services/connectivity/bluetooth/img/ctlr_mfifo_memq.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_mfifo_memq.png rename to doc/services/connectivity/bluetooth/img/ctlr_mfifo_memq.png diff --git a/doc/connectivity/bluetooth/img/ctlr_overview.png b/doc/services/connectivity/bluetooth/img/ctlr_overview.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_overview.png rename to doc/services/connectivity/bluetooth/img/ctlr_overview.png diff --git a/doc/connectivity/bluetooth/img/ctlr_sched.png b/doc/services/connectivity/bluetooth/img/ctlr_sched.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_sched.png rename to doc/services/connectivity/bluetooth/img/ctlr_sched.png diff --git a/doc/connectivity/bluetooth/img/ctlr_sched_event_handling.png b/doc/services/connectivity/bluetooth/img/ctlr_sched_event_handling.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_sched_event_handling.png rename to doc/services/connectivity/bluetooth/img/ctlr_sched_event_handling.png diff --git a/doc/connectivity/bluetooth/img/ctlr_sched_msc_close_events.png b/doc/services/connectivity/bluetooth/img/ctlr_sched_msc_close_events.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_sched_msc_close_events.png rename to doc/services/connectivity/bluetooth/img/ctlr_sched_msc_close_events.png diff --git a/doc/connectivity/bluetooth/img/ctlr_sched_msc_event_abort.png b/doc/services/connectivity/bluetooth/img/ctlr_sched_msc_event_abort.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_sched_msc_event_abort.png rename to doc/services/connectivity/bluetooth/img/ctlr_sched_msc_event_abort.png diff --git a/doc/connectivity/bluetooth/img/ctlr_sched_msc_event_cancel.png b/doc/services/connectivity/bluetooth/img/ctlr_sched_msc_event_cancel.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_sched_msc_event_cancel.png rename to doc/services/connectivity/bluetooth/img/ctlr_sched_msc_event_cancel.png diff --git a/doc/connectivity/bluetooth/img/ctlr_sched_msc_event_preempt.png b/doc/services/connectivity/bluetooth/img/ctlr_sched_msc_event_preempt.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_sched_msc_event_preempt.png rename to doc/services/connectivity/bluetooth/img/ctlr_sched_msc_event_preempt.png diff --git a/doc/connectivity/bluetooth/img/ctlr_sched_ticker.png b/doc/services/connectivity/bluetooth/img/ctlr_sched_ticker.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_sched_ticker.png rename to doc/services/connectivity/bluetooth/img/ctlr_sched_ticker.png diff --git a/doc/connectivity/bluetooth/img/ctlr_sched_ull_lll.png b/doc/services/connectivity/bluetooth/img/ctlr_sched_ull_lll.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_sched_ull_lll.png rename to doc/services/connectivity/bluetooth/img/ctlr_sched_ull_lll.png diff --git a/doc/connectivity/bluetooth/img/ctlr_sched_ull_lll_timing.png b/doc/services/connectivity/bluetooth/img/ctlr_sched_ull_lll_timing.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_sched_ull_lll_timing.png rename to doc/services/connectivity/bluetooth/img/ctlr_sched_ull_lll_timing.png diff --git a/doc/connectivity/bluetooth/img/ctlr_sched_variant.png b/doc/services/connectivity/bluetooth/img/ctlr_sched_variant.png similarity index 100% rename from doc/connectivity/bluetooth/img/ctlr_sched_variant.png rename to doc/services/connectivity/bluetooth/img/ctlr_sched_variant.png diff --git a/doc/connectivity/bluetooth/img/l2cap_b_frame.drawio.svg b/doc/services/connectivity/bluetooth/img/l2cap_b_frame.drawio.svg similarity index 100% rename from doc/connectivity/bluetooth/img/l2cap_b_frame.drawio.svg rename to doc/services/connectivity/bluetooth/img/l2cap_b_frame.drawio.svg diff --git a/doc/connectivity/bluetooth/img/l2cap_k_frame.drawio.svg b/doc/services/connectivity/bluetooth/img/l2cap_k_frame.drawio.svg similarity index 100% rename from doc/connectivity/bluetooth/img/l2cap_k_frame.drawio.svg rename to doc/services/connectivity/bluetooth/img/l2cap_k_frame.drawio.svg diff --git a/doc/connectivity/bluetooth/img/l2cap_k_frame_1.drawio.svg b/doc/services/connectivity/bluetooth/img/l2cap_k_frame_1.drawio.svg similarity index 100% rename from doc/connectivity/bluetooth/img/l2cap_k_frame_1.drawio.svg rename to doc/services/connectivity/bluetooth/img/l2cap_k_frame_1.drawio.svg diff --git a/doc/connectivity/bluetooth/index.rst b/doc/services/connectivity/bluetooth/index.rst similarity index 100% rename from doc/connectivity/bluetooth/index.rst rename to doc/services/connectivity/bluetooth/index.rst diff --git a/doc/connectivity/bluetooth/shell/audio/bap.rst b/doc/services/connectivity/bluetooth/shell/audio/bap.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/audio/bap.rst rename to doc/services/connectivity/bluetooth/shell/audio/bap.rst diff --git a/doc/connectivity/bluetooth/shell/audio/bap_broadcast_assistant.rst b/doc/services/connectivity/bluetooth/shell/audio/bap_broadcast_assistant.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/audio/bap_broadcast_assistant.rst rename to doc/services/connectivity/bluetooth/shell/audio/bap_broadcast_assistant.rst diff --git a/doc/connectivity/bluetooth/shell/audio/bap_scan_delegator.rst b/doc/services/connectivity/bluetooth/shell/audio/bap_scan_delegator.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/audio/bap_scan_delegator.rst rename to doc/services/connectivity/bluetooth/shell/audio/bap_scan_delegator.rst diff --git a/doc/connectivity/bluetooth/shell/audio/cap.rst b/doc/services/connectivity/bluetooth/shell/audio/cap.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/audio/cap.rst rename to doc/services/connectivity/bluetooth/shell/audio/cap.rst diff --git a/doc/connectivity/bluetooth/shell/audio/ccp.rst b/doc/services/connectivity/bluetooth/shell/audio/ccp.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/audio/ccp.rst rename to doc/services/connectivity/bluetooth/shell/audio/ccp.rst diff --git a/doc/connectivity/bluetooth/shell/audio/csip.rst b/doc/services/connectivity/bluetooth/shell/audio/csip.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/audio/csip.rst rename to doc/services/connectivity/bluetooth/shell/audio/csip.rst diff --git a/doc/connectivity/bluetooth/shell/audio/gmap.rst b/doc/services/connectivity/bluetooth/shell/audio/gmap.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/audio/gmap.rst rename to doc/services/connectivity/bluetooth/shell/audio/gmap.rst diff --git a/doc/connectivity/bluetooth/shell/audio/mcp.rst b/doc/services/connectivity/bluetooth/shell/audio/mcp.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/audio/mcp.rst rename to doc/services/connectivity/bluetooth/shell/audio/mcp.rst diff --git a/doc/connectivity/bluetooth/shell/audio/pbp.rst b/doc/services/connectivity/bluetooth/shell/audio/pbp.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/audio/pbp.rst rename to doc/services/connectivity/bluetooth/shell/audio/pbp.rst diff --git a/doc/connectivity/bluetooth/shell/audio/tbs.rst b/doc/services/connectivity/bluetooth/shell/audio/tbs.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/audio/tbs.rst rename to doc/services/connectivity/bluetooth/shell/audio/tbs.rst diff --git a/doc/connectivity/bluetooth/shell/audio/tmap.rst b/doc/services/connectivity/bluetooth/shell/audio/tmap.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/audio/tmap.rst rename to doc/services/connectivity/bluetooth/shell/audio/tmap.rst diff --git a/doc/connectivity/bluetooth/shell/classic/a2dp.rst b/doc/services/connectivity/bluetooth/shell/classic/a2dp.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/classic/a2dp.rst rename to doc/services/connectivity/bluetooth/shell/classic/a2dp.rst diff --git a/doc/connectivity/bluetooth/shell/classic/goep.rst b/doc/services/connectivity/bluetooth/shell/classic/goep.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/classic/goep.rst rename to doc/services/connectivity/bluetooth/shell/classic/goep.rst diff --git a/doc/connectivity/bluetooth/shell/classic/hfp.rst b/doc/services/connectivity/bluetooth/shell/classic/hfp.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/classic/hfp.rst rename to doc/services/connectivity/bluetooth/shell/classic/hfp.rst diff --git a/doc/connectivity/bluetooth/shell/classic/l2cap.rst b/doc/services/connectivity/bluetooth/shell/classic/l2cap.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/classic/l2cap.rst rename to doc/services/connectivity/bluetooth/shell/classic/l2cap.rst diff --git a/doc/connectivity/bluetooth/shell/classic/rfcomm.rst b/doc/services/connectivity/bluetooth/shell/classic/rfcomm.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/classic/rfcomm.rst rename to doc/services/connectivity/bluetooth/shell/classic/rfcomm.rst diff --git a/doc/connectivity/bluetooth/shell/host/gap.rst b/doc/services/connectivity/bluetooth/shell/host/gap.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/host/gap.rst rename to doc/services/connectivity/bluetooth/shell/host/gap.rst diff --git a/doc/connectivity/bluetooth/shell/host/gatt.rst b/doc/services/connectivity/bluetooth/shell/host/gatt.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/host/gatt.rst rename to doc/services/connectivity/bluetooth/shell/host/gatt.rst diff --git a/doc/connectivity/bluetooth/shell/host/iso.rst b/doc/services/connectivity/bluetooth/shell/host/iso.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/host/iso.rst rename to doc/services/connectivity/bluetooth/shell/host/iso.rst diff --git a/doc/connectivity/bluetooth/shell/host/l2cap.rst b/doc/services/connectivity/bluetooth/shell/host/l2cap.rst similarity index 100% rename from doc/connectivity/bluetooth/shell/host/l2cap.rst rename to doc/services/connectivity/bluetooth/shell/host/l2cap.rst diff --git a/doc/connectivity/canbus/index.rst b/doc/services/connectivity/canbus/index.rst similarity index 100% rename from doc/connectivity/canbus/index.rst rename to doc/services/connectivity/canbus/index.rst diff --git a/doc/connectivity/canbus/isotp.rst b/doc/services/connectivity/canbus/isotp.rst similarity index 100% rename from doc/connectivity/canbus/isotp.rst rename to doc/services/connectivity/canbus/isotp.rst diff --git a/doc/connectivity/canbus/isotp_sequence.svg b/doc/services/connectivity/canbus/isotp_sequence.svg similarity index 100% rename from doc/connectivity/canbus/isotp_sequence.svg rename to doc/services/connectivity/canbus/isotp_sequence.svg diff --git a/doc/connectivity/index.rst b/doc/services/connectivity/index.rst similarity index 100% rename from doc/connectivity/index.rst rename to doc/services/connectivity/index.rst diff --git a/doc/connectivity/lora_lorawan/index.rst b/doc/services/connectivity/lora_lorawan/index.rst similarity index 100% rename from doc/connectivity/lora_lorawan/index.rst rename to doc/services/connectivity/lora_lorawan/index.rst diff --git a/doc/connectivity/modbus/index.rst b/doc/services/connectivity/modbus/index.rst similarity index 100% rename from doc/connectivity/modbus/index.rst rename to doc/services/connectivity/modbus/index.rst diff --git a/doc/connectivity/networking/api/8021Qav.rst b/doc/services/connectivity/networking/api/8021Qav.rst similarity index 100% rename from doc/connectivity/networking/api/8021Qav.rst rename to doc/services/connectivity/networking/api/8021Qav.rst diff --git a/doc/connectivity/networking/api/apis.rst b/doc/services/connectivity/networking/api/apis.rst similarity index 100% rename from doc/connectivity/networking/api/apis.rst rename to doc/services/connectivity/networking/api/apis.rst diff --git a/doc/connectivity/networking/api/buf_mgmt.rst b/doc/services/connectivity/networking/api/buf_mgmt.rst similarity index 100% rename from doc/connectivity/networking/api/buf_mgmt.rst rename to doc/services/connectivity/networking/api/buf_mgmt.rst diff --git a/doc/connectivity/networking/api/capture.rst b/doc/services/connectivity/networking/api/capture.rst similarity index 100% rename from doc/connectivity/networking/api/capture.rst rename to doc/services/connectivity/networking/api/capture.rst diff --git a/doc/connectivity/networking/api/coap.rst b/doc/services/connectivity/networking/api/coap.rst similarity index 100% rename from doc/connectivity/networking/api/coap.rst rename to doc/services/connectivity/networking/api/coap.rst diff --git a/doc/connectivity/networking/api/coap_client.rst b/doc/services/connectivity/networking/api/coap_client.rst similarity index 100% rename from doc/connectivity/networking/api/coap_client.rst rename to doc/services/connectivity/networking/api/coap_client.rst diff --git a/doc/connectivity/networking/api/coap_server.rst b/doc/services/connectivity/networking/api/coap_server.rst similarity index 100% rename from doc/connectivity/networking/api/coap_server.rst rename to doc/services/connectivity/networking/api/coap_server.rst diff --git a/doc/connectivity/networking/api/dhcpv4.rst b/doc/services/connectivity/networking/api/dhcpv4.rst similarity index 100% rename from doc/connectivity/networking/api/dhcpv4.rst rename to doc/services/connectivity/networking/api/dhcpv4.rst diff --git a/doc/connectivity/networking/api/dhcpv6.rst b/doc/services/connectivity/networking/api/dhcpv6.rst similarity index 100% rename from doc/connectivity/networking/api/dhcpv6.rst rename to doc/services/connectivity/networking/api/dhcpv6.rst diff --git a/doc/connectivity/networking/api/dns_resolve.rst b/doc/services/connectivity/networking/api/dns_resolve.rst similarity index 100% rename from doc/connectivity/networking/api/dns_resolve.rst rename to doc/services/connectivity/networking/api/dns_resolve.rst diff --git a/doc/connectivity/networking/api/ethernet.rst b/doc/services/connectivity/networking/api/ethernet.rst similarity index 100% rename from doc/connectivity/networking/api/ethernet.rst rename to doc/services/connectivity/networking/api/ethernet.rst diff --git a/doc/connectivity/networking/api/ethernet_mgmt.rst b/doc/services/connectivity/networking/api/ethernet_mgmt.rst similarity index 100% rename from doc/connectivity/networking/api/ethernet_mgmt.rst rename to doc/services/connectivity/networking/api/ethernet_mgmt.rst diff --git a/doc/connectivity/networking/api/gptp.rst b/doc/services/connectivity/networking/api/gptp.rst similarity index 100% rename from doc/connectivity/networking/api/gptp.rst rename to doc/services/connectivity/networking/api/gptp.rst diff --git a/doc/connectivity/networking/api/http_client.rst b/doc/services/connectivity/networking/api/http_client.rst similarity index 100% rename from doc/connectivity/networking/api/http_client.rst rename to doc/services/connectivity/networking/api/http_client.rst diff --git a/doc/connectivity/networking/api/http_server.rst b/doc/services/connectivity/networking/api/http_server.rst similarity index 100% rename from doc/connectivity/networking/api/http_server.rst rename to doc/services/connectivity/networking/api/http_server.rst diff --git a/doc/connectivity/networking/api/ieee802154.rst b/doc/services/connectivity/networking/api/ieee802154.rst similarity index 100% rename from doc/connectivity/networking/api/ieee802154.rst rename to doc/services/connectivity/networking/api/ieee802154.rst diff --git a/doc/connectivity/networking/api/images/lwm2m_engine_state_machine.svg b/doc/services/connectivity/networking/api/images/lwm2m_engine_state_machine.svg similarity index 100% rename from doc/connectivity/networking/api/images/lwm2m_engine_state_machine.svg rename to doc/services/connectivity/networking/api/images/lwm2m_engine_state_machine.svg diff --git a/doc/connectivity/networking/api/images/lwm2m_lifetime_both.png b/doc/services/connectivity/networking/api/images/lwm2m_lifetime_both.png similarity index 100% rename from doc/connectivity/networking/api/images/lwm2m_lifetime_both.png rename to doc/services/connectivity/networking/api/images/lwm2m_lifetime_both.png diff --git a/doc/connectivity/networking/api/images/lwm2m_lifetime_seconds_early.png b/doc/services/connectivity/networking/api/images/lwm2m_lifetime_seconds_early.png similarity index 100% rename from doc/connectivity/networking/api/images/lwm2m_lifetime_seconds_early.png rename to doc/services/connectivity/networking/api/images/lwm2m_lifetime_seconds_early.png diff --git a/doc/connectivity/networking/api/index.rst b/doc/services/connectivity/networking/api/index.rst similarity index 100% rename from doc/connectivity/networking/api/index.rst rename to doc/services/connectivity/networking/api/index.rst diff --git a/doc/connectivity/networking/api/ip_4_6.rst b/doc/services/connectivity/networking/api/ip_4_6.rst similarity index 100% rename from doc/connectivity/networking/api/ip_4_6.rst rename to doc/services/connectivity/networking/api/ip_4_6.rst diff --git a/doc/connectivity/networking/api/latmon.rst b/doc/services/connectivity/networking/api/latmon.rst similarity index 100% rename from doc/connectivity/networking/api/latmon.rst rename to doc/services/connectivity/networking/api/latmon.rst diff --git a/doc/connectivity/networking/api/lldp.rst b/doc/services/connectivity/networking/api/lldp.rst similarity index 100% rename from doc/connectivity/networking/api/lldp.rst rename to doc/services/connectivity/networking/api/lldp.rst diff --git a/doc/connectivity/networking/api/lwm2m.rst b/doc/services/connectivity/networking/api/lwm2m.rst similarity index 100% rename from doc/connectivity/networking/api/lwm2m.rst rename to doc/services/connectivity/networking/api/lwm2m.rst diff --git a/doc/connectivity/networking/api/mac_config.rst b/doc/services/connectivity/networking/api/mac_config.rst similarity index 100% rename from doc/connectivity/networking/api/mac_config.rst rename to doc/services/connectivity/networking/api/mac_config.rst diff --git a/doc/connectivity/networking/api/mqtt.rst b/doc/services/connectivity/networking/api/mqtt.rst similarity index 100% rename from doc/connectivity/networking/api/mqtt.rst rename to doc/services/connectivity/networking/api/mqtt.rst diff --git a/doc/connectivity/networking/api/mqtt_sn.rst b/doc/services/connectivity/networking/api/mqtt_sn.rst similarity index 100% rename from doc/connectivity/networking/api/mqtt_sn.rst rename to doc/services/connectivity/networking/api/mqtt_sn.rst diff --git a/doc/connectivity/networking/api/net_config.rst b/doc/services/connectivity/networking/api/net_config.rst similarity index 100% rename from doc/connectivity/networking/api/net_config.rst rename to doc/services/connectivity/networking/api/net_config.rst diff --git a/doc/connectivity/networking/api/net_context.rst b/doc/services/connectivity/networking/api/net_context.rst similarity index 100% rename from doc/connectivity/networking/api/net_context.rst rename to doc/services/connectivity/networking/api/net_context.rst diff --git a/doc/connectivity/networking/api/net_core.rst b/doc/services/connectivity/networking/api/net_core.rst similarity index 100% rename from doc/connectivity/networking/api/net_core.rst rename to doc/services/connectivity/networking/api/net_core.rst diff --git a/doc/connectivity/networking/api/net_hostname.rst b/doc/services/connectivity/networking/api/net_hostname.rst similarity index 100% rename from doc/connectivity/networking/api/net_hostname.rst rename to doc/services/connectivity/networking/api/net_hostname.rst diff --git a/doc/connectivity/networking/api/net_if.rst b/doc/services/connectivity/networking/api/net_if.rst similarity index 100% rename from doc/connectivity/networking/api/net_if.rst rename to doc/services/connectivity/networking/api/net_if.rst diff --git a/doc/connectivity/networking/api/net_l2.rst b/doc/services/connectivity/networking/api/net_l2.rst similarity index 100% rename from doc/connectivity/networking/api/net_l2.rst rename to doc/services/connectivity/networking/api/net_l2.rst diff --git a/doc/connectivity/networking/api/net_linkaddr.rst b/doc/services/connectivity/networking/api/net_linkaddr.rst similarity index 100% rename from doc/connectivity/networking/api/net_linkaddr.rst rename to doc/services/connectivity/networking/api/net_linkaddr.rst diff --git a/doc/connectivity/networking/api/net_mgmt.rst b/doc/services/connectivity/networking/api/net_mgmt.rst similarity index 100% rename from doc/connectivity/networking/api/net_mgmt.rst rename to doc/services/connectivity/networking/api/net_mgmt.rst diff --git a/doc/connectivity/networking/api/net_offload.rst b/doc/services/connectivity/networking/api/net_offload.rst similarity index 100% rename from doc/connectivity/networking/api/net_offload.rst rename to doc/services/connectivity/networking/api/net_offload.rst diff --git a/doc/connectivity/networking/api/net_pkt.rst b/doc/services/connectivity/networking/api/net_pkt.rst similarity index 100% rename from doc/connectivity/networking/api/net_pkt.rst rename to doc/services/connectivity/networking/api/net_pkt.rst diff --git a/doc/connectivity/networking/api/net_pkt_filter.rst b/doc/services/connectivity/networking/api/net_pkt_filter.rst similarity index 100% rename from doc/connectivity/networking/api/net_pkt_filter.rst rename to doc/services/connectivity/networking/api/net_pkt_filter.rst diff --git a/doc/connectivity/networking/api/net_shell.rst b/doc/services/connectivity/networking/api/net_shell.rst similarity index 100% rename from doc/connectivity/networking/api/net_shell.rst rename to doc/services/connectivity/networking/api/net_shell.rst diff --git a/doc/connectivity/networking/api/net_stats.rst b/doc/services/connectivity/networking/api/net_stats.rst similarity index 100% rename from doc/connectivity/networking/api/net_stats.rst rename to doc/services/connectivity/networking/api/net_stats.rst diff --git a/doc/connectivity/networking/api/net_tech.rst b/doc/services/connectivity/networking/api/net_tech.rst similarity index 100% rename from doc/connectivity/networking/api/net_tech.rst rename to doc/services/connectivity/networking/api/net_tech.rst diff --git a/doc/connectivity/networking/api/net_time.rst b/doc/services/connectivity/networking/api/net_time.rst similarity index 100% rename from doc/connectivity/networking/api/net_time.rst rename to doc/services/connectivity/networking/api/net_time.rst diff --git a/doc/connectivity/networking/api/net_timeout.rst b/doc/services/connectivity/networking/api/net_timeout.rst similarity index 100% rename from doc/connectivity/networking/api/net_timeout.rst rename to doc/services/connectivity/networking/api/net_timeout.rst diff --git a/doc/connectivity/networking/api/ocpp.rst b/doc/services/connectivity/networking/api/ocpp.rst similarity index 100% rename from doc/connectivity/networking/api/ocpp.rst rename to doc/services/connectivity/networking/api/ocpp.rst diff --git a/doc/connectivity/networking/api/ppp.rst b/doc/services/connectivity/networking/api/ppp.rst similarity index 100% rename from doc/connectivity/networking/api/ppp.rst rename to doc/services/connectivity/networking/api/ppp.rst diff --git a/doc/connectivity/networking/api/promiscuous.rst b/doc/services/connectivity/networking/api/promiscuous.rst similarity index 100% rename from doc/connectivity/networking/api/promiscuous.rst rename to doc/services/connectivity/networking/api/promiscuous.rst diff --git a/doc/connectivity/networking/api/protocols.rst b/doc/services/connectivity/networking/api/protocols.rst similarity index 100% rename from doc/connectivity/networking/api/protocols.rst rename to doc/services/connectivity/networking/api/protocols.rst diff --git a/doc/connectivity/networking/api/ptp.rst b/doc/services/connectivity/networking/api/ptp.rst similarity index 100% rename from doc/connectivity/networking/api/ptp.rst rename to doc/services/connectivity/networking/api/ptp.rst diff --git a/doc/connectivity/networking/api/ptp_time.rst b/doc/services/connectivity/networking/api/ptp_time.rst similarity index 100% rename from doc/connectivity/networking/api/ptp_time.rst rename to doc/services/connectivity/networking/api/ptp_time.rst diff --git a/doc/connectivity/networking/api/sntp.rst b/doc/services/connectivity/networking/api/sntp.rst similarity index 100% rename from doc/connectivity/networking/api/sntp.rst rename to doc/services/connectivity/networking/api/sntp.rst diff --git a/doc/connectivity/networking/api/socket_service.rst b/doc/services/connectivity/networking/api/socket_service.rst similarity index 100% rename from doc/connectivity/networking/api/socket_service.rst rename to doc/services/connectivity/networking/api/socket_service.rst diff --git a/doc/connectivity/networking/api/sockets.rst b/doc/services/connectivity/networking/api/sockets.rst similarity index 100% rename from doc/connectivity/networking/api/sockets.rst rename to doc/services/connectivity/networking/api/sockets.rst diff --git a/doc/connectivity/networking/api/socks5.rst b/doc/services/connectivity/networking/api/socks5.rst similarity index 100% rename from doc/connectivity/networking/api/socks5.rst rename to doc/services/connectivity/networking/api/socks5.rst diff --git a/doc/connectivity/networking/api/system_mgmt.rst b/doc/services/connectivity/networking/api/system_mgmt.rst similarity index 100% rename from doc/connectivity/networking/api/system_mgmt.rst rename to doc/services/connectivity/networking/api/system_mgmt.rst diff --git a/doc/connectivity/networking/api/tftp.rst b/doc/services/connectivity/networking/api/tftp.rst similarity index 100% rename from doc/connectivity/networking/api/tftp.rst rename to doc/services/connectivity/networking/api/tftp.rst diff --git a/doc/connectivity/networking/api/thread.rst b/doc/services/connectivity/networking/api/thread.rst similarity index 100% rename from doc/connectivity/networking/api/thread.rst rename to doc/services/connectivity/networking/api/thread.rst diff --git a/doc/connectivity/networking/api/tls_credentials_shell.rst b/doc/services/connectivity/networking/api/tls_credentials_shell.rst similarity index 100% rename from doc/connectivity/networking/api/tls_credentials_shell.rst rename to doc/services/connectivity/networking/api/tls_credentials_shell.rst diff --git a/doc/connectivity/networking/api/traffic-class.rst b/doc/services/connectivity/networking/api/traffic-class.rst similarity index 100% rename from doc/connectivity/networking/api/traffic-class.rst rename to doc/services/connectivity/networking/api/traffic-class.rst diff --git a/doc/connectivity/networking/api/trickle.rst b/doc/services/connectivity/networking/api/trickle.rst similarity index 100% rename from doc/connectivity/networking/api/trickle.rst rename to doc/services/connectivity/networking/api/trickle.rst diff --git a/doc/connectivity/networking/api/tsn.rst b/doc/services/connectivity/networking/api/tsn.rst similarity index 100% rename from doc/connectivity/networking/api/tsn.rst rename to doc/services/connectivity/networking/api/tsn.rst diff --git a/doc/connectivity/networking/api/vlan.rst b/doc/services/connectivity/networking/api/vlan.rst similarity index 100% rename from doc/connectivity/networking/api/vlan.rst rename to doc/services/connectivity/networking/api/vlan.rst diff --git a/doc/connectivity/networking/api/websocket.rst b/doc/services/connectivity/networking/api/websocket.rst similarity index 100% rename from doc/connectivity/networking/api/websocket.rst rename to doc/services/connectivity/networking/api/websocket.rst diff --git a/doc/connectivity/networking/api/wifi.rst b/doc/services/connectivity/networking/api/wifi.rst similarity index 100% rename from doc/connectivity/networking/api/wifi.rst rename to doc/services/connectivity/networking/api/wifi.rst diff --git a/doc/connectivity/networking/api/wifi_credentials.rst b/doc/services/connectivity/networking/api/wifi_credentials.rst similarity index 100% rename from doc/connectivity/networking/api/wifi_credentials.rst rename to doc/services/connectivity/networking/api/wifi_credentials.rst diff --git a/doc/connectivity/networking/api/zperf.rst b/doc/services/connectivity/networking/api/zperf.rst similarity index 100% rename from doc/connectivity/networking/api/zperf.rst rename to doc/services/connectivity/networking/api/zperf.rst diff --git a/doc/connectivity/networking/armfvp_user_networking_setup.rst b/doc/services/connectivity/networking/armfvp_user_networking_setup.rst similarity index 100% rename from doc/connectivity/networking/armfvp_user_networking_setup.rst rename to doc/services/connectivity/networking/armfvp_user_networking_setup.rst diff --git a/doc/connectivity/networking/conn_mgr/figures/.gitignore b/doc/services/connectivity/networking/conn_mgr/figures/.gitignore similarity index 100% rename from doc/connectivity/networking/conn_mgr/figures/.gitignore rename to doc/services/connectivity/networking/conn_mgr/figures/.gitignore diff --git a/doc/connectivity/networking/conn_mgr/figures/integration_diagram_detailed.drawio b/doc/services/connectivity/networking/conn_mgr/figures/integration_diagram_detailed.drawio similarity index 100% rename from doc/connectivity/networking/conn_mgr/figures/integration_diagram_detailed.drawio rename to doc/services/connectivity/networking/conn_mgr/figures/integration_diagram_detailed.drawio diff --git a/doc/connectivity/networking/conn_mgr/figures/integration_diagram_detailed.svg b/doc/services/connectivity/networking/conn_mgr/figures/integration_diagram_detailed.svg similarity index 100% rename from doc/connectivity/networking/conn_mgr/figures/integration_diagram_detailed.svg rename to doc/services/connectivity/networking/conn_mgr/figures/integration_diagram_detailed.svg diff --git a/doc/connectivity/networking/conn_mgr/figures/integration_diagram_simplified.drawio b/doc/services/connectivity/networking/conn_mgr/figures/integration_diagram_simplified.drawio similarity index 100% rename from doc/connectivity/networking/conn_mgr/figures/integration_diagram_simplified.drawio rename to doc/services/connectivity/networking/conn_mgr/figures/integration_diagram_simplified.drawio diff --git a/doc/connectivity/networking/conn_mgr/figures/integration_diagram_simplified.svg b/doc/services/connectivity/networking/conn_mgr/figures/integration_diagram_simplified.svg similarity index 100% rename from doc/connectivity/networking/conn_mgr/figures/integration_diagram_simplified.svg rename to doc/services/connectivity/networking/conn_mgr/figures/integration_diagram_simplified.svg diff --git a/doc/connectivity/networking/conn_mgr/implementation.rst b/doc/services/connectivity/networking/conn_mgr/implementation.rst similarity index 100% rename from doc/connectivity/networking/conn_mgr/implementation.rst rename to doc/services/connectivity/networking/conn_mgr/implementation.rst diff --git a/doc/connectivity/networking/conn_mgr/index.rst b/doc/services/connectivity/networking/conn_mgr/index.rst similarity index 100% rename from doc/connectivity/networking/conn_mgr/index.rst rename to doc/services/connectivity/networking/conn_mgr/index.rst diff --git a/doc/connectivity/networking/conn_mgr/main.rst b/doc/services/connectivity/networking/conn_mgr/main.rst similarity index 100% rename from doc/connectivity/networking/conn_mgr/main.rst rename to doc/services/connectivity/networking/conn_mgr/main.rst diff --git a/doc/connectivity/networking/dsa.rst b/doc/services/connectivity/networking/dsa.rst similarity index 100% rename from doc/connectivity/networking/dsa.rst rename to doc/services/connectivity/networking/dsa.rst diff --git a/doc/connectivity/networking/dsa_txrx_process.svg b/doc/services/connectivity/networking/dsa_txrx_process.svg similarity index 100% rename from doc/connectivity/networking/dsa_txrx_process.svg rename to doc/services/connectivity/networking/dsa_txrx_process.svg diff --git a/doc/connectivity/networking/eth_bridge_native_sim_setup.rst b/doc/services/connectivity/networking/eth_bridge_native_sim_setup.rst similarity index 100% rename from doc/connectivity/networking/eth_bridge_native_sim_setup.rst rename to doc/services/connectivity/networking/eth_bridge_native_sim_setup.rst diff --git a/doc/connectivity/networking/index.rst b/doc/services/connectivity/networking/index.rst similarity index 100% rename from doc/connectivity/networking/index.rst rename to doc/services/connectivity/networking/index.rst diff --git a/doc/connectivity/networking/native_sim_setup.rst b/doc/services/connectivity/networking/native_sim_setup.rst similarity index 100% rename from doc/connectivity/networking/native_sim_setup.rst rename to doc/services/connectivity/networking/native_sim_setup.rst diff --git a/doc/connectivity/networking/net-stack-architecture.rst b/doc/services/connectivity/networking/net-stack-architecture.rst similarity index 100% rename from doc/connectivity/networking/net-stack-architecture.rst rename to doc/services/connectivity/networking/net-stack-architecture.rst diff --git a/doc/connectivity/networking/net_config_guide.rst b/doc/services/connectivity/networking/net_config_guide.rst similarity index 100% rename from doc/connectivity/networking/net_config_guide.rst rename to doc/services/connectivity/networking/net_config_guide.rst diff --git a/doc/connectivity/networking/net_pkt_processing_stats.rst b/doc/services/connectivity/networking/net_pkt_processing_stats.rst similarity index 100% rename from doc/connectivity/networking/net_pkt_processing_stats.rst rename to doc/services/connectivity/networking/net_pkt_processing_stats.rst diff --git a/doc/connectivity/networking/network_monitoring.rst b/doc/services/connectivity/networking/network_monitoring.rst similarity index 100% rename from doc/connectivity/networking/network_monitoring.rst rename to doc/services/connectivity/networking/network_monitoring.rst diff --git a/doc/connectivity/networking/network_tracing.rst b/doc/services/connectivity/networking/network_tracing.rst similarity index 100% rename from doc/connectivity/networking/network_tracing.rst rename to doc/services/connectivity/networking/network_tracing.rst diff --git a/doc/connectivity/networking/networking_with_host.rst b/doc/services/connectivity/networking/networking_with_host.rst similarity index 100% rename from doc/connectivity/networking/networking_with_host.rst rename to doc/services/connectivity/networking/networking_with_host.rst diff --git a/doc/connectivity/networking/networking_with_multiple_instances.rst b/doc/services/connectivity/networking/networking_with_multiple_instances.rst similarity index 100% rename from doc/connectivity/networking/networking_with_multiple_instances.rst rename to doc/services/connectivity/networking/networking_with_multiple_instances.rst diff --git a/doc/connectivity/networking/overview.rst b/doc/services/connectivity/networking/overview.rst similarity index 100% rename from doc/connectivity/networking/overview.rst rename to doc/services/connectivity/networking/overview.rst diff --git a/doc/connectivity/networking/qemu_802154_setup.rst b/doc/services/connectivity/networking/qemu_802154_setup.rst similarity index 100% rename from doc/connectivity/networking/qemu_802154_setup.rst rename to doc/services/connectivity/networking/qemu_802154_setup.rst diff --git a/doc/connectivity/networking/qemu_eth_setup.rst b/doc/services/connectivity/networking/qemu_eth_setup.rst similarity index 100% rename from doc/connectivity/networking/qemu_eth_setup.rst rename to doc/services/connectivity/networking/qemu_eth_setup.rst diff --git a/doc/connectivity/networking/qemu_setup.rst b/doc/services/connectivity/networking/qemu_setup.rst similarity index 100% rename from doc/connectivity/networking/qemu_setup.rst rename to doc/services/connectivity/networking/qemu_setup.rst diff --git a/doc/connectivity/networking/qemu_user_setup.rst b/doc/services/connectivity/networking/qemu_user_setup.rst similarity index 100% rename from doc/connectivity/networking/qemu_user_setup.rst rename to doc/services/connectivity/networking/qemu_user_setup.rst diff --git a/doc/connectivity/networking/usbnet_setup.rst b/doc/services/connectivity/networking/usbnet_setup.rst similarity index 100% rename from doc/connectivity/networking/usbnet_setup.rst rename to doc/services/connectivity/networking/usbnet_setup.rst diff --git a/doc/connectivity/networking/zephyr_netstack_overview-rx_sequence.svg b/doc/services/connectivity/networking/zephyr_netstack_overview-rx_sequence.svg similarity index 100% rename from doc/connectivity/networking/zephyr_netstack_overview-rx_sequence.svg rename to doc/services/connectivity/networking/zephyr_netstack_overview-rx_sequence.svg diff --git a/doc/connectivity/networking/zephyr_netstack_overview-tx_sequence.svg b/doc/services/connectivity/networking/zephyr_netstack_overview-tx_sequence.svg similarity index 100% rename from doc/connectivity/networking/zephyr_netstack_overview-tx_sequence.svg rename to doc/services/connectivity/networking/zephyr_netstack_overview-tx_sequence.svg diff --git a/doc/connectivity/networking/zephyr_netstack_overview.jpg b/doc/services/connectivity/networking/zephyr_netstack_overview.jpg similarity index 100% rename from doc/connectivity/networking/zephyr_netstack_overview.jpg rename to doc/services/connectivity/networking/zephyr_netstack_overview.jpg diff --git a/doc/connectivity/networking/zephyr_netstack_overview.svg b/doc/services/connectivity/networking/zephyr_netstack_overview.svg similarity index 100% rename from doc/connectivity/networking/zephyr_netstack_overview.svg rename to doc/services/connectivity/networking/zephyr_netstack_overview.svg diff --git a/doc/connectivity/networking/zephyr_netstack_overview.vsdx b/doc/services/connectivity/networking/zephyr_netstack_overview.vsdx similarity index 100% rename from doc/connectivity/networking/zephyr_netstack_overview.vsdx rename to doc/services/connectivity/networking/zephyr_netstack_overview.vsdx diff --git a/doc/connectivity/usb/api/hid.rst b/doc/services/connectivity/usb/api/hid.rst similarity index 100% rename from doc/connectivity/usb/api/hid.rst rename to doc/services/connectivity/usb/api/hid.rst diff --git a/doc/connectivity/usb/device/api/index.rst b/doc/services/connectivity/usb/device/api/index.rst similarity index 100% rename from doc/connectivity/usb/device/api/index.rst rename to doc/services/connectivity/usb/device/api/index.rst diff --git a/doc/connectivity/usb/device/api/usb_dc.rst b/doc/services/connectivity/usb/device/api/usb_dc.rst similarity index 100% rename from doc/connectivity/usb/device/api/usb_dc.rst rename to doc/services/connectivity/usb/device/api/usb_dc.rst diff --git a/doc/connectivity/usb/device/api/usb_device.rst b/doc/services/connectivity/usb/device/api/usb_device.rst similarity index 100% rename from doc/connectivity/usb/device/api/usb_device.rst rename to doc/services/connectivity/usb/device/api/usb_device.rst diff --git a/doc/connectivity/usb/device/api/usb_device_bos.rst b/doc/services/connectivity/usb/device/api/usb_device_bos.rst similarity index 100% rename from doc/connectivity/usb/device/api/usb_device_bos.rst rename to doc/services/connectivity/usb/device/api/usb_device_bos.rst diff --git a/doc/connectivity/usb/device/api/usb_device_hid.rst b/doc/services/connectivity/usb/device/api/usb_device_hid.rst similarity index 100% rename from doc/connectivity/usb/device/api/usb_device_hid.rst rename to doc/services/connectivity/usb/device/api/usb_device_hid.rst diff --git a/doc/connectivity/usb/device/usb_device.rst b/doc/services/connectivity/usb/device/usb_device.rst similarity index 100% rename from doc/connectivity/usb/device/usb_device.rst rename to doc/services/connectivity/usb/device/usb_device.rst diff --git a/doc/connectivity/usb/device_next/api/index.rst b/doc/services/connectivity/usb/device_next/api/index.rst similarity index 100% rename from doc/connectivity/usb/device_next/api/index.rst rename to doc/services/connectivity/usb/device_next/api/index.rst diff --git a/doc/connectivity/usb/device_next/api/uac2_device.rst b/doc/services/connectivity/usb/device_next/api/uac2_device.rst similarity index 100% rename from doc/connectivity/usb/device_next/api/uac2_device.rst rename to doc/services/connectivity/usb/device_next/api/uac2_device.rst diff --git a/doc/connectivity/usb/device_next/api/udc.rst b/doc/services/connectivity/usb/device_next/api/udc.rst similarity index 100% rename from doc/connectivity/usb/device_next/api/udc.rst rename to doc/services/connectivity/usb/device_next/api/udc.rst diff --git a/doc/connectivity/usb/device_next/api/usbd.rst b/doc/services/connectivity/usb/device_next/api/usbd.rst similarity index 100% rename from doc/connectivity/usb/device_next/api/usbd.rst rename to doc/services/connectivity/usb/device_next/api/usbd.rst diff --git a/doc/connectivity/usb/device_next/api/usbd_dfu.rst b/doc/services/connectivity/usb/device_next/api/usbd_dfu.rst similarity index 100% rename from doc/connectivity/usb/device_next/api/usbd_dfu.rst rename to doc/services/connectivity/usb/device_next/api/usbd_dfu.rst diff --git a/doc/connectivity/usb/device_next/api/usbd_hid_device.rst b/doc/services/connectivity/usb/device_next/api/usbd_hid_device.rst similarity index 100% rename from doc/connectivity/usb/device_next/api/usbd_hid_device.rst rename to doc/services/connectivity/usb/device_next/api/usbd_hid_device.rst diff --git a/doc/connectivity/usb/device_next/api/usbd_midi2.rst b/doc/services/connectivity/usb/device_next/api/usbd_midi2.rst similarity index 100% rename from doc/connectivity/usb/device_next/api/usbd_midi2.rst rename to doc/services/connectivity/usb/device_next/api/usbd_midi2.rst diff --git a/doc/connectivity/usb/device_next/api/usbd_msc_device.rst b/doc/services/connectivity/usb/device_next/api/usbd_msc_device.rst similarity index 100% rename from doc/connectivity/usb/device_next/api/usbd_msc_device.rst rename to doc/services/connectivity/usb/device_next/api/usbd_msc_device.rst diff --git a/doc/connectivity/usb/device_next/usb_device.rst b/doc/services/connectivity/usb/device_next/usb_device.rst similarity index 100% rename from doc/connectivity/usb/device_next/usb_device.rst rename to doc/services/connectivity/usb/device_next/usb_device.rst diff --git a/doc/connectivity/usb/host/api/index.rst b/doc/services/connectivity/usb/host/api/index.rst similarity index 100% rename from doc/connectivity/usb/host/api/index.rst rename to doc/services/connectivity/usb/host/api/index.rst diff --git a/doc/connectivity/usb/host/api/uhc.rst b/doc/services/connectivity/usb/host/api/uhc.rst similarity index 100% rename from doc/connectivity/usb/host/api/uhc.rst rename to doc/services/connectivity/usb/host/api/uhc.rst diff --git a/doc/connectivity/usb/host/usbip.rst b/doc/services/connectivity/usb/host/usbip.rst similarity index 100% rename from doc/connectivity/usb/host/usbip.rst rename to doc/services/connectivity/usb/host/usbip.rst diff --git a/doc/connectivity/usb/index.rst b/doc/services/connectivity/usb/index.rst similarity index 100% rename from doc/connectivity/usb/index.rst rename to doc/services/connectivity/usb/index.rst diff --git a/doc/connectivity/usb/pd/ucds.rst b/doc/services/connectivity/usb/pd/ucds.rst similarity index 100% rename from doc/connectivity/usb/pd/ucds.rst rename to doc/services/connectivity/usb/pd/ucds.rst diff --git a/doc/services/index.rst b/doc/services/index.rst index 0d20245646b94..8593b20b09994 100644 --- a/doc/services/index.rst +++ b/doc/services/index.rst @@ -64,6 +64,12 @@ enabling application portability across different platforms. High-level frameworks and libraries for application development. + .. grid-item-card:: :material-twotone:`lan;36px` Connectivity + :link: connectivity + :link-type: ref + + Bluetooth, networking, USB, CAN bus, and other connectivity protocols. + .. toctree:: :maxdepth: 2 :hidden: @@ -77,3 +83,4 @@ enabling application portability across different platforms. security.rst algorithms.rst application_services.rst + connectivity/index.rst