nRF Connect Programmer v1.4.1 or later

nRF Connect Programmer overview

The nRF Connect Programmer main window shows the memory layout of device and file you want to work with. It also provides you with options to program the device and inspect the whole process through the log.

When you start the Programmer app, the following main window appears:
Figure 1. nRF Connect Programmer default view at startup
nRF Connect Programmer main window

This main window is composed of the navigation bar and the smaller windows, which are described in the following sections.

Navigation bar

In the navigation bar at the top, you can access the menu, select a device, and see the connection status of the selected device.

Click the three-dash button in the top-left corner to open the menu through which you can launch another app, create a system report, or view information about the Programmer app.

Once you connect a device to the system, it becomes visible and available when you click on the Select device drop-down list. You can choose a device from the list of connected devices to perform further actions on the device such as programming.

The status indicator to the right of the Select device drop-down list shows the connection status of the selected device. The indicator is green when the Programmer app has established a connection to the device.

Device Memory Layout and File Memory Layout

In the Device Memory Layout window, you can see the memory sections for the device selected by using the Select device option in the navigation bar.

The File Memory Layout window displays the memory layout for files added into the Programmer app with the Add HEX file option. Once added, these files can be programmed onto the device.

Both windows use graphs that display the different sections in the memory with different colors.
Figure 2. Memory layout section colors
Breakdown of colors of memory sections

Device

When you select a device, you have the following actions available in the Device section:
  • Erase all clears the written memory on the device.
  • Read reads and displays the written memory in the Device Memory Layout.
    • You can select the Auto read memory field to automatically read the memory layout of the device and display it in the Device Memory Layout.
    • In the Device Memory Layout, you can read the name, address range, and size of a memory section by hovering the mouse cursor over one of the memory sections. This option is possible only after loading a memory layout.
      Figure 3. Memory section details
      Memory section after selecting a device
    • Additionally, after you read the memory, Save as file allows you to save the memory as a HEX file.
  • Erase & write clears the written memory and programs the files added to the File Memory Layout.
  • Reset resets the device.
  • Write programs the files added to the File Memory Layout.

File

In the File section, you can add files to the File Memory Layout graphic, reload, and remove them.

When adding files with the Add HEX file button, you can select the files either from the drop-down list of previous files or by browsing to the file destination.

Cellular Modem

You can use the Programmer app to update the nRF9160 modem firmware on all kits with the nRF9160 SiP. To do so, click Update modem and select the zip file that contains the new modem firmware.

Log

Each time you open the Programmer app, a new session log file is created in the Log folder at <user folder>/AppData/Roaming/nrfconnect/pc-nrfconnect-programmer/logs. The Log window allows you to view the most important log events that are saved to these log files. The events are tagged with a timestamp.

This window contains the following buttons in its top right corner:
  • Open log file opens the detailed log file, which is useful for troubleshooting.
  • Clear log erases all the information in the Log window. The contents of the log file are not affected.
  • Scroll automatically toggles automatic scrolling of the Log window as new lines appear.