npm

Bring the best of OSS JavaScript development to your projects with npm Orgs - private packages & team management tools.Learn more »

pc-nrfconnect-rssi

1.1.0 • Public • Published

nRF Connect RSSI Viewer

Build Status

Simple app for nRF Connect that shows a visualization of RSSI data. The app shows dBm per frequency in the 2400-2480 MHz range, and allows the user to tweak settings like sweep delay and animation duration. The app can be installed from the Add/remove apps screen in nRF Connect.

The following devices are supported:

  • PCA10040 nRF52832 Development Kit
  • PCA10059 nRF52840 Dongle

screenshot

Background

While the RSSI Viewer is a useful tool in itself, the main purpose behind it is to demonstrate how to implement apps for nRF Connect. In addition to the RSSI Viewer, app developers can check out the boilerplate app and documentation for creating apps.

Implementation

Firmware

The app comes with firmwares for the supported devices that sends RSSI data over serial port. The source code for these firmwares can be found in fw/src, and are included as hex files in fw/. When selecting a device, the app will program the chip with a corresponding hex file (unless the firmware has not already been programmed).

The serial port communication from the app to the firmware is simply a few ASCII commands for starting, stopping, and adjusting settings. From the firmware to the app there is a binary flow of 3 bytes: [0xff, channel_number, rssi].

UI components and actions

The RSSI data is visualized in the MainView by a Chart component that is based on chart.js. In the SidePanel there is a ControlPanel component that allows the user to tweak some settings. Serial port communication and programming is done by the actions. The components and actions are tied together by index.jsx.

Building from source

Dependencies

To build the app you will need to install the following tools:

  • Node.js (>=6.9)
  • npm (>=5.6.0) / yarn (>=1.4.0)

Clone the repository

Open a terminal, go to the following directory, and clone the repository:

  • Linux/macOS: cd $HOME/.nrfconnect-apps/local
  • Windows: cd %USERPROFILE%/.nrfconnect-apps/local

Alternatively, clone the repository in a different directory and symlink it into .nrfconnect-apps/local.

Building

After cloning the repository, install the required dependencies:

npm install

Then build the app:

npm run dev

If everything was successful, you should now be able to launch the app in nRF Connect.

Keywords

none

install

npm i pc-nrfconnect-rssi

Downloadsweekly downloads

2

version

1.1.0

license

SEE LICENSE IN LICENSE

homepage

github.com

repository

Gitgithub

last publish

collaborators

  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
  • avatar
Report a vulnerability