| newt run |
| --------- |
| |
| A single command to do four steps - build a target, create-image, load image on a board, and start a debug session with the image on the board. |
| |
| **Note**: If the version number is omitted: |
| |
| - The create-image step is skipped for a bootloader target. |
| - You will be prompted to enter a version number for an application target. |
| |
| Usage: |
| ^^^^^^ |
| |
| .. code-block:: console |
| |
| newt run <target-name> [<version>][flags] |
| |
| Flags: |
| ^^^^^^ |
| |
| .. code-block:: console |
| |
| --extrajtagcmd string Extra commands to send to JTAG software |
| -n, --noGDB Do not start GDB from the command line |
| |
| Global Flags: |
| ^^^^^^^^^^^^^ |
| |
| .. code-block:: console |
| |
| -h, --help Help for newt commands |
| -j, --jobs int Number of concurrent build jobs (default 8) |
| -l, --loglevel string Log level (default "WARN") |
| -o, --outfile string Filename to tee output to |
| -q, --quiet Be quiet; only display error output |
| -s, --silent Be silent; don't output anything |
| -v, --verbose Enable verbose output when executing commands |
| |
| Description |
| ^^^^^^^^^^^ |
| |
| Same as running ``build <target-name>``, ``create-image <target-name> <version>``, ``load <target-name>``, and ``debug <target-name>``. |
| |
| Examples |
| ^^^^^^^^ |
| |
| +------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ |
| | Usage | Explanation | |
| +====================================+======================================================================================================================================================================================================================================================================================================================================================================================+ |
| | ``newt run blink_rigado`` | Compiles and builds the image for the ``app`` and the ``bsp`` defined for target ``blink_rigado``, loads the image onto the board, and opens an active GNU gdb debugging session to run the image. | |
| +------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ |
| | ``newt run ble_rigado 0.1.0.0`` | Compiles and builds the image for the ``app`` and the ``bsp`` defined for target ``ble_rigado``, signs and creates the image with version number 0.1.0.0, loads the image onto the board, and opens an active GNU gdb debugging session to run the image. Note that if there is no bootloader available for a particular board/kit, a signed image creation step is not necessary. | |
| +------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ |
