Skip to content

Commit

Permalink
doc: update docs for v0.1.4 release
Browse files Browse the repository at this point in the history
Updated text and screenshots for the release.
Updated README.md.
NCD-722.

Signed-off-by: Grzegorz Ferenc <[email protected]>
  • Loading branch information
greg-fer committed Feb 9, 2024
1 parent ada3d7d commit d8de64f
Show file tree
Hide file tree
Showing 9 changed files with 40 additions and 27 deletions.
28 changes: 21 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,34 @@
# nRF Connect Boilerplate
# nRF Connect Board Configurator

[![Build Status](https://dev.azure.com/NordicSemiconductor/Wayland/_apis/build/status/pc-nrfconnect-boilerplate?branchName=master)](https://dev.azure.com/NordicSemiconductor/Wayland/_build/latest?definitionId=10&branchName=master)
[![License](https://img.shields.io/badge/license-Modified%20BSD%20License-blue.svg)](LICENSE)

_nRF Connect Boilerplate_ provides a starting point for developing apps that can
be launched by
[nRF Connect for Desktop](https://github.com/NordicSemiconductor/pc-nrfconnect-launcher).
nRF Connect Board Configurator is an application that you can use to update the configuration of the board controller on Nordic Development kits.
The board controller is the firmware running on the Interface MCU that controls the behavior of the DK.

**Note:** The current Board Configurator version is experimental. This means that the application is incomplete in functionality and verification and will change in the future.

![screenshot](resources/screenshot.gif)

## Installation

nRF Connect Board Configurator is installed from nRF Connect from Desktop. For detailed
steps, see
[Installing nRF Connect for Desktop apps](https://docs.nordicsemi.com/bundle/nrf-connect-desktop/page/installing_apps.html)
in the nRF Connect from Desktop documentation.

## Documentation

Read the
[nRF Connect Board Configurator](https://docs.nordicsemi.com/bundle/nrf-connect-board-configurator/page/index.html)
official documentation.

## Development

See the
[app development](https://nordicsemiconductor.github.io/pc-nrfconnect-docs/)
pages for details on how to develop apps for the nRF Connect for Desktop
framework and specifically the description
[how to create a new app project](https://nordicsemiconductor.github.io/pc-nrfconnect-docs/create_new_app),
to understand how you may use this project.
framework.

## Feedback

Expand Down
3 changes: 2 additions & 1 deletion doc/docs/index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
# nRF Connect Board Configurator

nRF Connect Board Configurator is an application that you can use to update the board configuration on Nordic Development kits.
nRF Connect Board Configurator is an application that you can use to update the configuration of the board controller on Nordic Development kits.
The board controller is the firmware running on the Interface MCU that controls the behavior of the DK.

!!! note "Note"
The current Board Configurator version is experimental. This means that the application is incomplete in functionality and verification and will change in the future.
Expand Down
15 changes: 1 addition & 14 deletions doc/docs/installing.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,3 @@
# Installing Board Configurator app

Board Configurator is installed as an app for **nRF Connect for Desktop**. Before you can install the app, you must download and install [nRF Connect for Desktop](https://www.nordicsemi.com/Software-and-Tools/Development-Tools/nRF-Connect-for-desktop) (version 4.3.0 or later).

To install the app:

1. Open nRF Connect for Desktop.
2. Find the Board Configurator app in the list and click **Install**.

Once the app is installed, you can launch it by clicking **Open**.

For easy access, you can create a desktop shortcut by clicking the arrow-down button and selecting **Create shortcut**.

If a new version of the app becomes available, an **Update** button is displayed next to the **Open** button. Click this button to install the latest version.

To uninstall the app, click the arrow-down button and select **Uninstall**.
For installation instructions, see [Installing nRF Connect for Desktop apps](https://docs.nordicsemi.com/bundle/nrf-connect-desktop/page/installing_apps.html) in the nRF Connect for Desktop documentation.
6 changes: 5 additions & 1 deletion doc/docs/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ Opens the drop-down with the list of devices connected to the computer. You can

When you select a device, the following actions become available in the side panel:

- **Write config** - Writes the selected configurations to the development kit.
- **Write config** - Writes the selected configurations to the development kit by overwriting the defaults from the board definition file.

## Configuration tab

Expand All @@ -31,6 +31,10 @@ The Log panel allows you to view the most important log events, tagged with a ti
- To hide or display the Log panel in the user interface, use **Show Log**.
- To freeze Log panel scrolling, use **Autoscroll Log**.

## Feedback tab

The Feedback tab lets you send feedback about nRF Connect Cellular Monitor application to the application development team.

## About tab

You can view application information, restore defaults, access source code, and documentation. You also can find information on the selected device, access support tools, and enable verbose logging.
1 change: 1 addition & 0 deletions doc/docs/revision_history.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,5 @@

| Date | Description |
|------------|---------------|
| 2024-02-09 | Updated documentation for the experimental [v0.1.4](https://github.com/NordicSemiconductor/pc-nrfconnect-board-configurator/blob/main/Changelog.md) of the application. |
| 2024-01-15 | First release, for the experimental [v0.1.0](https://github.com/NordicSemiconductor/pc-nrfconnect-board-configurator/blob/main/Changelog.md) of the application. |
Binary file modified doc/docs/screenshots/board_configurator_connected.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/docs/screenshots/board_configurator_overview.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 10 additions & 4 deletions doc/docs/updating.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,18 @@
# Updating the board configuration

In Board Configurator, you can update the configuration of a supported Nordic development kit.
In Board Configurator, you can update the configuration of the board controller on a [supported Nordic Semiconductor Development Kit](index.md#supported-devices).

To update the configuration of a development kit, complete the following steps:

1. Open nRF Connect for Desktop and open nRF Connect Board Configurator.
1. Connect a development kit to the computer with a USB cable and turn it on.
1. Click [**Select Device**](./overview.md#select-device) and select the device from the drop-down list.</br>
The button text changes to the name and serial number of the selected device and the configuration options for the selected device will appear, indicating that the device is connected.
1. Change the setting of the wanted options in the [**Configuration**](./overview.md#configuration-tab) tab.
1. Click [**Write config**](./overview.md#actions) to upload the config to the device.
The application reads the Interface MCU configuration on the board.
The button text changes to the name and serial number of the selected device and the configuration options for the selected device appear, indicating that the device is connected.

![Example of the configuration options](./screenshots/board_configurator_connected.png "Example of the configuration options")

1. Configure the settings in the [**Configuration**](./overview.md#configuration-tab) tab.
1. Click [**Write config**](./overview.md#actions) to upload the config to the device.</br>
The application overwrites the default board controller configuration with the updated settings.
The **Write config** button is greyed out when the upload is ongoing.
Binary file added resources/screenshot.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit d8de64f

Please sign in to comment.