aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Phillips <david@yeah.nah.nz>2021-02-08 19:08:57 +1300
committerDavid Phillips <david@yeah.nah.nz>2021-02-08 19:08:57 +1300
commit01bb1bffb603461cf39ecf630f8817cfe1645263 (patch)
tree190fe16b4b3706a840cb20bf3dc1c67cb47f1a14
parent14f2f9c63ed49a135e662d476079ea6e840d173d (diff)
downloadaltimeter-01bb1bffb603461cf39ecf630f8817cfe1645263.tar.xz
Update README.md for unit testing and submodules
-rw-r--r--README.md23
1 files changed, 23 insertions, 0 deletions
diff --git a/README.md b/README.md
index 15a444b..76b77f7 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,20 @@
## Getting Started
+### Submoule checkout
+
+This repo uses the [Unity](http://www.throwtheswitch.org/unity) unit testing
+library, as well as Bosch's BMP3 Sensor API, which are included as submodules.
+You must therefore do a recursive clone when cloning this repo initially, e.g.:
+
+ git clone --recursive https://git.nah.nz/altimeter/
+
+or later come along and check out the submodules if you didn't perform a
+recursive clone initially:
+
+ git submodule init && git submodule update
+
+
### Dependencies
Bare minimum, you will need:
@@ -19,6 +33,15 @@ before flashing, you will need:
* qemu-avr
+### Test
+
+In order to build and run the unit tests without building ELFs or HEXs:
+
+ $ make test
+
+Otherwise, unit tests are always run as the final part of the `make all` recipe
+below and will fail the build if they do not pass.
+
### Build
$ make all