newt create-image
------------------

Create and sign an image by adding an image header to the binary file created for a target. Version number in the header is set to <version>. To sign an image provide a .pem file for the signing-key and an optional key-id.

Usage:
^^^^^^

.. code-block:: console

        newt create-image <target-name> <version> [signing-key [key-id]][flags]

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
^^^^^^^^^^^

Adds an image header to the created binary file for the ``target-name`` target. The image version is set to ``version``. It creates a ``<app-name>.img`` file the image, where ``app-name`` is the value specified in the target ``app`` variable, and stores the file in the '/bin/targets/<target-name>/app/apps/<app-name>/' directory. It also creates a ``<app-name>.hex`` file for the image in the same directory, and adds the version, build id, image file name, and image hash to the ``manifest.json`` file that the ``newt build`` command created.

To sign an image, provide a .pem file for the ``signing-key`` and an optional ``key-id``. ``key-id`` must be a value between 0-255.

Examples
^^^^^^^^

================================================== =================================================================================
Usage                                              Explanation
================================================== =================================================================================
``newt create-image myble2 1.0.1.0``               Creates an image for target ``myble2`` and assigns it version
                                                   ``1.0.1.0``.

                                                   For the following target definition:

                                                   | targets/myble2
                                                   | app=\@apache-mynewt-core/apps/btshell
                                                   | bsp=\@apache-mynewt-core/hw/bsp/nrf52dk
                                                   | build\_profile=optimized
                                                   | syscfg=STATS\_NAMES=1

                                                   the 'bin/targets/myble2/app/apps/btshell/btshell.img' and
                                                   'bin/targets/myble2/app/apps/btshell/btshell.hex' files are created,
                                                   and the manifest in 'bin/targets/myble2/app/apps/btshell/manifest.json'
                                                   is updated with the image information.

``newt create-image myble2 1.0.1.0 private.pem``   Creates an image for target ``myble2`` and assigns it the version
                                                   ``1.0.1.0``. Signs the image using private key specified by the private.pem file.
================================================== =================================================================================