michaelh/zephyr
1
0
Fork 0
Code Releases Activity
zephyr/scripts/west-commands.yml

101 lines
2.9 KiB
YAML
Raw Permalink Normal View History

scripts: west commands: add text for "west --help" Although each of these command implementations has good output for "west <command> --help", the "west --help" output is missing the one-line descriptions. Add them by modifying west-commands.yml to use a new 'help' key in each command name. These need to be kept in sync with the Python sources. For now just do that by copy/pasting. We could add fancy logic to load the help from west-commands.yml later if we want. Signed-off-by: Marti Bolivar <marti@foundries.io>
2019-01-28 10:45:02 -07:00
# Keep the help strings in sync with the values in the .py files!
scripts: add west build, flash, and debug commands West now supports a mechanism for extension commands. Use it to move the command implementations that are tightly coupled with boards and the zephyr build system back into the Zephyr repository. This patch doesn't include test cases. Those will be moved over in a subsequent patch. Signed-off-by: Marti Bolivar <marti@foundries.io>
2019-01-23 08:31:06 -07:00
west-commands:
west: Add completion command Add a completion command that dumps the contents of a shell completion file present in the zephyr repository. Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>
2019-05-08 18:05:38 +02:00
- file: scripts/west_commands/completion.py
commands:
- name: completion
class: Completion
west: Add completion support for zsh As part of the overall work on improving west integration with Zephyr, add support for zsh completion in the `west completion` command. Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>
2022-08-31 14:31:35 +02:00
help: output shell completion scripts
west: Add a boards command Add a new "boards" command that is able to list all the boards in the upstream tree. There is currently no support for out-of-tree boards. The command executes cmake to use the built-in CMake script, boards.cmake, to list the boards, and then stores the information retrieved and allows the user to present it in a user-definable format. Fixes https://github.com/zephyrproject-rtos/west/issues/53 Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>
2019-04-23 22:34:40 +02:00
- file: scripts/west_commands/boards.py
commands:
- name: boards
class: Boards
help: display information about supported boards
scripts: west: commands: shields: add cmd for listing supported shields Add "west shields" command for listing supported shields. Signed-off-by: Henrik Brix Andersen <hebad@vestas.com>
2024-05-14 10:32:52 +02:00
- file: scripts/west_commands/shields.py
commands:
- name: shields
class: Shields
help: display list of supported shields
scripts: add west build, flash, and debug commands West now supports a mechanism for extension commands. Use it to move the command implementations that are tightly coupled with boards and the zephyr build system back into the Zephyr repository. This patch doesn't include test cases. Those will be moved over in a subsequent patch. Signed-off-by: Marti Bolivar <marti@foundries.io>
2019-01-23 08:31:06 -07:00
- file: scripts/west_commands/build.py
commands:
- name: build
class: Build
scripts: west commands: add text for "west --help" Although each of these command implementations has good output for "west <command> --help", the "west --help" output is missing the one-line descriptions. Add them by modifying west-commands.yml to use a new 'help' key in each command name. These need to be kept in sync with the Python sources. For now just do that by copy/pasting. We could add fancy logic to load the help from west-commands.yml later if we want. Signed-off-by: Marti Bolivar <marti@foundries.io>
2019-01-28 10:45:02 -07:00
help: compile a Zephyr application
west: west twister integration Add twister command to west. Signed-off-by: Al Semjonovs <asemjonovs@google.com>
2022-09-22 08:46:44 -06:00
- file: scripts/west_commands/twister_cmd.py
commands:
- name: twister
class: Twister
help: west twister wrapper
scripts: west_commands: add sign command This command is useful for signing binaries for loading by a bootloader. At present, only MCUboot's "imgtool" is supported, but it would be straightforward to add support for additional tools. Using this command instead of "plain" imgtool avoids looking up any numbers for the flash write block size, text section offset, or slot size to get a signed binary. All users need to specify is the location of the signing key. This greatly improves usability for those unfamiliar with MCUboot, or even experienced users who have to deal with multiple flash partition layouts, boards, etc. The command works by inspecting state in the Zephyr build system, some of which is also provided by the runner package. Signed-off-by: Marti Bolivar <marti@foundries.io>
2019-01-30 20:30:42 -07:00
- file: scripts/west_commands/sign.py
commands:
- name: sign
class: Sign
help: sign a Zephyr binary for bootloader chain-loading
scripts: add west build, flash, and debug commands West now supports a mechanism for extension commands. Use it to move the command implementations that are tightly coupled with boards and the zephyr build system back into the Zephyr repository. This patch doesn't include test cases. Those will be moved over in a subsequent patch. Signed-off-by: Marti Bolivar <marti@foundries.io>
2019-01-23 08:31:06 -07:00
- file: scripts/west_commands/flash.py
commands:
- name: flash
class: Flash
scripts: west commands: add text for "west --help" Although each of these command implementations has good output for "west <command> --help", the "west --help" output is missing the one-line descriptions. Add them by modifying west-commands.yml to use a new 'help' key in each command name. These need to be kept in sync with the Python sources. For now just do that by copy/pasting. We could add fancy logic to load the help from west-commands.yml later if we want. Signed-off-by: Marti Bolivar <marti@foundries.io>
2019-01-28 10:45:02 -07:00
help: flash and run a binary on a board
scripts: add west build, flash, and debug commands West now supports a mechanism for extension commands. Use it to move the command implementations that are tightly coupled with boards and the zephyr build system back into the Zephyr repository. This patch doesn't include test cases. Those will be moved over in a subsequent patch. Signed-off-by: Marti Bolivar <marti@foundries.io>
2019-01-23 08:31:06 -07:00
- file: scripts/west_commands/debug.py
commands:
- name: debug
class: Debug
scripts: west commands: add text for "west --help" Although each of these command implementations has good output for "west <command> --help", the "west --help" output is missing the one-line descriptions. Add them by modifying west-commands.yml to use a new 'help' key in each command name. These need to be kept in sync with the Python sources. For now just do that by copy/pasting. We could add fancy logic to load the help from west-commands.yml later if we want. Signed-off-by: Marti Bolivar <marti@foundries.io>
2019-01-28 10:45:02 -07:00
help: flash and interactively debug a Zephyr application
scripts: add west build, flash, and debug commands West now supports a mechanism for extension commands. Use it to move the command implementations that are tightly coupled with boards and the zephyr build system back into the Zephyr repository. This patch doesn't include test cases. Those will be moved over in a subsequent patch. Signed-off-by: Marti Bolivar <marti@foundries.io>
2019-01-23 08:31:06 -07:00
- name: debugserver
class: DebugServer
scripts: west commands: add text for "west --help" Although each of these command implementations has good output for "west <command> --help", the "west --help" output is missing the one-line descriptions. Add them by modifying west-commands.yml to use a new 'help' key in each command name. These need to be kept in sync with the Python sources. For now just do that by copy/pasting. We could add fancy logic to load the help from west-commands.yml later if we want. Signed-off-by: Marti Bolivar <marti@foundries.io>
2019-01-28 10:45:02 -07:00
help: connect to board and launch a debug server
scripts: add west build, flash, and debug commands West now supports a mechanism for extension commands. Use it to move the command implementations that are tightly coupled with boards and the zephyr build system back into the Zephyr repository. This patch doesn't include test cases. Those will be moved over in a subsequent patch. Signed-off-by: Marti Bolivar <marti@foundries.io>
2019-01-23 08:31:06 -07:00
- name: attach
class: Attach
scripts: west commands: add text for "west --help" Although each of these command implementations has good output for "west <command> --help", the "west --help" output is missing the one-line descriptions. Add them by modifying west-commands.yml to use a new 'help' key in each command name. These need to be kept in sync with the Python sources. For now just do that by copy/pasting. We could add fancy logic to load the help from west-commands.yml later if we want. Signed-off-by: Marti Bolivar <marti@foundries.io>
2019-01-28 10:45:02 -07:00
help: interactively debug a board
west: runners: Add `west rtt` command with pyocd implementation This command runs separately from a debug server, instead of attaching to a running server. This is both the easiest out of the box experience, and also should be possible to implement consistently for most runners. This commit includes an initial implementation for pyocd. Signed-off-by: Tobias Pisani <mail@topisani.dev>
2024-07-05 12:42:12 +02:00
- name: rtt
class: Rtt
help: open an rtt shell
cmake: West extension command for Zephyr config package registration This command make it possible to use west for first time registration of a Zephyr config package in CMake. To register Zephyr as a CMake config package, invoke: west zephyr-export Signed-off-by: Torsten Rasmussen <Torsten.Rasmussen@nordicsemi.no>
2020-03-05 13:42:42 +01:00
- file: scripts/west_commands/export.py
commands:
- name: zephyr-export
class: ZephyrExport
help: export Zephyr installation as a CMake config package
west: spdx: Generate SPDX 2.2 tag-value documents This adds support to generate SPDX 2.2 tag-value documents via the new west spdx command. The CMake file-based APIs are leveraged to create relationships from source files to the corresponding generated build files. SPDX-License-Identifier comments in source files are scanned and filled into the SPDX documents. Before `west build` is run, a specific file must be created in the build directory so that the CMake API reply will run. This can be done by running: west spdx --init -d BUILD_DIR After `west build` is run, SPDX generation is then activated by calling `west spdx`; currently this requires passing the build directory as a parameter again: west spdx -d BUILD_DIR This will generate three SPDX documents in `BUILD_DIR/spdx/`: 1) `app.spdx`: This contains the bill-of-materials for the application source files used for the build. 2) `zephyr.spdx`: This contains the bill-of-materials for the specific Zephyr source code files that are used for the build. 3) `build.spdx`: This contains the bill-of-materials for the built output files. Each file in the bill-of-materials is scanned, so that its hashes (SHA256 and SHA1) can be recorded, along with any detected licenses if an `SPDX-License-Identifier` appears in the file. SPDX Relationships are created to indicate dependencies between CMake build targets; build targets that are linked together; and source files that are compiled to generate the built library files. `west spdx` can be called with optional parameters for further configuration: * `-n PREFIX`: specifies a prefix for the Document Namespaces that will be included in the generated SPDX documents. See SPDX spec 2.2 section 2.5 at https://spdx.github.io/spdx-spec/2-document-creation-information/. If -n is omitted, a default namespace will be generated according to the default format described in section 2.5 using a random UUID. * `-s SPDX_DIR`: specifies an alternate directory where the SPDX documents should be written. If not specified, they will be saved in `BUILD_DIR/spdx/`. * `--analyze-includes`: in addition to recording the compiled source code files (e.g. `.c`, `.S`) in the bills-of-materials, if this flag is specified, `west spdx` will attempt to determine the specific header files that are included for each `.c` file. This will take longer, as it performs a dry run using the C compiler for each `.c` file (using the same arguments that were passed to it for the actual build). * `--include-sdk`: if `--analyze-includes` is used, then adding `--include-sdk` will create a fourth SPDX document, `sdk.spdx`, which will list any header files included from the SDK. Signed-off-by: Steve Winslow <steve@swinslow.net>
2021-04-20 23:04:52 -04:00
- file: scripts/west_commands/spdx.py
commands:
- name: spdx
class: ZephyrSpdx
help: create SPDX bill of materials
modules: Basic binary blob infrastructure This patch introduces the basic infrastructure to list and fetch binary blobs. This includes: - The new 'blobs' extension command - An implementation of the `west blobs list` command with custom formatting - A very simple mechanism for loading fetchers - A basic implementation of an HTTP fetcher In order to ensure consistency among the west extension commands in the main zephyr tree, we reuse a similar class factory pattern that is present for ZephyrBinaryRunner instances in the ZephyrBlobFetcher case. This could be achieved with a simpler mechanism, but opted for consistency before simplicity. Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>
2022-08-04 19:08:22 +02:00
- file: scripts/west_commands/blobs.py
commands:
- name: blobs
class: Blobs
help: work with binary blobs
west: commands: Add bindesc command Added the bindesc command to west, for working with binary descriptors. Currently it supports dump, list and search subcommands, for bin, hex, elf and uf2 file types. Signed-off-by: Yonatan Schachter <yonatan.schachter@gmail.com>
2023-03-24 14:37:24 +03:00
- file: scripts/west_commands/bindesc.py
commands:
- name: bindesc
class: Bindesc
help: work with Binary Descriptors
West: Add `west robot` command Introduce `robot` command for running Robot Framework test suites. Initial implementation consists of one runner dedicated for renode-test, which is a Renode wrapper for running Robot tests. Signed-off-by: Michał Szprejda <mszprejda@antmicro.com>
2024-03-07 10:35:06 +01:00
- file: scripts/west_commands/robot.py
commands:
- name: robot
class: Robot
help: run RobotFramework test suites
West: Add `west simulate` command Introduce `simulate `command for running samples on a simulator of choice. Initial implementation consists of one runner, dedicated for Renode. Signed-off-by: Michał Szprejda <mszprejda@antmicro.com>
2024-03-07 10:30:09 +01:00
- file: scripts/west_commands/simulate.py
commands:
- name: simulate
class: Simulate
help: simulate board
commands: add the 'sdk' command to manage SDK. This command can list and install SDK. Run 'west sdk install' to install the SDK. Run without any parameter, installing specified by SDK_VERSION in the source tree. 'west sdk' to show installed SDK information. This command is just a wrapper for SDK's setup command, but it simplifies the installation process. It will be a good improvement for onboarding first-time users. Signed-off-by: TOKITA Hiroshi <tokita.hiroshi@gmail.com>
2024-07-24 06:26:02 +09:00
- file: scripts/west_commands/sdk.py
commands:
- name: sdk
class: Sdk
help: manage Zephyr SDK
scripts: west_commands: Add packages command Add a new west command as helper for package management of Zephyr and modules. The first package manager to get supported is pip, where west projects can list individual packages or requirements files in their module file. A convenience --install argument is added to install the packages instead. Signed-off-by: Pieter De Gendt <pieter.degendt@basalte.be>
2024-11-02 16:46:56 +01:00
- file: scripts/west_commands/packages.py
commands:
- name: packages
class: Packages
help: manage packages for Zephyr
scripts: west-commands: add an entry for the patch command Add an entry to west-commands.yml for the west patch command. Signed-off-by: Chris Friedt <cfriedt@tenstorrent.com>
2024-12-19 15:53:41 -05:00
- file: scripts/west_commands/patch.py
commands:
- name: patch
class: Patch
help: manage patches for Zephyr modules
scripts: add "west gtags" command This is an extension for indexing the source code in the workspace with GNU Global. See the command line help for more information about Global. Signed-off-by: Martí Bolívar <marti.bolivar@oss.qualcomm.com>
2025-02-19 00:05:18 -08:00
- file: scripts/west_commands/gtags.py
commands:
- name: gtags
class: Gtags
help: create a GNU global tags file for the current workspace
Copy permalink