From 5cdb1bf3db765c144b7c0b4556545a013c8bc276 Mon Sep 17 00:00:00 2001 From: Christophe Dufaza Date: Tue, 27 Aug 2024 08:32:34 +0200 Subject: [PATCH] ci: update documentation site Publish documentation site without references from the Handbook to the Getting Started Guide. --- docs/_sources/getting-started.rst.txt | 10 - docs/_sources/handbook.rst.txt | 273 +++++++++++++++++++++----- docs/getting-started.html | 10 +- docs/handbook.html | 243 ++++++++++++++++++----- docs/index.html | 1 + docs/objects.inv | Bin 1467 -> 1452 bytes docs/searchindex.js | 2 +- 7 files changed, 424 insertions(+), 115 deletions(-) diff --git a/docs/_sources/getting-started.rst.txt b/docs/_sources/getting-started.rst.txt index 1620ef3..dd933a6 100644 --- a/docs/_sources/getting-started.rst.txt +++ b/docs/_sources/getting-started.rst.txt @@ -140,8 +140,6 @@ convenient but avoids installing anything in a development environment you actua pip install -U dtsh -.. _dtsh-usage: - Usage ***** @@ -176,8 +174,6 @@ We'll first confirm that the installation went well with a simple but typical us before tackling a few other scenarios. -.. _dtsh-usage-default: - Typical Use =========== @@ -240,8 +236,6 @@ from the CMake cache content in ``CMakeCache.txt``:: or if using West ``cd && west build && dtsh`` -.. _dtsh-usage-others: - Other Uses ========== @@ -279,8 +273,6 @@ Where: - one of these directories shall contain a valid vendors file, e.g. ``dir1/vendor-prefixes.txt`` -.. _dtsh-usage-batch: - Batch Mode ========== @@ -320,8 +312,6 @@ following command: ❭ -.. _dtsh-configuration: - Configuration ************* diff --git a/docs/_sources/handbook.rst.txt b/docs/_sources/handbook.rst.txt index 197cb15..3f9496c 100644 --- a/docs/_sources/handbook.rst.txt +++ b/docs/_sources/handbook.rst.txt @@ -3,9 +3,6 @@ DTSh's Handbook ############### -This handbook assumes you've already installed DTSh, and know how to open DTS files with ``dtsh``. -If not, please go to the :ref:`dtsh-getting-started`. - .. figure:: img/buses.png :align: center :alt: Buses @@ -14,6 +11,223 @@ If not, please go to the :ref:`dtsh-getting-started`. ``find --on-bus * --OR --with-bus * -T --format NYCd`` +.. _dtsh-usage: + +Usage +***** + +Once installed, the Devicetree Shell is available as the ``dtsh`` command: + +.. code-block:: none + + $ dtsh -h + usage: dtsh [-h] [-b DIR] [-u] [--preferences FILE] [--theme FILE] [-c CMD] [-f FILE] [-i] [DTS] + + shell-like interface with Devicetree + + options: + -h, --help show this help message and exit + + open a DTS file: + -b DIR, --bindings DIR + directory to search for binding files + DTS path to the DTS file + + user files: + -u, --user-files initialize per-user configuration files and exit + --preferences FILE load additional preferences file + --theme FILE load additional styles file + + session control: + -c CMD execute CMD at startup (may be repeated) + -f FILE execute batch commands from FILE at startup + -i, --interactive enter interactive loop after batch commands + +.. _dtsh-typical-use: + +Typical Use +=========== + +Early at build-time, during the `configuration phase `_, +Zephyr *assembles* the final `devicetree `_ that will represent +the system hardware during the actual build phase. + +This devicetree is saved in `Devicetree Source Format `_ (DTS) +in ``build/zephyr/zephyr.dts`` for *debugging* purpose. + +The typical DTSh's use case is to open this DTS file generated at build-time, e.g.: + +.. code-block:: none + + $ cd zephyr/samples/sensor/bme680 + $ cmake -B build -DBOARD=nrf52840dk_nrf52840 + $ dtsh build/zephyr/zephyr.dts + dtsh (0.2.3): A Devicetree Shell + How to exit: q, or quit, or exit, or press Ctrl-D + + / + > ls -l + Name Labels Binding + ─────────────────────────────────────────────────────── + chosen + aliases + soc + pin-controller pinctrl nordic,nrf-pinctrl + entropy_bt_hci rng_hci zephyr,bt-hci-entropy + sw-pwm sw_pwm nordic,nrf-sw-pwm + cpus + leds gpio-leds + pwmleds pwm-leds + buttons gpio-keys + connector arduino_header arduino-header-r3 + analog-connector arduino_adc arduino,uno-adc + +The above example should *always* work: + +- regardless of the installation method, ``cmake`` being sufficient for the configuration phase +- regardless of whether ``ZEPHYR_BASE`` is set +- regardless of whether you target a `supported board `_ + or a `custom board `_ + +Here, DTSh retrieves *all it needs*, and especially where to search for the bindings files, +from the CMake cache content in ``CMakeCache.txt``:: + + build/ + ├── CMakeCache.txt + └── zephyr/ + └── zephyr.dts + +.. tip:: + + - In this context, no need to pass the DTS file path to DTSh: by default it will try + to open the devicetree at ``build/zephyr/zephyr.dts``; + ``dtsh /path/to/project/build/zephyr/zephyr.dts`` would also work, + you don't need to call ``dtsh`` from the project's root + - To open *your* devicetree: ``cd && cmake -B build -DBOARD= && dtsh``, + or if using West ``cd && west build && dtsh`` + + +.. _dtsh-other-uses: + +Other Uses +========== + +As we've seen, DTSh first tries to retrieve the bindings Zephyr has used at build-time, +when the DTS file was generated, from the CMake cache. +This is the most straight forward way to get a complete and legit bindings search path. + +When this fails, DTSh will then try to work out the search path +Zephyr would use if it were to generate the DTS *now* +(`Where Bindings Are Located `_): bindings found in +``$ZEPHYR_BASE/dts/bindings`` and other *default* directories should still cover +the most simple use cases (e.g. Zephyr samples). + +.. code-block:: none + + $ export ZEPHYR_BASE=/path/to/zephyrproject/zephyr + $ dtsh /path/to/zephyr.dts + +This default behavior does not address all situations, though: + +- you may need additional bindings files from a custom location, + or explicitly set the ``DTS_ROOT`` CMake variable +- you're not working with Zephyr + +For these use cases, the ``-b --bindings`` option permits to explicitly enumerate all the directories +to search in: + + $ dtsh --bindings dir1 --bindings dir2 foobar.dts + +Where: + +- ``dir1`` and ``dir1``, and their sub-directories, shall contain all necessary YAML binding files + in Zephyr's `Devicetree Binding Syntax `_, + even if not working with Zephyr +- one of these directories shall contain a valid vendors file, e.g. ``dir1/vendor-prefixes.txt`` + + +.. _dtsh-configuration: + +Configuration +============= + +Users can tweak DTSh appearance and behavior by overriding its defaults in configuration files: + +- ``dtsh.ini``: to override global preferences (see :ref:`dtsh-preferences`) +- ``theme.ini``: to override styles and colors (see :ref:`dtsh-themes`) + +These (optional) files must be located in a platform-dependent directory, +e.g. ``~/.config/dtsh`` on GNU/Linux systems. + +Running ``dtsh`` with the ``-u --user-files`` option will initialize configuration templates +in the expected location: + +.. code-block:: none + + $ dtsh -u + User preferences: ~/.config/dtsh/dtsh.ini + User theme: ~/.config/dtsh/theme.ini + +.. tip:: + + DTSh won't override a user file that already exists: manually remove the file(s), + and run the command again. + +Additionally: + +- the ``--preferences FILE`` option permits to specify an additional preferences file to load +- the ``--theme FILE`` option permits to specify an additional theme file to load + + +.. _dtsh-ini-format: + +Configuration Format +-------------------- + +Configuration files are simple INI files that contain key-value pairs. + +Values support *interpolation* with the ``${key}`` (preferences) or ``%(key)s`` (themes) syntax: + +.. code-block:: none + + # Define a key. + wchar.ellipsis = \u2026 + + # Reference it with interpolation. + et_caetera = Et caetera${wchar.ellipsis} + + # Use $$ to escape the dollar sign. + dollar = This is the dollar sign: $$ + +Values are typed: + +String + Strings may contain Unicode characters as literals + or 4-digit hexadecimal code points. + + It's necessary to double-quote strings only when: + + - the string value actually ends with spaces + - the string value contains the double quote character + + Leading and trailing double quotes are always striped. + +Boolean + Valid values (case-insensitive): + + - True: ``1``, ``yes``, ``true``, and ``on`` + - False: ``0``, ``no``, ``false``, and ``off`` + +Integer + Integers in base-10, base-2 (prefix ``0b``), base-8 (prefix ``0o``), + and base-16 (prefix ``Ox``) are supported. + + Prefixes are case insensitive. + +Float + Decimal (e.g. ``0.1``) and scientific (e.g. ``1e-1``) notations are supported. + + .. _dtsh-shell: The Shell @@ -804,56 +1018,7 @@ Preferences are loaded in that order: 3. if an additional preferences file is specified with the West command option ``--preferences``, it's eventually loaded, overriding previous values with the options it contains -See also :ref:`dtsh-configuration` in the Getting Started Guide. - - -.. _dtsh-ini-format: - -Configuration Format --------------------- - -DTSh is configured with simple INI files that contain key-value pairs. - -Values support *interpolation* with the ``${key}`` syntax: - -.. code-block:: none - - # Define a key. - wchar.ellipsis = \u2026 - - # Reference it with interpolation. - et_caetera = Et caetera${wchar.ellipsis} - - # Use $$ to escape the dollar sign. - dollar = This is the dollar sign: $$ - -Values are typed: - -String - Strings may contain Unicode characters as literals - or 4-digit hexadecimal code points. - - It's necessary to double-quote strings only when: - - - the string value actually ends with spaces - - the string value contains the double quote character - - Leading and trailing double quotes are always striped. - -Boolean - Valid values (case-insensitive): - - - True: ``1``, ``yes``, ``true``, and ``on`` - - False: ``0``, ``no``, ``false``, and ``off`` - -Integer - Integers in base-10, base-2 (prefix ``0b``), base-8 (prefix ``0o``), - and base-16 (prefix ``Ox``) are supported. - - Prefixes are case insensitive. - -Float - Decimal (e.g. ``0.1``) and scientific (e.g. ``1e-1``) notations are supported. +See also :ref:`dtsh-configuration`. .. _dtsh-prefs-misc: @@ -3185,7 +3350,7 @@ Styles are loaded in that order: it's eventually loaded, overriding previous styles Initialize a theme template with ``dtsh -u`` if not already done -(see :ref:`dtsh-configuration` in the Getting Started Guide). +(see :ref:`dtsh-configuration`). Comments in the template file should be sufficient to understand how to write styles, and identify which style applies to which type of information. diff --git a/docs/getting-started.html b/docs/getting-started.html index e54fb47..a03e889 100644 --- a/docs/getting-started.html +++ b/docs/getting-started.html @@ -221,7 +221,7 @@
-

Usage

+

Usage

Once installed, the Devicetree Shell is available as the dtsh command:

$ dtsh -h
 usage: dtsh [-h] [-b DIR] [-u] [--preferences FILE] [--theme FILE] [-c CMD] [-f FILE] [-i] [DTS]
@@ -250,7 +250,7 @@
 
We’ll first confirm that the installation went well with a simple but typical usage,
 before tackling a few other scenarios.

 

-
Typical Use

+
Typical Use

 
Early at build-time, during the configuration phase,
 Zephyr assembles the final devicetree that will represent
 the system hardware during the actual build phase.

@@ -309,7 +309,7 @@
-

Other Uses

+

Other Uses

As we’ve seen, DTSh first tries to retrieve the bindings Zephyr has used at build-time, when the DTS file was generated, from the CMake cache. This is the most straight forward way to get a complete and legit bindings search path.

@@ -342,7 +342,7 @@
-

Batch Mode

+

Batch Mode

For scripting and automation, DTSh can also be used non-interactively by passing:

    @@ -380,7 +380,7 @@
-

Configuration

+

Configuration

Users can tweak DTSh appearance and behavior by overriding its defaults in configuration files:

  • dtsh.ini: to override global preferences (see User Preferences)

    • diff --git a/docs/handbook.html b/docs/handbook.html index dab69b1..37cf129 100644 --- a/docs/handbook.html +++ b/docs/handbook.html @@ -65,6 +65,15 @@
    • Getting Started Guide
    • DTSh’s Handbook
        +
      • Usage +
      • The Shell
        • Hierarchical File System Metaphor
        • The Command Line
            @@ -95,7 +104,6 @@
        • User Preferences
            -
          • Configuration Format
          • General Preferences
          • The Prompt
          • File System Access
            • @@ -209,14 +217,198 @@

            DTSh’s Handbook

            -

            This handbook assumes you’ve already installed DTSh, and know how to open DTS files with dtsh. -If not, please go to the Getting Started Guide.

            Buses

            find --on-bus * --OR --with-bus * -T --format NYCd

            +
            +

            Usage

            +

            Once installed, the Devicetree Shell is available as the dtsh command:

            +
            $ dtsh -h
+usage: dtsh [-h] [-b DIR] [-u] [--preferences FILE] [--theme FILE] [-c CMD] [-f FILE] [-i] [DTS]
+
+shell-like interface with Devicetree
+
+options:
+  -h, --help            show this help message and exit
+
+open a DTS file:
+  -b DIR, --bindings DIR
+                        directory to search for binding files
+  DTS                   path to the DTS file
+
+user files:
+  -u, --user-files      initialize per-user configuration files and exit
+  --preferences FILE    load additional preferences file
+  --theme FILE          load additional styles file
+
+session control:
+  -c CMD                execute CMD at startup (may be repeated)
+  -f FILE               execute batch commands from FILE at startup
+  -i, --interactive     enter interactive loop after batch commands
+
            +
            +
            +

            Typical Use

            +

            Early at build-time, during the configuration phase, +Zephyr assembles the final devicetree that will represent +the system hardware during the actual build phase.

            +

            This devicetree is saved in Devicetree Source Format (DTS) +in build/zephyr/zephyr.dts for debugging purpose.

            +

            The typical DTSh’s use case is to open this DTS file generated at build-time, e.g.:

            +
            $ cd zephyr/samples/sensor/bme680
+$ cmake -B build -DBOARD=nrf52840dk_nrf52840
+$ dtsh build/zephyr/zephyr.dts
+dtsh (0.2.3): A Devicetree Shell
+How to exit: q, or quit, or exit, or press Ctrl-D
+
+/
+> ls -l
+ Name              Labels          Binding
+ ───────────────────────────────────────────────────────
+ chosen
+ aliases
+ soc
+ pin-controller    pinctrl         nordic,nrf-pinctrl
+ entropy_bt_hci    rng_hci         zephyr,bt-hci-entropy
+ sw-pwm            sw_pwm          nordic,nrf-sw-pwm
+ cpus
+ leds                              gpio-leds
+ pwmleds                           pwm-leds
+ buttons                           gpio-keys
+ connector         arduino_header  arduino-header-r3
+ analog-connector  arduino_adc     arduino,uno-adc
+
            +
            +

            The above example should always work:

            +
              +

            • regardless of the installation method, cmake being sufficient for the configuration phase

              • +

            • regardless of whether ZEPHYR_BASE is set

              • +

            • regardless of whether you target a supported board +or a custom board

              • +
            +

            Here, DTSh retrieves all it needs, and especially where to search for the bindings files, +from the CMake cache content in CMakeCache.txt:

            +
            build/
+├── CMakeCache.txt
+└── zephyr/
+    └── zephyr.dts
+
            +
            +
            +

            Tip

            +
              +

            • In this context, no need to pass the DTS file path to DTSh: by default it will try +to open the devicetree at build/zephyr/zephyr.dts; +dtsh /path/to/project/build/zephyr/zephyr.dts would also work, +you don’t need to call dtsh from the project’s root

              • +

            • To open your devicetree: cd <project> && cmake -B build -DBOARD=<board> && dtsh, +or if using West cd <project> && west build && dtsh

              • +
            +
            +
            +
            +

            Other Uses

            +

            As we’ve seen, DTSh first tries to retrieve the bindings Zephyr has used at build-time, +when the DTS file was generated, from the CMake cache. +This is the most straight forward way to get a complete and legit bindings search path.

            +

            When this fails, DTSh will then try to work out the search path +Zephyr would use if it were to generate the DTS now +(Where Bindings Are Located): bindings found in +$ZEPHYR_BASE/dts/bindings and other default directories should still cover +the most simple use cases (e.g. Zephyr samples).

            +
            $ export ZEPHYR_BASE=/path/to/zephyrproject/zephyr
+$ dtsh /path/to/zephyr.dts
+
            +
            +

            This default behavior does not address all situations, though:

            +
              +

            • you may need additional bindings files from a custom location, +or explicitly set the DTS_ROOT CMake variable

              • +

            • you’re not working with Zephyr

              • +
            +

            For these use cases, the -b --bindings option permits to explicitly enumerate all the directories +to search in:

            +
            +

            $ dtsh –bindings dir1 –bindings dir2 foobar.dts

            +
            +

            Where:

            +
              +

            • dir1 and dir1, and their sub-directories, shall contain all necessary YAML binding files +in Zephyr’s Devicetree Binding Syntax, +even if not working with Zephyr

              • +

            • one of these directories shall contain a valid vendors file, e.g. dir1/vendor-prefixes.txt

              • +
            +
            +
            +

            Configuration

            +

            Users can tweak DTSh appearance and behavior by overriding its defaults in configuration files:

            + +

            These (optional) files must be located in a platform-dependent directory, +e.g. ~/.config/dtsh on GNU/Linux systems.

            +

            Running dtsh with the -u --user-files option will initialize configuration templates +in the expected location:

            +
            $ dtsh -u
+User preferences: ~/.config/dtsh/dtsh.ini
+User theme: ~/.config/dtsh/theme.ini
+
            +
            +
            +

            Tip

            +

            DTSh won’t override a user file that already exists: manually remove the file(s), +and run the command again.

            +
            +

            Additionally:

            +
              +

            • the --preferences FILE option permits to specify an additional preferences file to load

              • +

            • the --theme FILE option permits to specify an additional theme file to load

              • +
            +
            +

            Configuration Format

            +

            Configuration files are simple INI files that contain key-value pairs.

            +

            Values support interpolation with the ${key} (preferences) or %(key)s (themes) syntax:

            +
            # Define a key.
+wchar.ellipsis = \u2026
+
+# Reference it with interpolation.
+et_caetera = Et caetera${wchar.ellipsis}
+
+# Use $$ to escape the dollar sign.
+dollar = This is the dollar sign: $$
+
            +
            +

            Values are typed:

            +
            +
            String

            Strings may contain Unicode characters as literals +or 4-digit hexadecimal code points.

            +

            It’s necessary to double-quote strings only when:

            +
              +

            • the string value actually ends with spaces

              • +

            • the string value contains the double quote character

              • +
            +

            Leading and trailing double quotes are always striped.

            +
            +
            Boolean

            Valid values (case-insensitive):

            +
              +

            • True: 1, yes, true, and on

              • +

            • False: 0, no, false, and off

              • +
            +
            +
            Integer

            Integers in base-10, base-2 (prefix 0b), base-8 (prefix 0o), +and base-16 (prefix Ox) are supported.

            +

            Prefixes are case insensitive.

            +
            +
            Float

            Decimal (e.g. 0.1) and scientific (e.g. 1e-1) notations are supported.

            +
            +
            +
            +
            +

            The Shell

            DTSh is a command line interface for navigating, visualizing and searching a devicetree @@ -933,46 +1125,7 @@

          • if an additional preferences file is specified with the West command option --preferences, it’s eventually loaded, overriding previous values with the options it contains

            • -

            See also Configuration in the Getting Started Guide.

            -
            -

            Configuration Format

            -

            DTSh is configured with simple INI files that contain key-value pairs.

            -

            Values support interpolation with the ${key} syntax:

            -
            # Define a key.
