Current git repository status:
Ruuvi Firmware version 3.
Built with Nordic SDK 15. Uses ruuvi.boards.c, ruuvi.drivers.c, ruuvi.endpoints.c, ruuvi.libraries.c and external repositories as submodules.
Release 3.31.1 is in production stage, no breaking changes are expected.
Subsequent pre-release versions may be available.
- gcc-arm-none-eabi-7-2018-q2-update Check that nRF5_SDK_15.3.0_59ac345/components/toolchain/gcc Makefile.posix or Makefile.windows points to it.
- git
- python 3.7 or later and pip package manager
- Nordic Command Line Tools
Nordic mergehex merge 2 or 3 (not 4) .hex files into one.
Nordic nrfutil Creates DeviceFirmwareUpdate zip file from hex - Nordic nRFconnect for your desktop or phone to upload DFU to the Ruuvi and a means to transfer the DFU zip file to your phone.
- A computer or phone with a bluetooth radio to receive advertisments from the ruuvi.
See Dealing with the data - On Mac OS XCode
- Ruuvi Dev kit board and a USB power & data cable.
- Or another SWD programmer and a cable matching your target board.
- Segger j-link
Download Nordic SDK15.3 (.8GB) and install it at the project root. If you're working on multiple nRF projects, use symbolic linking to have only one copy.
Run git submodule sync --recursive and git submodule update --init --recursive to update the modules from the master repository .
Customize things like Advertising Interval or Interval between history log samples or Motion Sensetivity.
- Review application_config/app_config.h to locate configurable items.
- Edit application_config/application_mode_debug.h (This filename is used in application_modes.h)
- Be sure to change APP_FW_VARIANT.
Use coding style consistant with BARR-C:2018.
Coding style is enforced with Artistic Style.
See .astylerc for non-default options (for example max-code-length=90).
Run make astyle.
Segger Embedded Studio is set up by installing nRF Connect for Desktop and following Getting Started instructions.
File -> Open Solution -> ruuvi.firmware.c.emProject.
Each of the target boards is in their own project.
In the Project Explorer select the correct project according to the appropriate tag name.
Navigate to Build -> Build <project name>.
Select the Build Configuration: Debug, Long Life or Release.
- nRF52 DevKit and RuuviTag Development Shield.
- nRF52 DevKit and TC2030-CTX-NL 6-pin Cable
Navigate to Debug -> Go.
This will flash the firmware and start the debugger.
ARMGCC is used for Jenkins builds
You can make the project and a single variant by runnning "make variantName" (for example "make ruuvitag_b" at top level of the repository This way you can be certain to have a repeatable build process.
When building binaries for distribution, use the provided 'Makefile' script.
The Makefile uses the tag name of current git commit for filenames and version number.
Tags should be valid semantic versions, starting with v and possibly having pre-release information such as -rc2.
Do not add build information such as +TestFW. If you have tagged the version as v3.99.1 the files will be named $BOARD_armgcc_ruuvifw_$VARIANT_v3.99.1_$TYPE.extension. For example ruuvitag_b_armgcc_ruuvifw_default_v3.29.3-rc1_full.hex.
Connect your board with either:
- nRF52 DevKit and RuuviTag Development Shield.
- nRF52 DevKit and TC2030-CTX-NL 6-pin Cable
Navigate to ruuvi.firmware.c/src/targets/<board name>/armgcc.
Run make to compile the application.
Run ./package.sh to generate the complete firmware HEX and ZIP files.
To flash the tag, run
nrfjprog --eraseall # including previous bootloader nrfjprog --program ruuvitag_b_armgcc_ruuvifw_v3.30.0-RC5_app.hex --verify --fast --reset
The code can be checked with Sonarcloud for some common errors, style issues and potential problems. Here is a link to generated report.
Travis pushes the results to SonarCloud.IO. SonarCloud uses access token which is private to Ruuvi. You need to fork the project and setup the SonarCloud under your own account to run Sonar Scan on your own code.
Unit tests are implemented with Ceedling. Run the tests with
ceedling test:all
Ceedling can also generate Gcov reports with ceedling gcov:all utils:gcov.
The report can be found under build/artifacts/gcov.
Travis will fail the build if unit test fails and Gcov results will get pushed to SonarCloud.
Using http://github create a branch where the name is a very short description of the changes.
- Do not use something like "Fixed movement threshold", rather use:
- "Changed movement threshold from 0.064F to 0.128 to make it less sensative"
Please let us know your thoughts on the direction and structure of the project. Does the project help you to understand how to build code for the RuuviTag?
Is the structure of the project sensible to you?
If you want to assist in the project maintenance by fixing some issues doxygen.error is a good place to look for code which needs better commenting. Project badges at the top of the readme point to issues which range from trivial clarifications to complex refactoring.
If you want to add new features, please discuss the feature first at the Forum. Then create ceedling unit tests for the functionality. Once the functionality is agreed and testable in can be integrated into project.
Ruuvi code is BSD-3 licensed. Submodules and external dependencies have their own licenses, which are BSD-compatible.
Document is generated with Doxygen. Run make doxygen to generate the docs locally, or
browse to Travis built docs