@@ -18,12 +18,14 @@ This is a basic Mbed OS project for [micro:bit V2](https://microbit.org/new-micr
1818
1919## Requirements
2020
21- - git
21+ - [ Git] ( https://git-scm.com/downloads )
22+ - [ Mercurial] ( https://www.mercurial-scm.org/downloads )
2223- [ Arm GCC] ( https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm/downloads )
2324 - v7.3.1 is the oldest and v10.2.1 the last tested versions
2425- Python 3
26+ - Tested with Python 3.7.12
2527- [ Mbed CLI] ( https://github.com/ARMmbed/mbed-cli )
26- - v1.10.2 is last tested version
28+ - v1.10.2, and v1.10.5 are the last tested versions
2729 - Can be installed using one of the methods from the official documentation:
2830 https://os.mbed.com/docs/mbed-os/v6.15/build-tools/install-and-set-up.html
2931 - The installers are outdated and not recommended
@@ -34,31 +36,36 @@ This is a basic Mbed OS project for [micro:bit V2](https://microbit.org/new-micr
3436
3537### Available Targets
3638
37- As there are multiple revisions of the nRF52 board we are using multiple mbed
38- targets .
39+ This project contains multiple Mbed OS "targets" for different versions of the
40+ micro : bit V2 board and for the Nordic nRF52833 DK development board .
3941
40- - ` nrf52833_dk ` : For the Nordic nRF52833 DK board (useful for testing)
41- - ` nrf52_microbit_v1_43 ` : For the micro: bit v1.43.4 (nRF52833)
42- - ` nrf52_microbit_v1_44 ` /` nrf52_microbit_v1_45 ` / ` nrf52_microbit_v1_46 ` /
43- ` nrf52_microbit_v1_47 ` : These board versions do not really need a new target
44- and are the same as the ` nrf52_microbit_v1_43 `
45- - ` nrf52_microbit_v2 ` : This is essentially the same as ` nrf52_microbit_v1_43 ` ,
46- but since the board is currently only manufactured in the ` S ` variant, only
47- contains the LSM motion sensor (no FXOS), so it's useful to use this target
48- name to be able to do conditional compilation.
42+ - ` nrf52_microbit_v2 ` : Target for all production micro: bit V2 board versions.
43+ - ` nrf52833_dk ` : For the Nordic nRF52833 DK board (useful for testing).
4944
50- The version of the board can be seen on the silkscreen at the back, near the
51- right side of the edge connector.
45+ Other targets are available for micro: bit V2 prototype boards, and their
46+ names can be found in the [ mbed_app.json] ( mbed_app.json ) file.
47+ These are essentially the same as the ` nrf52_microbit_v2 ` target, but for code
48+ to support multiple boards it is useful to have different target names to be
49+ able to do conditional compilation of pins, I2C addresses, etc, as shown in the
50+ [ sensors.cpp example] ( examples/sensors.cpp ) code.
5251
53- The branch ` mbedos-softdevice ` contains older targets.
52+ Even older prototype targets can be found in the ` mbedos-softdevice ` branch.
53+
54+ The version of the micro: bit V2 board can be seen on the silkscreen at the
55+ back, near the right side of the edge connector.
5456
5557#### Interface MCU
5658
5759The micro: bit V2.2 contains an nRF52 microcontroller as the
5860[ Interface MCU] ( https://tech.microbit.org/software/daplink-interface/ ) and Mbed
59- OS targets has been created
61+ OS targets has been created to be able to target these Interface MCUs.
62+
63+ - ` nrf52_microbit_v2_if_820 ` : Target for micro: bit V2.2 nRF52820 Interface MCU.
64+ - ` nrf52_microbit_v2_if_833 ` : Fof a micro: bit V2.2 nRF52833 Interface MCU.
65+ This target is configured to be identical to the nrf52820 builds, with the
66+ only difference being some pin assignments.
6067
61- ### Initialise
68+ ### Initialise the Project
6269
6370Note that for the ` mbed target ... ` line you should select the right target
6471for your board.
0 commit comments