newtmgr image

Manage images on a device.

Usage:

newtmgr image [command] -c <connection_profile> [flags]

Flags:

The coredownload subcommand uses the following local flags:

-n, --bytes uint32         Number of bytes of the core to download
-e, --elfify               Create an ELF file
    --offset unint32       Offset of the core file to start the download

Global Flags:

-c, --conn string       connection profile to use
-h, --help              help for newtmgr
-l, --loglevel string   log level to use (default "info")
    --name string       name of target BLE device; overrides profile setting
-t, --timeout float     timeout in seconds (partial seconds allowed) (default 10)
-r, --tries int         total number of tries in case of timeout (default 1)

Description

The image command provides subcommands to manage core and image files on a device. Newtmgr uses the conn_profile connection profile to connect to the device.

Sub-command	Explanation
confirm	The newtmgr image confirm [hex-image-hash] command makes an image setup permanent on a device. If a hex-image-hash hash value is specified, Mynewt permanently switches to the image identified by the hash value. If a hash value is not specified, the current image is made permanent.
coreconvert	The newtmgr image coreconvert <core-filename> <elf-file> command converts the core-filename core file to an ELF format and names it elf-file. Note: This command does not download the core file from a device. The core file must exist on your host.
coredownload	The newtmgr image coredownload <core-filename> command downloads the core file from a device and names the file core-filename on your host. Use the local flags under Flags to customize the command.
coreerase	The newtmgr image coreerase command erases the core file on a device.
corelist	The newtmgr image corelist command lists the core(s) on a device.
erase	The newtmgr image erase command erases an unused image from the secondary image slot on a device. The image cannot be erased if the image is a confirmed image, is marked for test on the next reboot, or is an active image for a split image setup.
list	The newtmgr image list command displays information for the images on a device.
test	The newtmgr test <hex-image-hash> command tests the image, identified by the hex-image-hash hash value, on next reboot.
upload	The newtmgr image upload <image-file> command uploads the image-file image file to a device.

Examples

Sub-command	Usage	Explanation
confirm	newtmgr confirm -c profile01	Makes the current image setup on a device permanent. Newtmgr connects to the device over a connection specified in the profile01 connection profile.
confirm	newtmgr confirmbe9699809a049...73d77f-c profile01	Makes the image, identified by the be9699809a049...73d77f hash value, setup on a device permanent. Newtmgr connects to the device over a connection specified in the profile01 connection profile.
coreconvert	newtmgr image coreconvert mycore mycore.elf	Converts the mycore file to the ELF format and saves it in the mycore.elf file.
coredownload	newtmgr image coredownload mycore -c profile01	Downloads the core from a device and saves it in the mycore file. Newtmgr connects to the device over a connection specified in the profile01 connection profile.
coredownload	newtmgr image coredownload mycore -e -c profile01	Downloads the core from a device, converts the core file into the ELF format, and saves it in the mycore file. Newtmgr connects to the device over a connection specified in the profile01 connection profile.
coredownload	newtmgr image coredownload mycore --offset 10 -n 30 -c profile01	Downloads 30 bytes, starting at offset 10, of the core from a device and saves it in the mycore file. Newtmgr connects to the device over a connection specified in the profile01 connection profile.
coreerase	newtmgr image coreerase -c profile01	Erases the core file on a device. Newtmgr connects to the device over a connection specified in the profile01 connection profile.
corelist	newtmgr image corelist -c profile01	Lists the core files on a device. Newtmgr connects to the device over a connection specified in the profile01 connection profile.
erase	newtmgr image erase -c profile01	Erases the image, if unused, from the secondary image slot on a device. Newtmgr connects to the device over a connection specified in the profile01 connection profile.
list	newtmgr image list -c profile01	Lists the images on a device. Newtmgr connects to the device over a connection specified in the profile01 connection profile.
test	newtmgr image test be9699809a049...73d77f	Tests the image, identified by the be9699809a049...73d77f hash value, during the next reboot on a device. Newtmgr connects to the device over a connection specified in the profile01 connection profile.
upload	newtmgr image upload btshell.img -c profile01	Uploads the btshell.img image to a device. Newtmgr connects to the device over a connection specified in the profile01 connection profile.