-wchar.ellipsis = \u2026
-
-# Reference it with interpolation.
-et_caetera = Et caetera${wchar.ellipsis}
-
-# Use $$ to escape the dollar sign.
-dollar = This is the dollar sign: $$
-
            -
            -

            Values are typed:

            -
            -
            String

            Strings may contain Unicode characters as literals -or 4-digit hexadecimal code points.

            -

            It’s necessary to double-quote strings only when:

            -
              -

            • the string value actually ends with spaces

              • -

            • the string value contains the double quote character

              • -
            -

            Leading and trailing double quotes are always striped.

            -
            -
            Boolean

            Valid values (case-insensitive):

            -
              -

            • True: 1, yes, true, and on

              • -

            • False: 0, no, false, and off

              • -
            -
            -
            Integer

            Integers in base-10, base-2 (prefix 0b), base-8 (prefix 0o), -and base-16 (prefix Ox) are supported.

            -

            Prefixes are case insensitive.

            -
            -
            Float

            Decimal (e.g. 0.1) and scientific (e.g. 1e-1) notations are supported.

            -
            -
            -
            +

            See also Configuration.

            General Preferences

            @@ -2529,7 +2682,7 @@

            Tip

            The history file is located in the DTSh application data directory for the current user -(see Configuration).

            +(see Configuration).

            It’s a simple text file you may edit or remove.

            @@ -2839,7 +2992,7 @@ it’s eventually loaded, overriding previous styles

            Initialize a theme template with dtsh -u if not already done -(see Configuration in the Getting Started Guide).

            +(see Configuration).

            Comments in the template file should be sufficient to understand how to write styles, and identify which style applies to which type of information. The INI syntax itself is reminded in Configuration Format.

            diff --git a/docs/index.html b/docs/index.html index 5af6988..1b497e5 100644 --- a/docs/index.html +++ b/docs/index.html @@ -134,6 +134,7 @@

            Status<

        • DTSh’s Handbook
            +
          • Usage
          • The Shell
          • Built-in Commands
          • Textual User Interface
            • diff --git a/docs/objects.inv b/docs/objects.inv index cd5fdf12167fb11bc790862c2daa7575baf7a11c..d566aa64eda8fbd4ac189ddf0b60da21f6b2567b 100644 GIT binary patch delta 1348 zcmV-K1-tsY3#43+bo7+d~as)A%ck(}p0R<;)87paKlRY*=NR5ZCQEpHmFD{$X!HwEj%`} z_RN9PcWlSCu`oZ@jGOvB+QSBbeGsT^a^LQiuBq*B+s-}9RBM~oj>5acM4lWI%fJLP z!A+`)-hX$-5O>C!p#mm{(F$8M4hklNDoUG5CH(NnnWnm^cmaEl)r@Qo;QE@Z0`Bz& zt{=585B@Ru*fS3;?@Dwxi|cc{+it4={`uFC$M7P+;3%aJG>J z=BBs~KQIXiS-j_kM#DwPj_|&-i%E?azKemEf3 zm|M|it^8msXroH@$_sYhiNBMP&L}VTZGR5b>}v~8-1UFdES@94OZc4l?rP2g*{4uA zz0lM3mtrb5EJK%Exk0l)C~dRjk`g}HfHAo{8b=E0%ctb_}Ai=GfUL z*SigtfvdpzV-nWZ83u?Co7NrungQkB90PpuJNce$c@t3?{z{|It(2Indl62t7PyPRq7Dt>ktNIt`|GwEHI5(HC>gC6Og`rzP>_%^ftWDYgU( z!wnKil!}hpM&-lunUppPn)%9g9e+e{YoXHBO2hd_t)LJ4Hmi4V;Pmd{%*kg53L57Y z+~6F&960)IT!)7m_;nHsN;mGI!K(`PEeX~e;`p9)pG;=C$dl83)Eel4QV9f1ZsGul zzq6kOMw~hJ3=%=f-iFo0KlSEI{CRWf@)kz8RD9mKxb^OA0q-s6!hP*D!94&(b3<#a z)_=hPCU>fEpT_+)pjPFDr8S4Fd*KyUs%!-di;UhTu(hl2efm-~`e&XA#T1*`oBsi! Go#UqBv7Yz< delta 1363 zcmV-Z1+4n43%d)Dd4J7r<2De-?|BLWUG!8H=pKurfH&Xh21#Qt_Do5%#fBoaB$e8? zzD8fKPtqBZvMKq4lJ*e5k>>X&IULRmmGhh!TmD+Af@HstoaaARwie_!sfguPu-~sr zYpRS2PEE$Pv~C154iPkG0-=h^GFR%&kw1JOx4|kVRb#o534id}8wIXu7}Zo3>@u|2 z+Xb$*s!(;4puj3aGr@4oKAKUzG2?kg7JAdxOjEF@X47xsggwqI@OHf`rh=cDKu~F z82XOyBRE%7mw&Tj-;>j0KX19PT>7(fnR6z6%8h!NawdJMpb5W#!GK5%QVd6^lwmT# zIGaAV<}xu7TJ#x_aGMzTtob`J1Q_%Qt63s5p+%o*B^-gvkTdB~sbEK|jLSj1!*0zA zS>&b%tlzeI1A27Em~|<*Ot^DZ?b9mx4Ay(pSbdr7sDGu^TyDBCm0a^ptEo$`J$}P1 zY}O_-mTJq&gG@vO5zQeD!oRR~n%v*(&YE01Yp+qVhRKr2f)BlYW*)a&P?1!Sn~3yU zczR}Sodc(D+?s1+VScO`H}yNThkXG1AW+-n_T4F6Q`_IYwR@JS);6sjg?DF)JUb?q zfeB`Un}1X>z3Yr2{ERh21hZ^)-14 zxYrxFe$>9)`^Vs8&)m1XtJK{rF3;^|wXFX8=U+n}!ixZdqmGd-tk^beE0;WMOlssf2l(CT6u?75jDK?8W3WXZ^k^vh3L+LnY%Y%7PkCGRUo=llwPXbOq!=SwE=tpVUhG|GTjb_Fi6383dB{ujEwj-Y) zI~~qGGUH0dlX}Of#^AawIW8$um=v2>aQXo%=G~#hoC{P#(Rs=0_=0AE&}_{#l!nyo zzJC}{emPhlaFe{P#5rhD0NkT1zNrNKxx{i&XStJ>Zo$0=AQqaNnmt`}Q(T7cnS{hD z&UvBHaPP4ryzlH{Qse#YW6F!Z9>tfvSi|hW5#~2auTLXpL4P4- zmc%NepmisQxcZ4WC6f0lof`+yEQhxnty)=*SnCrvHGcVkksel0pGgEqx_G!grp3An z7$QOsPnpxQEl(@Cor8{n={4;>@pbgcTysj~5xUHh`10lsn$;9byTWjTL=vTnxCJ*jM?Vf6y&c!7 zp$2|z#DWsWb>A^&E!30KSK1orWJaazFK8J-r@lp=L5H6tJzuglZG|1Bu-Y~5E(ZRN zB@~3E9#?Um(G+=e6-Q+J9sej&<5ad`keN!h9S-K7dhGu^zaXQK8&$YZ@BV&KtMbIsnqAht@CvYhtzco1(c1*};u?-V Ved>7lXPybw9lPwS{{iN^2Fx4ftOEc5 diff --git a/docs/searchindex.js b/docs/searchindex.js index 575457d..99c8a9d 100644 --- a/docs/searchindex.js +++ b/docs/searchindex.js @@ -1 +1 @@ -Search.setIndex({"docnames": ["bib", "faq-and-tips", "getting-started", "handbook", "index"], "filenames": ["bib.rst", "faq-and-tips.rst", "getting-started.rst", "handbook.rst", "index.rst"], "titles": ["<no title>", "FAQ & Tips", "Getting Started Guide", "DTSh\u2019s Handbook", "DTSh Project Documentation"], "terms": {"zephyr": [1, 2, 3, 4], "dt": [1, 2, 3, 4], "viewer": [1, 2, 3, 4], "user interfac": [1, 2, 3, 4], "collect": [1, 3], "most": [1, 2, 3], "often": [1, 3], "reli": [1, 2, 3], "cmake": [1, 2, 3], "cach": [1, 2, 3], "content": [1, 2, 3], "retriev": [1, 2], "search": [1, 2, 4], "path": [1, 2], "build": [1, 2, 3, 4], "cmakecach": [1, 2, 3], "txt": [1, 2, 3], "when": [1, 2, 3], "can": [1, 2, 3, 4], "t": [1, 2, 3], "find": [1, 2], "thi": [1, 2, 3, 4], "file": [1, 2, 4], "zephyr_bas": [1, 2, 3], "set": [1, 2, 3], "model": [1, 2, 3], "initi": [1, 2, 3], "foobar": [1, 2], "error": [1, 3], "interrupt": [1, 2, 3, 4], "control": [1, 2, 3], "node": [1, 2, 3], "soc": [1, 2], "e000e100": [1, 2, 3], "clock": [1, 2, 3], "40000000": [1, 2, 3], "like": [1, 2, 3, 4], "fix": [1, 2, 3], "export": [1, 2, 3], "For": [1, 2, 3], "complex": 1, "us": [1, 3, 4], "case": [1, 2, 3], "refer": [1, 2, 3], "other": [1, 3], "get": [1, 3, 4], "start": [1, 3, 4], "guid": [1, 3, 4], "The": [1, 2, 4], "base": [1, 4], "unicod": [1, 3], "symbol": 1, "u": [1, 2, 3], "276d": [1, 3], "mai": [1, 2, 3], "properli": 1, "you": [1, 2, 3, 4], "shell": [1, 2, 4], "creat": [1, 3], "see": [1, 2, 3], "chang": [1, 2], "string": 1, "your": [1, 2, 3], "conveni": [1, 2, 3], "escap": [1, 3], "dollar": [1, 3], "sign": [1, 3], "wchar": [1, 3], "Or": [1, 2], "prevent": [1, 3], "confus": [1, 3], "o": [1, 3], "e": [1, 2, 3], "g": [1, 2, 3], "also": [1, 2, 3], "configur": [1, 4], "theme": [1, 2, 4], "consist": [1, 3], "repres": [1, 2, 3], "differ": [1, 3], "type": [1, 2, 3], "inform": [1, 2, 3], "compat": [1, 2, 3, 4], "ar": [1, 2, 3, 4], "alwai": [1, 2, 3], "green": [1, 3], "thing": [1, 3], "behav": [1, 3], "link": [1, 3], "alias": [1, 2, 3], "all": [1, 2, 4], "ital": [1, 3], "howev": [1, 3], "color": [1, 2, 3], "style": [1, 2, 3], "heavili": 1, "subject": [1, 3], "plai": 1, "well": [1, 2, 3], "desktop": 1, "termin": 1, "end": [1, 3], "up": [1, 3], "garish": 1, "tire": 1, "we": [1, 2, 3], "do": [1, 3], "etc": [1, 3], "directori": [1, 2, 3], "contain": [1, 2, 3], "ini": [1, 2, 3], "intend": 1, "read": 1, "my": 1, "produc": [1, 3], "disturb": 1, "mix": 1, "pref": [1, 3], "light": [1, 3], "yaml": [1, 2, 3], "monokai": [1, 3], "dark": [1, 3], "try": [1, 2, 3], "adjust": [1, 3], "involv": [1, 3], "better": [1, 3], "match": [1, 3], "an": [1, 2, 3], "css": [1, 3], "bw": [1, 3], "exampl": [1, 2], "simpl": [2, 3], "cover": 2, "": [2, 4], "basic": [2, 3], "run": [2, 3, 4], "linux": [2, 3], "maco": [2, 3], "window": [2, 3], "3": [2, 3], "8": [2, 3], "11": 2, "It": [2, 3], "some": [2, 3], "develop": 2, "environ": [2, 3], "ani": [2, 3], "On": [2, 3], "readlin": [2, 3], "api": 2, "which": [2, 3], "auto": [2, 4], "complet": [2, 4], "command": [2, 4], "histori": [2, 4], "i": [2, 3, 4], "longer": [2, 3], "distribut": 2, "standard": [2, 3], "librari": [2, 3], "consequ": 2, "user": [2, 4], "experi": [2, 3], "significantli": [2, 3], "degrad": 2, "platform": 2, "known": [2, 3], "issu": [2, 3], "without": [2, 3], "workaround": 2, "prefer": 2, "wsl": 2, "possibl": [2, 3], "onli": [2, 3], "prerequisit": 2, "part": [2, 3], "project": [2, 3], "time": [2, 3, 4], "avail": [2, 3, 4], "from": [2, 3], "pypi": [2, 4], "To": [2, 3], "pars": [2, 3], "bind": [2, 4], "edtlib": 2, "tool": 2, "although": [2, 3], "eventu": [2, 3], "becom": 2, "sourc": [2, 3, 4], "code": [2, 3, 4], "current": [2, 3], "prioriti": [2, 3], "packag": [2, 4], "updat": [2, 3], "latest": [2, 4], "version": 2, "april": 2, "2022": 2, "therefor": 2, "re": [2, 3], "snapshot": 2, "along": 2, "its": [2, 3], "own": [2, 3], "implement": 2, "work": [2, 3], "ideal": 2, "situat": 2, "textual": [2, 4], "rich": [2, 3, 4], "beauti": 2, "format": 2, "pyyaml": 2, "parser": 2, "stand": 2, "alon": [2, 3], "gnu": [2, 3], "modul": [2, 3], "gnureadlin": 2, "There": 2, "two": 2, "virtual": [2, 3], "method": 2, "belong": 2, "workspac": [2, 3], "where": [2, 3], "itself": [2, 3], "assum": [2, 3], "ve": [2, 3], "follow": [2, 3], "should": [2, 3], "look": [2, 3], "zephyrproject": 2, "venv": 2, "bootload": [2, 3], "activ": 2, "befor": [2, 3], "pip": 2, "alreadi": [2, 3], "done": [2, 3], "bin": 2, "just": [2, 3], "same": [2, 3], "prompt": 2, "usual": [2, 3], "enter": [2, 3], "dedic": 2, "littl": 2, "less": 2, "avoid": [2, 3], "anyth": [2, 3], "actual": [2, 3], "mkdir": 2, "cd": 2, "m": [2, 3], "system": 2, "setuptool": 2, "onc": [2, 3], "h": [2, 3], "b": [2, 3], "dir": 2, "c": [2, 3], "cmd": 2, "f": [2, 3], "interfac": [2, 4], "option": 2, "help": [2, 3], "show": [2, 3], "messag": 2, "exit": [2, 3], "open": [2, 3], "per": [2, 3], "load": [2, 3], "addit": [2, 3], "session": [2, 3], "execut": [2, 3], "startup": 2, "repeat": [2, 3], "interact": [2, 3], "loop": [2, 3], "after": [2, 3], "ll": [2, 3], "confirm": 2, "went": 2, "tackl": 2, "few": [2, 3], "scenario": 2, "earli": 2, "dure": 2, "phase": 2, "assembl": 2, "final": 2, "hardwar": [2, 4], "save": [2, 3], "debug": [2, 3], "purpos": 2, "gener": [2, 4], "sampl": [2, 3], "sensor": [2, 3], "bme680": [2, 3], "dboard": 2, "nrf52840dk_nrf52840": [2, 3], "0": [2, 3, 4], "2": [2, 3, 4], "A": [2, 3, 4], "how": [2, 3], "q": [2, 3], "quit": [2, 3], "press": [2, 3], "ctrl": [2, 3], "d": [2, 3], "l": 2, "name": [2, 3], "label": [2, 3], "chosen": 2, "pin": [2, 3], "pinctrl": [2, 3], "nordic": [2, 3], "nrf": [2, 3], "entropy_bt_hci": 2, "rng_hci": 2, "bt": 2, "hci": 2, "entropi": [2, 3], "sw": 2, "pwm": [2, 3], "sw_pwm": 2, "cpu": [2, 3], "led": [2, 3], "gpio": [2, 3], "pwmled": [2, 3], "button": [2, 3], "kei": 2, "connector": [2, 3], "arduino_head": 2, "arduino": [2, 3], "header": [2, 3], "r3": [2, 3], "analog": 2, "arduino_adc": 2, "uno": [2, 3], "adc": [2, 3], "abov": [2, 3], "regardless": [2, 3], "being": [2, 3], "suffici": [2, 3], "whether": [2, 3], "target": 2, "support": [2, 3], "board": 2, "custom": 2, "here": [2, 3], "need": [2, 3], "especi": 2, "In": [2, 3], "context": [2, 3], "pass": [2, 3], "default": [2, 3], "would": [2, 3, 4], "don": [2, 3], "call": 2, "root": [2, 3], "As": [2, 3], "seen": 2, "tri": [2, 3], "ha": [2, 3], "wa": [2, 3], "straight": 2, "forward": [2, 3], "wai": 2, "legit": [2, 3], "fail": [2, 3], "out": [2, 3], "were": [2, 3], "now": 2, "locat": [2, 3], "found": [2, 3], "still": [2, 3, 4], "behavior": [2, 3], "doe": [2, 3], "address": [2, 3], "though": [2, 3], "explicitli": [2, 3], "dts_root": 2, "variabl": 2, "permit": [2, 3], "enumer": [2, 3], "dir1": 2, "dir2": 2, "sub": [2, 3], "shall": 2, "necessari": [2, 3], "syntax": [2, 4], "even": [2, 3], "one": [2, 3], "valid": [2, 3], "vendor": [2, 3], "prefix": [2, 3], "script": [2, 3], "autom": [2, 3], "non": [2, 3], "seri": [2, 3], "cmd1": [2, 3], "cmd2": [2, 3], "have": [2, 3], "been": [2, 3], "list": 2, "anoth": [2, 3], "i2c0": [2, 3], "i2c": [2, 3], "40003000": [2, 3], "tweak": 2, "appear": 2, "overrid": [2, 3], "global": [2, 3], "These": [2, 3], "must": [2, 3], "config": [2, 3], "templat": [2, 3], "expect": [2, 3], "won": [2, 3], "exist": [2, 3], "manual": [2, 3], "remov": [2, 3], "again": 2, "specifi": 2, "bellow": [2, 3], "introduc": 2, "pleas": [2, 3], "handbook": [2, 4], "document": [2, 3], "navig": [2, 3, 4], "flash": [2, 3], "4001e000": [2, 3], "print": [2, 3], "about": [2, 3], "flash0": [2, 3], "partit": [2, 3], "ld": [2, 3], "nv": [2, 3], "nkr": 2, "regist": [2, 3], "mcuboot": [2, 3], "boot_partit": [2, 3], "0x0": [2, 3], "48": [2, 3], "kb": [2, 3], "c000": [2, 3], "imag": [2, 3], "slot0_partit": [2, 3], "0xc000": [2, 3], "472": [2, 3], "82000": [2, 3], "1": [2, 3, 4], "slot1_partit": [2, 3], "0x82000": [2, 3], "f8000": [2, 3], "storag": [2, 3], "storage_partit": [2, 3], "0xf8000": [2, 3], "32": [2, 3], "visual": [2, 3, 4], "tree": 2, "nc": [2, 3], "nrf52840": [2, 3], "qiaa": 2, "nrf52": [2, 3], "bu": [2, 3], "arm": [2, 3], "v7m": 2, "nvic": [2, 3], "timer": [2, 3], "e000e010": [2, 3], "armv7m": 2, "systick": 2, "ficr": [2, 3], "10000000": [2, 3], "uicr": [2, 3], "10001000": [2, 3], "memori": [2, 3], "20000000": [2, 3], "mmio": 2, "sram": [2, 3], "power": [2, 3], "gpregret1": [2, 3], "4000051c": [2, 3], "gpregret": 2, "gpregret2": [2, 3], "40000520": [2, 3], "radio": [2, 3], "40001000": [2, 3], "ieee802154": 2, "uart": [2, 3], "40002000": [2, 3], "twi": [2, 3], "76": [2, 3], "bosch": [2, 3], "descript": [2, 3], "4": [2, 3], "ghz": 2, "nkcd": 2, "famili": [2, 3], "peripher": [2, 3], "html": [2, 3, 4], "redirect": [2, 4], "output": [2, 4], "lr": [2, 3], "instal": [3, 4], "know": 3, "If": 3, "go": 3, "OR": 3, "nycd": 3, "resembl": 3, "posix": 3, "unix": 3, "keybind": 3, "zsh": 3, "bash": 3, "emac": 3, "gdb": 3, "denot": 3, "dtspec": 3, "whose": 3, "properti": 3, "branch": [3, 4], "absolut": 3, "devic": [3, 4], "defin": 3, "allow": 3, "rel": 3, "through": 3, "typic": 3, "parent": 3, "6": 3, "convolut": 3, "useless": 3, "possibli": 3, "command_lin": 3, "command_str": 3, "conform": 3, "getopt": 3, "param": 3, "invok": 3, "enabl": 3, "posit": 3, "equival": 3, "accept": 3, "short": 3, "singl": 3, "long": 3, "combin": 3, "r": 3, "requir": 3, "valu": 3, "reg": 3, "size": 3, "0x1000": 3, "space": 3, "quot": 3, "greater": 3, "than": 3, "complain": 3, "invalid": 3, "semant": 3, "across": 3, "mean": 3, "revers": 3, "recurs": 3, "mimic": 3, "either": 3, "append": 3, "insensit": 3, "extens": [3, 4], "determin": 3, "svg": [3, 4], "structur": 3, "flash_control": 3, "Then": 3, "detail": 3, "individu": 3, "nalrc": 3, "By": 3, "overwrit": 3, "unintent": 3, "oper": 3, "bashrc": 3, "precaut": 3, "relax": 3, "never": 3, "no_overwrite_strict": 3, "ye": 3, "consid": 3, "layout": 3, "homonym": 3, "column": 3, "owner": 3, "permiss": 3, "extend": 3, "approach": 3, "fmt": 3, "what": 3, "shown": 3, "impli": 3, "depend": 3, "includ": 3, "view": 3, "bit": 3, "bias": 3, "toward": 3, "who": 3, "make": 3, "sens": 3, "sound": 3, "familiar": 3, "noth": 3, "ask": 3, "ad": 3, "select": 3, "relev": 3, "basi": 3, "overridden": 3, "always_longfmt": 3, "flag": 3, "wherev": 3, "accord": 3, "simpli": 3, "charact": 3, "each": 3, "nd": 3, "armv7": 3, "nest": 3, "vector": 3, "tick": 3, "factori": 3, "unit": 3, "protocol": 3, "headlin": 3, "k": 3, "n": 3, "ordin": 3, "aka": [3, 4], "dts_ord": 3, "p": 3, "rang": 3, "statu": 3, "v": 3, "x": [3, 4], "child": 3, "depth": 3, "y": 3, "tabl": 3, "describ": 3, "order": 3, "row": 3, "led_0": 3, "led0": 3, "led_1": 3, "led1": 3, "led_2": 3, "led2": 3, "led_3": 3, "led3": 3, "miss": 3, "placehold": 3, "side": 3, "left": 3, "right": 3, "first": [3, 4], "tell": 3, "anchor": 3, "while": 3, "remain": 3, "natur": 3, "represent": 3, "nyc": 3, "spi": 3, "40004000": 3, "qspi": 3, "40029000": 3, "mx25r6435f": 3, "nor": 3, "whole": 3, "walk": 3, "children": 3, "identifi": 3, "relationship": 3, "thei": 3, "irq": 3, "number": 3, "applic": 3, "aspect": 3, "both": 3, "appli": 3, "ascend": 3, "last": 3, "descend": 3, "admit": 3, "multipl": 3, "lowest": 3, "smallest": 3, "highest": 3, "largest": 3, "improv": 3, "legibl": 3, "horizont": 3, "0xe000e010": 3, "16": 3, "byte": 3, "50000000": 3, "0x50000000": 3, "512": 3, "0x50000500": 3, "768": 3, "50000300": 3, "0x50000300": 3, "0x50000800": 3, "0x40029000": 3, "0x12000000": 3, "128": 3, "mb": 3, "4002d000": 3, "0x4002d000": 3, "4002f000": 3, "0x4002f000": 3, "crypto": 3, "5002a000": 3, "0x5002a000": 3, "0x5002b000": 3, "0x20000000": 3, "256": 3, "And": 3, "notic": 3, "compar": 3, "buse": [3, 4], "predic": 3, "regular": 3, "plain": 3, "interpret": 3, "special": 3, "particular": 3, "repetit": 3, "qualifi": 3, "wild": 3, "card": 3, "becaus": 3, "parenthesi": 3, "group": 3, "bracket": 3, "mark": 3, "begin": 3, "least": 3, "happen": 3, "grep": 3, "decim": 3, "hexadecim": 3, "exact": 3, "comparison": 3, "evalu": 3, "true": 3, "later": 3, "si": 3, "gb": 3, "4kb": 3, "truncat": 3, "letter": 3, "256k": 3, "4k": 3, "1m": 3, "ord": 3, "addr": 3, "logic": 3, "conjunct": 3, "64kb": 3, "larger": 3, "64": 3, "instead": 3, "disjunct": 3, "connect": 3, "negat": 3, "NOT": 3, "sinc": 3, "program": 3, "provid": 3, "appropri": 3, "handi": 3, "leav": 3, "dts2html": 3, "nkiycd": 3, "comment": 3, "present": 3, "page": 3, "speaker": 3, "talk": 3, "slide": 3, "advanc": 3, "next": [3, 4], "let": 3, "1st": 3, "nrc": 3, "answer": 3, "question": 3, "common": 3, "miscellan": 3, "west": [3, 4], "previou": 3, "pair": 3, "interpol": 3, "ellipsi": 3, "u2026": 3, "et_caetera": 3, "et": 3, "caetera": 3, "liter": 3, "digit": 3, "point": 3, "doubl": 3, "lead": 3, "trail": 3, "stripe": 3, "boolean": 3, "fals": 3, "off": 3, "10": 3, "0b": 3, "0o": 3, "ox": 3, "float": 3, "scientif": 3, "1e": 3, "notat": 3, "No": 3, "sizes_si": 3, "otherwis": 3, "hex_upp": 3, "upper": 3, "oxff": 3, "rather": 3, "0xff": 3, "deriv": 3, "ansi": 3, "medium": 3, "angl": 3, "ornament": 3, "u276d": 3, "slate": 3, "blue": 3, "alt": 3, "state": 3, "until": 3, "succe": 3, "red": 3, "spars": 3, "insert": 3, "newlin": 3, "between": 3, "mess": 3, "hide_dot": 3, "hide": 3, "commonli": 3, "hidden": 3, "entri": 3, "no_spac": 3, "forbid": 3, "no_overwrit": 3, "except": 3, "redir2": 3, "maxwidth": 3, "maximum": 3, "width": 3, "vt": 3, "scroll": 3, "crop": 3, "wrap": 3, "unnecessarili": 3, "limit": 3, "editor": 3, "web": 3, "brower": 3, "handl": 3, "wider": 3, "consol": 3, "255": 3, "background": 3, "darker": 3, "lighter": 3, "night": 3, "darkest": 3, "contrast": 3, "font_famili": 3, "font": 3, "courier": 3, "new": [3, 4], "coma": 3, "separ": 3, "pro": 3, "monospac": 3, "automat": 3, "fallback": 3, "font_ratio": 3, "ratio": 3, "height": 3, "vari": 3, "render": 3, "fine": 3, "5": 3, "within": 3, "everywher": 3, "safe": 3, "correct": 3, "pygment": 3, "dracula": 3, "materi": 3, "sa": 3, "place_hold": 3, "place": 3, "holder": 3, "none": 3, "blank": 3, "nlc": 3, "actionable_typ": 3, "hyperlink": 3, "dash": 3, "multi": 3, "cell": 3, "focus": 3, "cb_anchor": 3, "unset": 3, "disabl": 3, "arrow_right_hook": 3, "around": 3, "glyph": 3, "substitut": 3, "arrow": 3, "2192": 3, "suit": 3, "person": 3, "tast": 3, "synopsi": 3, "destin": 3, "quickli": 3, "pwm_led_0": 3, "glob": 3, "40008000": 3, "40009000": 3, "4000a000": 3, "4001a000": 3, "4001b000": 3, "uart0_default": 3, "uart0_sleep": 3, "uart1_default": 3, "empti": 3, "filter": 3, "quick": 3, "rl": 3, "nr": 3, "0xe000e100": 3, "distinguish": 3, "lowercas": 3, "prove": 3, "difficult": 3, "pref_hex_upp": 3, "i2c1": 3, "nkyc": 3, "0x4001e000": 3, "arduino_i2c": 3, "bme680_i2c": 3, "ignor": 3, "pk": 3, "result": 3, "nk": 3, "count": 3, "dma": 3, "kd": 3, "uart0": 3, "easydma": 3, "uart1": 3, "arduino_seri": 3, "spi3": 3, "arduino_spi": 3, "spim": 3, "master": 3, "expr": 3, "associ": 3, "far": 3, "backward": 3, "top": 3, "level": 3, "nxd": 3, "group1": 3, "group2": 3, "gpiot": 3, "40006000": 3, "nrf5": 3, "input": 3, "button_0": 3, "button_1": 3, "expos": 3, "push": 3, "butt": 3, "nld": 3, "switch": 3, "mention": 3, "famou": 3, "__device_dts_ord_": 3, "sometim": 3, "beginn": 3, "driver": 3, "14": 3, "__device_dts_ord_124": 3, "undeclar": 3, "function": 3, "did": 3, "__device_dts_ord_14": 3, "89": 3, "device_name_get": 3, "dev_id": 3, "_concat": 3, "__device_": 3, "further": 3, "rememb": 3, "neg": 3, "124": 3, "definit": 3, "savvi": 3, "skim": 3, "devicetree_gener": 3, "put": 3, "togeth": 3, "scatter": 3, "among": 3, "more": 3, "ten": 3, "thousand": 3, "macro": 3, "dt_n_s_soc_s_i2c_40003000_ord": 3, "dt_n_s_soc_s_i2c_40003000_status_dis": 3, "dt_n_s_soc_s_i2c_40003000_s_bme680_76_ord": 3, "125": 3, "dt_n_s_soc_s_i2c_40003000_s_bme680_76_requires_ord": 3, "clear": 3, "reach": 3, "conclus": 3, "blink": 3, "ey": 3, "dep": 3, "sai": 3, "pstd": 3, "artifici": 3, "silver": 3, "bullet": 3, "But": 3, "take": 3, "second": 3, "might": 3, "yield": 3, "hint": 3, "ref": 3, "int": 3, "okai": 3, "unless": 3, "term": 3, "realli": 3, "seem": 3, "usbd": 3, "40027000": 3, "usb": 3, "bme": 3, "ncy": 3, "nid": 3, "larg": 3, "resourc": 3, "512k": 3, "concaten": 3, "xpath": 3, "referenc": 3, "prop": 3, "w": 3, "wakeup": 3, "write": 3, "block": 3, "0x04": 3, "hijack": 3, "dby": 3, "specif": 3, "info": 3, "quad": 3, "whenev": 3, "pm": 3, "runtim": 3, "0x00": 3, "0x100000": 3, "eras": 3, "lb": 3, "neither": 3, "phandl": 3, "arrai": 3, "human": 3, "readabl": 3, "bl": 3, "deprec": 3, "enum": 3, "s2b1v1": 3, "s1b6": 3, "s2b7": 3, "s2b1v4": 3, "s2b1v5": 3, "s2b1v6": 3, "const": 3, "Not": 3, "qspi_default": 3, "qspi_sleep": 3, "sleep": 3, "al": 3, "partial": 3, "pc": 3, "rightward": 3, "arrow_right": 3, "random": 3, "4000d000": 3, "rng": 3, "ram": 3, "nrd": 3, "chip": 3, "builtin": 3, "bbc_microbit": 3, "bbc": 3, "micro": 3, "mcu": 3, "arch": 3, "toolchain": 3, "gnuarmemb": 3, "xtool": 3, "test": 3, "ignore_tag": 3, "net": 3, "ble": 3, "rto": 3, "v3": 3, "7": 3, "275": 3, "gccb616c9673": 3, "nrf52840dk": 3, "moin": 3, "machin": 3, "hwmv2": 3, "section": 3, "ol": 3, "releas": [3, 4], "extern": 3, "bme68x": 3, "iaq": 3, "local": 3, "field": 3, "relat": 3, "hoover": 3, "reveal": 3, "click": 3, "il": 3, "board_dir": 3, "dk": 3, "1024": 3, "arduino_gpio": 3, "counter": 3, "i2": 3, "usb_devic": 3, "watchdog": 3, "netif": 3, "openthread": 3, "brows": 3, "integr": 3, "keystrok": 3, "discov": 3, "memor": 3, "remind": 3, "turn": 3, "return": 3, "rational": 3, "choos": 3, "exot": 3, "note": [3, 4], "close": 3, "signal": 3, "eof": 3, "send": 3, "z": 3, "achiev": 3, "trigger": 3, "tab": 3, "twice": 3, "word": 3, "candid": 3, "contextu": 3, "propos": [3, 4], "undefin": 3, "subsequ": 3, "anywher": 3, "concat": 3, "cursor": 3, "i2c0_default": 3, "i2c0_sleep": 3, "i2c1_default": 3, "i2c1_sleep": 3, "indic": 3, "wake": 3, "manag": 3, "src": 3, "cmakelist": 3, "readm": 3, "rst": 3, "prj": 3, "conf": 3, "doc": 3, "home": 3, "myself": 3, "convent": 3, "intuit": 3, "down": 3, "keyboard": 3, "shortcut": 3, "persist": 3, "honor": 3, "histcontrol": 3, "histignor": 3, "facil": 3, "data": 3, "almost": 3, "could": 3, "pain": 3, "understand": 3, "offer": 3, "featur": 3, "besid": 3, "preserv": 3, "displai": 3, "sic": 3, "doesn": 3, "movement": 3, "unhappi": 3, "compil": 3, "vertic": 3, "someth": 3, "ncryd": 3, "tui": 3, "compon": 3, "browser": 3, "modern": 3, "them": 3, "tag": 3, "underlin": 3, "somewhat": 3, "imit": 3, "tooltip": 3, "hold": 3, "easili": 3, "feel": 3, "too": 3, "invas": 3, "inappropri": 3, "encod": 3, "audio": 3, "mime": 3, "bindabl": 3, "modifi": 3, "uppercas": 3, "meta": 3, "bound": 3, "esc": 3, "app": 3, "iterm2": 3, "remap": 3, "those": 3, "below": 3, "ones": 3, "back": 3, "screen": 3, "redraw": 3, "drag": 3, "over": 3, "transpos": 3, "char": 3, "past": 3, "delet": 3, "kill": 3, "cut": 3, "behind": 3, "yank": 3, "ring": 3, "buffer": 3, "rotat": 3, "_": 3, "undo": 3, "come": 3, "init": 3, "manipul": 3, "fetch": 3, "increment": 3, "replac": 3, "piec": 3, "recent": 3, "abort": 3, "think": 3, "capabl": 3, "sequenc": 3, "plu": 3, "osc": 3, "todai": 3, "conhost": 3, "box": 3, "draw": 3, "tofu": 3, "unpleas": 3, "palett": 3, "bold": 3, "bright": 3, "profil": 3, "mostli": 3, "pleasant": 3, "recommend": 3, "full": 3, "wide": 3, "maxim": 3, "2500": 3, "257f": 3, "form": 3, "fg": 3, "bg": 3, "foreground": 3, "dark_green": 3, "005f00": 3, "caus": 3, "headach": 3, "concern": 3, "devicetre": 4, "embedded develop": 4, "iot": 4, "line": 4, "flexibl": 4, "criteria": 4, "text": 4, "illustr": 4, "arbitrari": 4, "welcom": 4, "mirror": 4, "serv": 4, "upstream": 4, "rfc": 4, "proof": 4, "concept": 4, "prototyp": 4, "main": 4, "repositori": 4, "usag": 4, "step": 4, "built": 4, "faq": 4, "tip": 4}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"faq": 1, "tip": 1, "run": 1, "dtsh": [1, 2, 3, 4], "fail": 1, "open": 1, "devicetre": [1, 2, 3], "lack": 1, "bind": [1, 3], "user": [1, 3], "interfac": [1, 3], "i": 1, "d": 1, "prefer": [1, 3], "tradit": 1, "prompt": [1, 3], "someth": 1, "littl": 1, "more": 1, "sober": 1, "command": [1, 3], "output": [1, 3], "redirect": [1, 3], "mismatch": 1, "html": 1, "background": 1, "default": 1, "render": 1, "get": 2, "start": 2, "guid": 2, "instal": 2, "requir": 2, "python": 2, "extern": 2, "depend": 2, "alongsid": 2, "west": 2, "standalon": 2, "usag": 2, "typic": 2, "us": 2, "other": 2, "batch": [2, 3], "mode": [2, 3], "configur": [2, 3], "first": 2, "step": 2, "": 3, "handbook": 3, "The": 3, "shell": 3, "hierarch": 3, "file": 3, "system": 3, "metaphor": 3, "line": 3, "string": 3, "format": 3, "specifi": 3, "list": 3, "tree": 3, "sort": 3, "kei": 3, "direct": 3, "search": 3, "text": 3, "pattern": 3, "base": 3, "criteria": 3, "integ": 3, "express": 3, "criterion": 3, "chain": 3, "gener": 3, "access": 3, "syntax": 3, "highlight": 3, "altern": 3, "symbol": 3, "built": 3, "cd": 3, "pwd": 3, "l": 3, "option": 3, "exampl": 3, "find": 3, "cat": 3, "alia": 3, "chosen": 3, "board": 3, "unam": 3, "kernel": 3, "soc": 3, "all": 3, "textual": 3, "auto": 3, "complet": 3, "argument": 3, "paramet": 3, "path": 3, "histori": 3, "pager": 3, "less": 3, "action": 3, "move": 3, "edit": 3, "chang": 3, "appear": 3, "termin": 3, "theme": 3, "project": 4, "document": 4, "statu": 4, "content": 4}, "envversion": {"sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 60}, "alltitles": {"FAQ & Tips": [[1, "faq-tips"]], "Running DTSh": [[1, "running-dtsh"]], "Failed to open devicetree, lacks bindings": [[1, "failed-to-open-devicetree-lacks-bindings"]], "User interface": [[1, "user-interface"]], "I\u2019d prefer the traditional $ prompt": [[1, "i-d-prefer-the-traditional-prompt"]], "I\u2019d prefer something a little more sober": [[1, "i-d-prefer-something-a-little-more-sober"]], "Command output redirection": [[1, "command-output-redirection"]], "Mismatched HTML backgrounds": [[1, "mismatched-html-backgrounds"]], "Default HTML rendering": [[1, "id3"]], "Getting Started Guide": [[2, "getting-started-guide"]], "Install DTSh": [[2, "install-dtsh"]], "Requirements": [[2, "requirements"]], "python-devicetree": [[2, "python-devicetree"]], "External Dependencies": [[2, "external-dependencies"], [2, "id1"]], "Installation": [[2, "installation"]], "Install Alongside West": [[2, "install-alongside-west"]], "Standalone Installation": [[2, "standalone-installation"]], "Usage": [[2, "usage"]], "Typical Use": [[2, "typical-use"]], "Other Uses": [[2, "other-uses"]], "Batch Mode": [[2, "batch-mode"], [3, "batch-mode"]], "Configuration": [[2, "configuration"]], "First Steps": [[2, "first-steps"]], "DTSh\u2019s Handbook": [[3, "dtsh-s-handbook"]], "The Shell": [[3, "the-shell"]], "Hierarchical File System Metaphor": [[3, "hierarchical-file-system-metaphor"]], "The Command Line": [[3, "the-command-line"]], "Command Strings": [[3, "command-strings"]], "Output Redirection": [[3, "output-redirection"], [3, "dtsh-prefs-redir2fs"]], "Format Commands Output": [[3, "format-commands-output"]], "Format Strings": [[3, "format-strings"]], "Format string specifiers": [[3, "id21"]], "Formatted Lists": [[3, "formatted-lists"], [3, "dtsh-prefs-lists"]], "Formatted Trees": [[3, "formatted-trees"], [3, "dtsh-prefs-trees"]], "Sort Commands Output": [[3, "sort-commands-output"]], "Sort Keys": [[3, "sort-keys"]], "Sort keys": [[3, "id22"]], "Sort Directions": [[3, "sort-directions"]], "Search the Devicetree": [[3, "search-the-devicetree"]], "Text Patterns": [[3, "text-patterns"]], "Text-based criteria": [[3, "id23"]], "Integer Expressions": [[3, "integer-expressions"]], "Integer-based criteria": [[3, "id24"]], "Criterion Chains": [[3, "criterion-chains"]], "Batch Commands": [[3, "batch-commands"]], "Batch Files": [[3, "batch-files"]], "User Preferences": [[3, "user-preferences"]], "Configuration Format": [[3, "configuration-format"]], "General Preferences": [[3, "general-preferences"]], "The Prompt": [[3, "the-prompt"], [3, "dtsh-prompt"]], "File System Access": [[3, "file-system-access"]], "Syntax Highlighting": [[3, "syntax-highlighting"]], "Alternative Symbols": [[3, "alternative-symbols"]], "Built-in Commands": [[3, "built-in-commands"]], "cd": [[3, "cd"]], "pwd": [[3, "pwd"]], "ls": [[3, "ls"]], "Options": [[3, "options"], [3, "dtsh-tree-options"], [3, "dtsh-find-options"], [3, "dtsh-cat-options"], [3, "dtsh-alias-options"], [3, "dtsh-chosen-options"], [3, "dtsh-board-options"], [3, "dtsh-uname-options"]], "Examples": [[3, "examples"], [3, "dtsh-tree-examples"], [3, "dtsh-find-examples"], [3, "dtsh-cat-examples"], [3, "dtsh-alias-examples"], [3, "dtsh-chosen-examples"], [3, "dtsh-board-examples"], [3, "dtsh-uname-examples"]], "tree": [[3, "tree"]], "find": [[3, "find"]], "cat": [[3, "cat"]], "alias": [[3, "alias"]], "chosen": [[3, "chosen"]], "board": [[3, "board"]], "uname": [[3, "uname"]], "Kernel": [[3, "id29"]], "Board": [[3, "id30"]], "SoC": [[3, "id31"]], "All": [[3, "id32"]], "Textual User Interface": [[3, "textual-user-interface"]], "Auto-completion": [[3, "auto-completion"]], "Auto-complete Commands": [[3, "auto-complete-commands"]], "Auto-complete Options": [[3, "auto-complete-options"]], "Auto-complete Arguments": [[3, "auto-complete-arguments"]], "Auto-complete Parameters": [[3, "auto-complete-parameters"]], "Auto-complete Redirection Paths": [[3, "auto-complete-redirection-paths"]], "Command History": [[3, "command-history"], [3, "id36"]], "The Pager": [[3, "the-pager"]], "Pager key bindings (less)": [[3, "id33"]], "Actionable Text": [[3, "actionable-text"]], "Key Bindings": [[3, "key-bindings"]], "Moving and Editing": [[3, "moving-and-editing"]], "Moving": [[3, "id34"]], "Changing text": [[3, "id35"]], "Command Line History": [[3, "command-line-history"]], "Appearance": [[3, "appearance"]], "The Terminal": [[3, "the-terminal"]], "User Themes": [[3, "user-themes"]], "DTSh Project Documentation": [[4, "dtsh-project-documentation"]], "Status": [[4, "status"]], "Contents:": [[4, null]]}, "indexentries": {}}) \ No newline at end of file +Search.setIndex({"docnames": ["bib", "faq-and-tips", "getting-started", "handbook", "index"], "filenames": ["bib.rst", "faq-and-tips.rst", "getting-started.rst", "handbook.rst", "index.rst"], "titles": ["<no title>", "FAQ & Tips", "Getting Started Guide", "DTSh\u2019s Handbook", "DTSh Project Documentation"], "terms": {"zephyr": [1, 2, 3, 4], "dt": [1, 2, 3, 4], "viewer": [1, 2, 3, 4], "user interfac": [1, 2, 3, 4], "collect": [1, 3], "most": [1, 2, 3], "often": [1, 3], "reli": [1, 2, 3], "cmake": [1, 2, 3], "cach": [1, 2, 3], "content": [1, 2, 3], "retriev": [1, 2, 3], "search": [1, 2, 4], "path": [1, 2], "build": [1, 2, 3, 4], "cmakecach": [1, 2, 3], "txt": [1, 2, 3], "when": [1, 2, 3], "can": [1, 2, 3, 4], "t": [1, 2, 3], "find": [1, 2], "thi": [1, 2, 3, 4], "file": [1, 2, 4], "zephyr_bas": [1, 2, 3], "set": [1, 2, 3], "model": [1, 2, 3], "initi": [1, 2, 3], "foobar": [1, 2, 3], "error": [1, 3], "interrupt": [1, 2, 3, 4], "control": [1, 2, 3], "node": [1, 2, 3], "soc": [1, 2], "e000e100": [1, 2, 3], "clock": [1, 2, 3], "40000000": [1, 2, 3], "like": [1, 2, 3, 4], "fix": [1, 2, 3], "export": [1, 2, 3], "For": [1, 2, 3], "complex": 1, "us": [1, 4], "case": [1, 2, 3], "refer": [1, 2, 3], "other": 1, "get": [1, 3, 4], "start": [1, 3, 4], "guid": [1, 4], "The": [1, 2, 4], "base": [1, 4], "unicod": [1, 3], "symbol": 1, "u": [1, 2, 3], "276d": [1, 3], "mai": [1, 2, 3], "properli": 1, "you": [1, 2, 3, 4], "shell": [1, 2, 4], "creat": [1, 3], "see": [1, 2, 3], "chang": [1, 2], "string": 1, "your": [1, 2, 3], "conveni": [1, 2, 3], "escap": [1, 3], "dollar": [1, 3], "sign": [1, 3], "wchar": [1, 3], "Or": [1, 2], "prevent": [1, 3], "confus": [1, 3], "o": [1, 3], "e": [1, 2, 3], "g": [1, 2, 3], "also": [1, 2, 3], "configur": [1, 4], "theme": [1, 2, 4], "consist": [1, 3], "repres": [1, 2, 3], "differ": [1, 3], "type": [1, 2, 3], "inform": [1, 2, 3], "compat": [1, 2, 3, 4], "ar": [1, 2, 3, 4], "alwai": [1, 2, 3], "green": [1, 3], "thing": [1, 3], "behav": [1, 3], "link": [1, 3], "alias": [1, 2, 3], "all": [1, 2, 4], "ital": [1, 3], "howev": [1, 3], "color": [1, 2, 3], "style": [1, 2, 3], "heavili": 1, "subject": [1, 3], "plai": 1, "well": [1, 2, 3], "desktop": 1, "termin": 1, "end": [1, 3], "up": [1, 3], "garish": 1, "tire": 1, "we": [1, 2, 3], "do": [1, 3], "etc": [1, 3], "directori": [1, 2, 3], "contain": [1, 2, 3], "ini": [1, 2, 3], "intend": 1, "read": 1, "my": 1, "produc": [1, 3], "disturb": 1, "mix": 1, "pref": [1, 3], "light": [1, 3], "yaml": [1, 2, 3], "monokai": [1, 3], "dark": [1, 3], "try": [1, 2, 3], "adjust": [1, 3], "involv": [1, 3], "better": [1, 3], "match": [1, 3], "an": [1, 2, 3], "css": [1, 3], "bw": [1, 3], "exampl": [1, 2], "simpl": [2, 3], "cover": [2, 3], "": [2, 4], "basic": [2, 3], "run": [2, 3, 4], "linux": [2, 3], "maco": [2, 3], "window": [2, 3], "3": [2, 3], "8": [2, 3], "11": 2, "It": [2, 3], "some": [2, 3], "develop": 2, "environ": [2, 3], "ani": [2, 3], "On": [2, 3], "readlin": [2, 3], "api": 2, "which": [2, 3], "auto": [2, 4], "complet": [2, 4], "command": [2, 4], "histori": [2, 4], "i": [2, 3, 4], "longer": [2, 3], "distribut": 2, "standard": [2, 3], "librari": [2, 3], "consequ": 2, "user": [2, 4], "experi": [2, 3], "significantli": [2, 3], "degrad": 2, "platform": [2, 3], "known": [2, 3], "issu": [2, 3], "without": [2, 3], "workaround": 2, "prefer": 2, "wsl": 2, "possibl": [2, 3], "onli": [2, 3], "prerequisit": 2, "part": [2, 3], "project": [2, 3], "time": [2, 3, 4], "avail": [2, 3, 4], "from": [2, 3], "pypi": [2, 4], "To": [2, 3], "pars": [2, 3], "bind": [2, 4], "edtlib": 2, "tool": 2, "although": [2, 3], "eventu": [2, 3], "becom": 2, "sourc": [2, 3, 4], "code": [2, 3, 4], "current": [2, 3], "prioriti": [2, 3], "packag": [2, 4], "updat": [2, 3], "latest": [2, 4], "version": 2, "april": 2, "2022": 2, "therefor": 2, "re": [2, 3], "snapshot": 2, "along": 2, "its": [2, 3], "own": [2, 3], "implement": 2, "work": [2, 3], "ideal": 2, "situat": [2, 3], "textual": [2, 4], "rich": [2, 3, 4], "beauti": 2, "format": 2, "pyyaml": 2, "parser": 2, "stand": 2, "alon": [2, 3], "gnu": [2, 3], "modul": [2, 3], "gnureadlin": 2, "There": 2, "two": 2, "virtual": [2, 3], "method": [2, 3], "belong": 2, "workspac": [2, 3], "where": [2, 3], "itself": [2, 3], "assum": [2, 3], "ve": [2, 3], "follow": [2, 3], "should": [2, 3], "look": [2, 3], "zephyrproject": [2, 3], "venv": 2, "bootload": [2, 3], "activ": 2, "befor": [2, 3], "pip": 2, "alreadi": [2, 3], "done": [2, 3], "bin": 2, "just": [2, 3], "same": [2, 3], "prompt": 2, "usual": [2, 3], "enter": [2, 3], "dedic": 2, "littl": 2, "less": 2, "avoid": [2, 3], "anyth": [2, 3], "actual": [2, 3], "mkdir": 2, "cd": 2, "m": [2, 3], "system": 2, "setuptool": 2, "onc": [2, 3], "h": [2, 3], "b": [2, 3], "dir": [2, 3], "c": [2, 3], "cmd": [2, 3], "f": [2, 3], "interfac": [2, 4], "option": 2, "help": [2, 3], "show": [2, 3], "messag": [2, 3], "exit": [2, 3], "open": [2, 3], "per": [2, 3], "load": [2, 3], "addit": [2, 3], "session": [2, 3], "execut": [2, 3], "startup": [2, 3], "repeat": [2, 3], "interact": [2, 3], "loop": [2, 3], "after": [2, 3], "ll": [2, 3], "confirm": 2, "went": 2, "tackl": 2, "few": [2, 3], "scenario": 2, "earli": [2, 3], "dure": [2, 3], "phase": [2, 3], "assembl": [2, 3], "final": [2, 3], "hardwar": [2, 3, 4], "save": [2, 3], "debug": [2, 3], "purpos": [2, 3], "gener": [2, 4], "sampl": [2, 3], "sensor": [2, 3], "bme680": [2, 3], "dboard": [2, 3], "nrf52840dk_nrf52840": [2, 3], "0": [2, 3, 4], "2": [2, 3, 4], "A": [2, 3, 4], "how": [2, 3], "q": [2, 3], "quit": [2, 3], "press": [2, 3], "ctrl": [2, 3], "d": [2, 3], "l": 2, "name": [2, 3], "label": [2, 3], "chosen": 2, "pin": [2, 3], "pinctrl": [2, 3], "nordic": [2, 3], "nrf": [2, 3], "entropy_bt_hci": [2, 3], "rng_hci": [2, 3], "bt": [2, 3], "hci": [2, 3], "entropi": [2, 3], "sw": [2, 3], "pwm": [2, 3], "sw_pwm": [2, 3], "cpu": [2, 3], "led": [2, 3], "gpio": [2, 3], "pwmled": [2, 3], "button": [2, 3], "kei": 2, "connector": [2, 3], "arduino_head": [2, 3], "arduino": [2, 3], "header": [2, 3], "r3": [2, 3], "analog": [2, 3], "arduino_adc": [2, 3], "uno": [2, 3], "adc": [2, 3], "abov": [2, 3], "regardless": [2, 3], "being": [2, 3], "suffici": [2, 3], "whether": [2, 3], "target": [2, 3], "support": [2, 3], "board": 2, "custom": [2, 3], "here": [2, 3], "need": [2, 3], "especi": [2, 3], "In": [2, 3], "context": [2, 3], "pass": [2, 3], "default": [2, 3], "would": [2, 3, 4], "don": [2, 3], "call": [2, 3], "root": [2, 3], "As": [2, 3], "seen": [2, 3], "tri": [2, 3], "ha": [2, 3], "wa": [2, 3], "straight": [2, 3], "forward": [2, 3], "wai": [2, 3], "legit": [2, 3], "fail": [2, 3], "out": [2, 3], "were": [2, 3], "now": [2, 3], "locat": [2, 3], "found": [2, 3], "still": [2, 3, 4], "behavior": [2, 3], "doe": [2, 3], "address": [2, 3], "though": [2, 3], "explicitli": [2, 3], "dts_root": [2, 3], "variabl": [2, 3], "permit": [2, 3], "enumer": [2, 3], "dir1": [2, 3], "dir2": [2, 3], "sub": [2, 3], "shall": [2, 3], "necessari": [2, 3], "syntax": [2, 4], "even": [2, 3], "one": [2, 3], "valid": [2, 3], "vendor": [2, 3], "prefix": [2, 3], "script": [2, 3], "autom": [2, 3], "non": [2, 3], "seri": [2, 3], "cmd1": [2, 3], "cmd2": [2, 3], "have": [2, 3], "been": [2, 3], "list": 2, "anoth": [2, 3], "i2c0": [2, 3], "i2c": [2, 3], "40003000": [2, 3], "tweak": [2, 3], "appear": 2, "overrid": [2, 3], "global": [2, 3], "These": [2, 3], "must": [2, 3], "config": [2, 3], "templat": [2, 3], "expect": [2, 3], "won": [2, 3], "exist": [2, 3], "manual": [2, 3], "remov": [2, 3], "again": [2, 3], "specifi": 2, "bellow": [2, 3], "introduc": 2, "pleas": [2, 3], "handbook": [2, 4], "document": [2, 3], "navig": [2, 3, 4], "flash": [2, 3], "4001e000": [2, 3], "print": [2, 3], "about": [2, 3], "flash0": [2, 3], "partit": [2, 3], "ld": [2, 3], "nv": [2, 3], "nkr": 2, "regist": [2, 3], "mcuboot": [2, 3], "boot_partit": [2, 3], "0x0": [2, 3], "48": [2, 3], "kb": [2, 3], "c000": [2, 3], "imag": [2, 3], "slot0_partit": [2, 3], "0xc000": [2, 3], "472": [2, 3], "82000": [2, 3], "1": [2, 3, 4], "slot1_partit": [2, 3], "0x82000": [2, 3], "f8000": [2, 3], "storag": [2, 3], "storage_partit": [2, 3], "0xf8000": [2, 3], "32": [2, 3], "visual": [2, 3, 4], "tree": 2, "nc": [2, 3], "nrf52840": [2, 3], "qiaa": 2, "nrf52": [2, 3], "bu": [2, 3], "arm": [2, 3], "v7m": 2, "nvic": [2, 3], "timer": [2, 3], "e000e010": [2, 3], "armv7m": 2, "systick": 2, "ficr": [2, 3], "10000000": [2, 3], "uicr": [2, 3], "10001000": [2, 3], "memori": [2, 3], "20000000": [2, 3], "mmio": 2, "sram": [2, 3], "power": [2, 3], "gpregret1": [2, 3], "4000051c": [2, 3], "gpregret": 2, "gpregret2": [2, 3], "40000520": [2, 3], "radio": [2, 3], "40001000": [2, 3], "ieee802154": 2, "uart": [2, 3], "40002000": [2, 3], "twi": [2, 3], "76": [2, 3], "bosch": [2, 3], "descript": [2, 3], "4": [2, 3], "ghz": 2, "nkcd": 2, "famili": [2, 3], "peripher": [2, 3], "html": [2, 3, 4], "redirect": [2, 4], "output": [2, 4], "lr": [2, 3], "instal": [3, 4], "know": 3, "If": 3, "go": 3, "OR": 3, "nycd": 3, "resembl": 3, "posix": 3, "unix": 3, "keybind": 3, "zsh": 3, "bash": 3, "emac": 3, "gdb": 3, "denot": 3, "dtspec": 3, "whose": 3, "properti": 3, "branch": [3, 4], "absolut": 3, "devic": [3, 4], "defin": 3, "allow": 3, "rel": 3, "through": 3, "typic": [], "parent": 3, "6": 3, "convolut": 3, "useless": 3, "possibli": 3, "command_lin": 3, "command_str": 3, "conform": 3, "getopt": 3, "param": 3, "invok": 3, "enabl": 3, "posit": 3, "equival": 3, "accept": 3, "short": 3, "singl": 3, "long": 3, "combin": 3, "r": 3, "requir": 3, "valu": 3, "reg": 3, "size": 3, "0x1000": 3, "space": 3, "quot": 3, "greater": 3, "than": 3, "complain": 3, "invalid": 3, "semant": 3, "across": 3, "mean": 3, "revers": 3, "recurs": 3, "mimic": 3, "either": 3, "append": 3, "insensit": 3, "extens": [3, 4], "determin": 3, "svg": [3, 4], "structur": 3, "flash_control": 3, "Then": 3, "detail": 3, "individu": 3, "nalrc": 3, "By": 3, "overwrit": 3, "unintent": 3, "oper": 3, "bashrc": 3, "precaut": 3, "relax": 3, "never": 3, "no_overwrite_strict": 3, "ye": 3, "consid": 3, "layout": 3, "homonym": 3, "column": 3, "owner": 3, "permiss": 3, "extend": 3, "approach": 3, "fmt": 3, "what": 3, "shown": 3, "impli": 3, "depend": 3, "includ": 3, "view": 3, "bit": 3, "bias": 3, "toward": 3, "who": 3, "make": 3, "sens": 3, "sound": 3, "familiar": 3, "noth": 3, "ask": 3, "ad": 3, "select": 3, "relev": 3, "basi": 3, "overridden": 3, "always_longfmt": 3, "flag": 3, "wherev": 3, "accord": 3, "simpli": 3, "charact": 3, "each": 3, "nd": 3, "armv7": 3, "nest": 3, "vector": 3, "tick": 3, "factori": 3, "unit": 3, "protocol": 3, "headlin": 3, "k": 3, "n": 3, "ordin": 3, "aka": [3, 4], "dts_ord": 3, "p": 3, "rang": 3, "statu": 3, "v": 3, "x": [3, 4], "child": 3, "depth": 3, "y": 3, "tabl": 3, "describ": 3, "order": 3, "row": 3, "led_0": 3, "led0": 3, "led_1": 3, "led1": 3, "led_2": 3, "led2": 3, "led_3": 3, "led3": 3, "miss": 3, "placehold": 3, "side": 3, "left": 3, "right": 3, "first": [3, 4], "tell": 3, "anchor": 3, "while": 3, "remain": 3, "natur": 3, "represent": 3, "nyc": 3, "spi": 3, "40004000": 3, "qspi": 3, "40029000": 3, "mx25r6435f": 3, "nor": 3, "whole": 3, "walk": 3, "children": 3, "identifi": 3, "relationship": 3, "thei": 3, "irq": 3, "number": 3, "applic": 3, "aspect": 3, "both": 3, "appli": 3, "ascend": 3, "last": 3, "descend": 3, "admit": 3, "multipl": 3, "lowest": 3, "smallest": 3, "highest": 3, "largest": 3, "improv": 3, "legibl": 3, "horizont": 3, "0xe000e010": 3, "16": 3, "byte": 3, "50000000": 3, "0x50000000": 3, "512": 3, "0x50000500": 3, "768": 3, "50000300": 3, "0x50000300": 3, "0x50000800": 3, "0x40029000": 3, "0x12000000": 3, "128": 3, "mb": 3, "4002d000": 3, "0x4002d000": 3, "4002f000": 3, "0x4002f000": 3, "crypto": 3, "5002a000": 3, "0x5002a000": 3, "0x5002b000": 3, "0x20000000": 3, "256": 3, "And": 3, "notic": 3, "compar": 3, "buse": [3, 4], "predic": 3, "regular": 3, "plain": 3, "interpret": 3, "special": 3, "particular": 3, "repetit": 3, "qualifi": 3, "wild": 3, "card": 3, "becaus": 3, "parenthesi": 3, "group": 3, "bracket": 3, "mark": 3, "begin": 3, "least": 3, "happen": 3, "grep": 3, "decim": 3, "hexadecim": 3, "exact": 3, "comparison": 3, "evalu": 3, "true": 3, "later": 3, "si": 3, "gb": 3, "4kb": 3, "truncat": 3, "letter": 3, "256k": 3, "4k": 3, "1m": 3, "ord": 3, "addr": 3, "logic": 3, "conjunct": 3, "64kb": 3, "larger": 3, "64": 3, "instead": 3, "disjunct": 3, "connect": 3, "negat": 3, "NOT": 3, "sinc": 3, "program": 3, "provid": 3, "appropri": 3, "handi": 3, "leav": 3, "dts2html": 3, "nkiycd": 3, "comment": 3, "present": 3, "page": 3, "speaker": 3, "talk": 3, "slide": 3, "advanc": 3, "next": [3, 4], "let": 3, "1st": 3, "nrc": 3, "answer": 3, "question": 3, "common": 3, "miscellan": 3, "west": [3, 4], "previou": 3, "pair": 3, "interpol": 3, "ellipsi": 3, "u2026": 3, "et_caetera": 3, "et": 3, "caetera": 3, "liter": 3, "digit": 3, "point": 3, "doubl": 3, "lead": 3, "trail": 3, "stripe": 3, "boolean": 3, "fals": 3, "off": 3, "10": 3, "0b": 3, "0o": 3, "ox": 3, "float": 3, "scientif": 3, "1e": 3, "notat": 3, "No": 3, "sizes_si": 3, "otherwis": 3, "hex_upp": 3, "upper": 3, "oxff": 3, "rather": 3, "0xff": 3, "deriv": 3, "ansi": 3, "medium": 3, "angl": 3, "ornament": 3, "u276d": 3, "slate": 3, "blue": 3, "alt": 3, "state": 3, "until": 3, "succe": 3, "red": 3, "spars": 3, "insert": 3, "newlin": 3, "between": 3, "mess": 3, "hide_dot": 3, "hide": 3, "commonli": 3, "hidden": 3, "entri": 3, "no_spac": 3, "forbid": 3, "no_overwrit": 3, "except": 3, "redir2": 3, "maxwidth": 3, "maximum": 3, "width": 3, "vt": 3, "scroll": 3, "crop": 3, "wrap": 3, "unnecessarili": 3, "limit": 3, "editor": 3, "web": 3, "brower": 3, "handl": 3, "wider": 3, "consol": 3, "255": 3, "background": 3, "darker": 3, "lighter": 3, "night": 3, "darkest": 3, "contrast": 3, "font_famili": 3, "font": 3, "courier": 3, "new": [3, 4], "coma": 3, "separ": 3, "pro": 3, "monospac": 3, "automat": 3, "fallback": 3, "font_ratio": 3, "ratio": 3, "height": 3, "vari": 3, "render": 3, "fine": 3, "5": 3, "within": 3, "everywher": 3, "safe": 3, "correct": 3, "pygment": 3, "dracula": 3, "materi": 3, "sa": 3, "place_hold": 3, "place": 3, "holder": 3, "none": 3, "blank": 3, "nlc": 3, "actionable_typ": 3, "hyperlink": 3, "dash": 3, "multi": 3, "cell": 3, "focus": 3, "cb_anchor": 3, "unset": 3, "disabl": 3, "arrow_right_hook": 3, "around": 3, "glyph": 3, "substitut": 3, "arrow": 3, "2192": 3, "suit": 3, "person": 3, "tast": 3, "synopsi": 3, "destin": 3, "quickli": 3, "pwm_led_0": 3, "glob": 3, "40008000": 3, "40009000": 3, "4000a000": 3, "4001a000": 3, "4001b000": 3, "uart0_default": 3, "uart0_sleep": 3, "uart1_default": 3, "empti": 3, "filter": 3, "quick": 3, "rl": 3, "nr": 3, "0xe000e100": 3, "distinguish": 3, "lowercas": 3, "prove": 3, "difficult": 3, "pref_hex_upp": 3, "i2c1": 3, "nkyc": 3, "0x4001e000": 3, "arduino_i2c": 3, "bme680_i2c": 3, "ignor": 3, "pk": 3, "result": 3, "nk": 3, "count": 3, "dma": 3, "kd": 3, "uart0": 3, "easydma": 3, "uart1": 3, "arduino_seri": 3, "spi3": 3, "arduino_spi": 3, "spim": 3, "master": 3, "expr": 3, "associ": 3, "far": 3, "backward": 3, "top": 3, "level": 3, "nxd": 3, "group1": 3, "group2": 3, "gpiot": 3, "40006000": 3, "nrf5": 3, "input": 3, "button_0": 3, "button_1": 3, "expos": 3, "push": 3, "butt": 3, "nld": 3, "switch": 3, "mention": 3, "famou": 3, "__device_dts_ord_": 3, "sometim": 3, "beginn": 3, "driver": 3, "14": 3, "__device_dts_ord_124": 3, "undeclar": 3, "function": 3, "did": 3, "__device_dts_ord_14": 3, "89": 3, "device_name_get": 3, "dev_id": 3, "_concat": 3, "__device_": 3, "further": 3, "rememb": 3, "neg": 3, "124": 3, "definit": 3, "savvi": 3, "skim": 3, "devicetree_gener": 3, "put": 3, "togeth": 3, "scatter": 3, "among": 3, "more": 3, "ten": 3, "thousand": 3, "macro": 3, "dt_n_s_soc_s_i2c_40003000_ord": 3, "dt_n_s_soc_s_i2c_40003000_status_dis": 3, "dt_n_s_soc_s_i2c_40003000_s_bme680_76_ord": 3, "125": 3, "dt_n_s_soc_s_i2c_40003000_s_bme680_76_requires_ord": 3, "clear": 3, "reach": 3, "conclus": 3, "blink": 3, "ey": 3, "dep": 3, "sai": 3, "pstd": 3, "artifici": 3, "silver": 3, "bullet": 3, "But": 3, "take": 3, "second": 3, "might": 3, "yield": 3, "hint": 3, "ref": 3, "int": 3, "okai": 3, "unless": 3, "term": 3, "realli": 3, "seem": 3, "usbd": 3, "40027000": 3, "usb": 3, "bme": 3, "ncy": 3, "nid": 3, "larg": 3, "resourc": 3, "512k": 3, "concaten": 3, "xpath": 3, "referenc": 3, "prop": 3, "w": 3, "wakeup": 3, "write": 3, "block": 3, "0x04": 3, "hijack": 3, "dby": 3, "specif": 3, "info": 3, "quad": 3, "whenev": 3, "pm": 3, "runtim": 3, "0x00": 3, "0x100000": 3, "eras": 3, "lb": 3, "neither": 3, "phandl": 3, "arrai": 3, "human": 3, "readabl": 3, "bl": 3, "deprec": 3, "enum": 3, "s2b1v1": 3, "s1b6": 3, "s2b7": 3, "s2b1v4": 3, "s2b1v5": 3, "s2b1v6": 3, "const": 3, "Not": 3, "qspi_default": 3, "qspi_sleep": 3, "sleep": 3, "al": 3, "partial": 3, "pc": 3, "rightward": 3, "arrow_right": 3, "random": 3, "4000d000": 3, "rng": 3, "ram": 3, "nrd": 3, "chip": 3, "builtin": 3, "bbc_microbit": 3, "bbc": 3, "micro": 3, "mcu": 3, "arch": 3, "toolchain": 3, "gnuarmemb": 3, "xtool": 3, "test": 3, "ignore_tag": 3, "net": 3, "ble": 3, "rto": 3, "v3": 3, "7": 3, "275": 3, "gccb616c9673": 3, "nrf52840dk": 3, "moin": 3, "machin": 3, "hwmv2": 3, "section": 3, "ol": 3, "releas": [3, 4], "extern": 3, "bme68x": 3, "iaq": 3, "local": 3, "field": 3, "relat": 3, "hoover": 3, "reveal": 3, "click": 3, "il": 3, "board_dir": 3, "dk": 3, "1024": 3, "arduino_gpio": 3, "counter": 3, "i2": 3, "usb_devic": 3, "watchdog": 3, "netif": 3, "openthread": 3, "brows": 3, "integr": 3, "keystrok": 3, "discov": 3, "memor": 3, "remind": 3, "turn": 3, "return": 3, "rational": 3, "choos": 3, "exot": 3, "note": [3, 4], "close": 3, "signal": 3, "eof": 3, "send": 3, "z": 3, "achiev": 3, "trigger": 3, "tab": 3, "twice": 3, "word": 3, "candid": 3, "contextu": 3, "propos": [3, 4], "undefin": 3, "subsequ": 3, "anywher": 3, "concat": 3, "cursor": 3, "i2c0_default": 3, "i2c0_sleep": 3, "i2c1_default": 3, "i2c1_sleep": 3, "indic": 3, "wake": 3, "manag": 3, "src": 3, "cmakelist": 3, "readm": 3, "rst": 3, "prj": 3, "conf": 3, "doc": 3, "home": 3, "myself": 3, "convent": 3, "intuit": 3, "down": 3, "keyboard": 3, "shortcut": 3, "persist": 3, "honor": 3, "histcontrol": 3, "histignor": 3, "facil": 3, "data": 3, "almost": 3, "could": 3, "pain": 3, "understand": 3, "offer": 3, "featur": 3, "besid": 3, "preserv": 3, "displai": 3, "sic": 3, "doesn": 3, "movement": 3, "unhappi": 3, "compil": 3, "vertic": 3, "someth": 3, "ncryd": 3, "tui": 3, "compon": 3, "browser": 3, "modern": 3, "them": 3, "tag": 3, "underlin": 3, "somewhat": 3, "imit": 3, "tooltip": 3, "hold": 3, "easili": 3, "feel": 3, "too": 3, "invas": 3, "inappropri": 3, "encod": 3, "audio": 3, "mime": 3, "bindabl": 3, "modifi": 3, "uppercas": 3, "meta": 3, "bound": 3, "esc": 3, "app": 3, "iterm2": 3, "remap": 3, "those": 3, "below": 3, "ones": 3, "back": 3, "screen": 3, "redraw": 3, "drag": 3, "over": 3, "transpos": 3, "char": 3, "past": 3, "delet": 3, "kill": 3, "cut": 3, "behind": 3, "yank": 3, "ring": 3, "buffer": 3, "rotat": 3, "_": 3, "undo": 3, "come": 3, "init": 3, "manipul": 3, "fetch": 3, "increment": 3, "replac": 3, "piec": 3, "recent": 3, "abort": 3, "think": 3, "capabl": 3, "sequenc": 3, "plu": 3, "osc": 3, "todai": 3, "conhost": 3, "box": 3, "draw": 3, "tofu": 3, "unpleas": 3, "palett": 3, "bold": 3, "bright": 3, "profil": 3, "mostli": 3, "pleasant": 3, "recommend": 3, "full": 3, "wide": 3, "maxim": 3, "2500": 3, "257f": 3, "form": 3, "fg": 3, "bg": 3, "foreground": 3, "dark_green": 3, "005f00": 3, "caus": 3, "headach": 3, "concern": 3, "devicetre": 4, "embedded develop": 4, "iot": 4, "line": 4, "flexibl": 4, "criteria": 4, "text": 4, "illustr": 4, "arbitrari": 4, "welcom": 4, "mirror": 4, "serv": 4, "upstream": 4, "rfc": 4, "proof": 4, "concept": 4, "prototyp": 4, "main": 4, "repositori": 4, "usag": 4, "step": 4, "built": 4, "faq": 4, "tip": 4, "addition": 3}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"faq": 1, "tip": 1, "run": 1, "dtsh": [1, 2, 3, 4], "fail": 1, "open": 1, "devicetre": [1, 2, 3], "lack": 1, "bind": [1, 3], "user": [1, 3], "interfac": [1, 3], "i": 1, "d": 1, "prefer": [1, 3], "tradit": 1, "prompt": [1, 3], "someth": 1, "littl": 1, "more": 1, "sober": 1, "command": [1, 3], "output": [1, 3], "redirect": [1, 3], "mismatch": 1, "html": 1, "background": 1, "default": 1, "render": 1, "get": 2, "start": 2, "guid": 2, "instal": 2, "requir": 2, "python": 2, "extern": 2, "depend": 2, "alongsid": 2, "west": 2, "standalon": 2, "usag": [2, 3], "typic": [2, 3], "us": [2, 3], "other": [2, 3], "batch": [2, 3], "mode": [2, 3], "configur": [2, 3], "first": 2, "step": 2, "": 3, "handbook": 3, "The": 3, "shell": 3, "hierarch": 3, "file": 3, "system": 3, "metaphor": 3, "line": 3, "string": 3, "format": 3, "specifi": 3, "list": 3, "tree": 3, "sort": 3, "kei": 3, "direct": 3, "search": 3, "text": 3, "pattern": 3, "base": 3, "criteria": 3, "integ": 3, "express": 3, "criterion": 3, "chain": 3, "gener": 3, "access": 3, "syntax": 3, "highlight": 3, "altern": 3, "symbol": 3, "built": 3, "cd": 3, "pwd": 3, "l": 3, "option": 3, "exampl": 3, "find": 3, "cat": 3, "alia": 3, "chosen": 3, "board": 3, "unam": 3, "kernel": 3, "soc": 3, "all": 3, "textual": 3, "auto": 3, "complet": 3, "argument": 3, "paramet": 3, "path": 3, "histori": 3, "pager": 3, "less": 3, "action": 3, "move": 3, "edit": 3, "chang": 3, "appear": 3, "termin": 3, "theme": 3, "project": 4, "document": 4, "statu": 4, "content": 4}, "envversion": {"sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx": 60}, "alltitles": {"FAQ & Tips": [[1, "faq-tips"]], "Running DTSh": [[1, "running-dtsh"]], "Failed to open devicetree, lacks bindings": [[1, "failed-to-open-devicetree-lacks-bindings"]], "User interface": [[1, "user-interface"]], "I\u2019d prefer the traditional $ prompt": [[1, "i-d-prefer-the-traditional-prompt"]], "I\u2019d prefer something a little more sober": [[1, "i-d-prefer-something-a-little-more-sober"]], "Command output redirection": [[1, "command-output-redirection"]], "Mismatched HTML backgrounds": [[1, "mismatched-html-backgrounds"]], "Default HTML rendering": [[1, "id3"]], "DTSh Project Documentation": [[4, "dtsh-project-documentation"]], "Status": [[4, "status"]], "Contents:": [[4, null]], "Getting Started Guide": [[2, "getting-started-guide"]], "Install DTSh": [[2, "install-dtsh"]], "Requirements": [[2, "requirements"]], "python-devicetree": [[2, "python-devicetree"]], "External Dependencies": [[2, "external-dependencies"], [2, "id1"]], "Installation": [[2, "installation"]], "Install Alongside West": [[2, "install-alongside-west"]], "Standalone Installation": [[2, "standalone-installation"]], "Usage": [[2, "usage"], [3, "usage"]], "Typical Use": [[2, "typical-use"], [3, "typical-use"]], "Other Uses": [[2, "other-uses"], [3, "other-uses"]], "Batch Mode": [[2, "batch-mode"], [3, "batch-mode"]], "Configuration": [[2, "configuration"], [3, "configuration"]], "First Steps": [[2, "first-steps"]], "DTSh\u2019s Handbook": [[3, "dtsh-s-handbook"]], "Configuration Format": [[3, "configuration-format"]], "The Shell": [[3, "the-shell"]], "Hierarchical File System Metaphor": [[3, "hierarchical-file-system-metaphor"]], "The Command Line": [[3, "the-command-line"]], "Command Strings": [[3, "command-strings"]], "Output Redirection": [[3, "output-redirection"], [3, "dtsh-prefs-redir2fs"]], "Format Commands Output": [[3, "format-commands-output"]], "Format Strings": [[3, "format-strings"]], "Format string specifiers": [[3, "id21"]], "Formatted Lists": [[3, "formatted-lists"], [3, "dtsh-prefs-lists"]], "Formatted Trees": [[3, "formatted-trees"], [3, "dtsh-prefs-trees"]], "Sort Commands Output": [[3, "sort-commands-output"]], "Sort Keys": [[3, "sort-keys"]], "Sort keys": [[3, "id22"]], "Sort Directions": [[3, "sort-directions"]], "Search the Devicetree": [[3, "search-the-devicetree"]], "Text Patterns": [[3, "text-patterns"]], "Text-based criteria": [[3, "id23"]], "Integer Expressions": [[3, "integer-expressions"]], "Integer-based criteria": [[3, "id24"]], "Criterion Chains": [[3, "criterion-chains"]], "Batch Commands": [[3, "batch-commands"]], "Batch Files": [[3, "batch-files"]], "User Preferences": [[3, "user-preferences"]], "General Preferences": [[3, "general-preferences"]], "The Prompt": [[3, "the-prompt"], [3, "dtsh-prompt"]], "File System Access": [[3, "file-system-access"]], "Syntax Highlighting": [[3, "syntax-highlighting"]], "Alternative Symbols": [[3, "alternative-symbols"]], "Built-in Commands": [[3, "built-in-commands"]], "cd": [[3, "cd"]], "pwd": [[3, "pwd"]], "ls": [[3, "ls"]], "Options": [[3, "options"], [3, "dtsh-tree-options"], [3, "dtsh-find-options"], [3, "dtsh-cat-options"], [3, "dtsh-alias-options"], [3, "dtsh-chosen-options"], [3, "dtsh-board-options"], [3, "dtsh-uname-options"]], "Examples": [[3, "examples"], [3, "dtsh-tree-examples"], [3, "dtsh-find-examples"], [3, "dtsh-cat-examples"], [3, "dtsh-alias-examples"], [3, "dtsh-chosen-examples"], [3, "dtsh-board-examples"], [3, "dtsh-uname-examples"]], "tree": [[3, "tree"]], "find": [[3, "find"]], "cat": [[3, "cat"]], "alias": [[3, "alias"]], "chosen": [[3, "chosen"]], "board": [[3, "board"]], "uname": [[3, "uname"]], "Kernel": [[3, "id29"]], "Board": [[3, "id30"]], "SoC": [[3, "id31"]], "All": [[3, "id32"]], "Textual User Interface": [[3, "textual-user-interface"]], "Auto-completion": [[3, "auto-completion"]], "Auto-complete Commands": [[3, "auto-complete-commands"]], "Auto-complete Options": [[3, "auto-complete-options"]], "Auto-complete Arguments": [[3, "auto-complete-arguments"]], "Auto-complete Parameters": [[3, "auto-complete-parameters"]], "Auto-complete Redirection Paths": [[3, "auto-complete-redirection-paths"]], "Command History": [[3, "command-history"], [3, "id36"]], "The Pager": [[3, "the-pager"]], "Pager key bindings (less)": [[3, "id33"]], "Actionable Text": [[3, "actionable-text"]], "Key Bindings": [[3, "key-bindings"]], "Moving and Editing": [[3, "moving-and-editing"]], "Moving": [[3, "id34"]], "Changing text": [[3, "id35"]], "Command Line History": [[3, "command-line-history"]], "Appearance": [[3, "appearance"]], "The Terminal": [[3, "the-terminal"]], "User Themes": [[3, "user-themes"]]}, "indexentries": {}}) \ No newline at end of file