Skip to content

Commit db55b4e

Browse files
Squashed 'docs/' changes from ae437c7..cd87b61 (#100)
cd87b61 Merge branch 'master' of https://github.com/microbit-foundation/dev-docs 3229f78 update feature availibility 9cf9964 Update latest-revision-main.md (#209) a7eb1ae Update edgeconnector.md: Fix badly rendered "V2" (#208) 6afa1e6 Correct spelling mistake (#210) 1af07f4 update CODAL info c72e636 Brand tidy up: v1 v2 > V1 V2 3f33b0f add audio expression api 8ac53a3 update BLE profile roles 38464b4 Update Soft Device SD140 > SD113 (#198) 0f1b15d add new brand guidelines info 3d3c6ed fix links 8260131 fix links 504c6df remove link to uhex spec as it 404s bee772f remove link to python mailing list ce75bb4 remove duplicate MakeCode 21c6a16 update table 200mA > 190mA 9cffab0 Update info on MakeCode blocks cc01c0f Latest updates for MakeCode and DAPLink (#193) 18ff8f7 Update hex-format.md: add missing space (#190) af73c3c Update apps-and-examples.md: add missing space (#189) 1f7d600 Spelling mistake (#186) b24c88f Re-phrasing bluetooth section (#181) 4007b76 Rephrase "lozenge" to "rounded rectangular" (#180) f8ca9aa Merge pull request #179 from Gadgetoid/spelling afe3441 Spelling and consistency tweaks 7b0e132 Merge pull request #175 from Gadgetoid/doc-consistency ac8b131 Consistent use of whitespace and Markdown formatting 670d1f1 Remove hard linebreaks and trailing whitespace (#174) 6be457a update iOS beta instructions (#173) 1b2f2ec Update DAPLink error message (#171) 955cf1a spelling git-subtree-dir: docs git-subtree-split: cd87b61
1 parent 83287af commit db55b4e

18 files changed

+64
-62
lines changed

accessories/making-accessories.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ There are limitations to the current that can be drawn from the micro:bit, and a
2222

2323
### V2 revision
2424

25-
The edge connector on the <span class="V2">V2</span> board revision is backwards compatible with the <span class="v1">v1</span> edge connector, but has additional dedicated pins.
25+
The edge connector on the <span class="V2">V2</span> board revision is backwards compatible with the <span class="v1">V1</span> edge connector, but has additional dedicated pins.
2626

2727
- Details of the [edge connector and pinout](/hardware/edgeconnector)
2828
- Details about [powering things from the board](/hardware/powersupply)

bluetooth/index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ The micro:bit processor has an on-board [Bluetooth](http://blog.bluetooth.com/a-
1515

1616
## Bluetooth software stack
1717

18-
<span class="v1">v1</span> Nordic Semiconductor [Soft Device S110](https://www.nordicsemi.com/Software-and-Tools/Software/S110)
18+
<span class="v1">V1</span> Nordic Semiconductor [Soft Device S110](https://www.nordicsemi.com/Software-and-Tools/Software/S110)
1919
<span class="v2">V2</span> Nordic Semiconductor [Soft Device S113](https://www.nordicsemi.com/Software-and-tools/Software/S113)
2020

2121
Using Bluetooth, you can connect to other devices and send and receive data from and to the micro:bit.

bluetooth/profile.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ There are also some example programs in the [microbit-samples](https://github.co
3434

3535
- [bluetooth-uart](https://github.com/lancaster-university/microbit-samples/tree/master/source/examples/bluetooth-uart)
3636

37-
The micro:bit has a <span class="v2">v2</span>Bluetooth 5.0/<span class="v1">v1</span>Bluetooth 4.1 stack with Bluetooth Low Energy (BLE) and supports the <span class="v1">v1</span>[GAP Peripheral Role](https://bluetooth-developer.blogspot.com/2016/07/microbit-and-bluetooth-roles.html) and <span class="v2">v2</span> GAP Peripheral and Central device roles.
37+
The micro:bit has a <span class="v2">V2</span>Bluetooth 5.0/<span class="v1">V1</span>Bluetooth 4.1 stack with Bluetooth Low Energy (BLE) and supports the <span class="v1">V1</span>[GAP Peripheral Role](https://bluetooth-developer.blogspot.com/2016/07/microbit-and-bluetooth-roles.html) and <span class="v2">V2</span> GAP Peripheral and Central device roles.
3838

3939
It operates in the ISM (Industrial Scientific Medical) band, as per all Bluetooth devices. This starts at **2.4GHz and ends at 2.41GHz**. BLE divides the frequency band into 50 x 2MHz bands of which 40 are used. These are called **channels** and numbered **0 to 39**. Channels 37, 38 and 39 are used for "advertising".
4040

hardware/1-5-revision.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -127,7 +127,7 @@ A software algorithm in the standard runtime uses the on-board accelerometer to
127127
The compass must be calibrated before use, and the calibration process is automatically initiated by the runtime software.
128128
This device is connected to the application processor via the I2C bus.
129129

130-
The v1.5 micro:bit has a footprint for two different motion sensors: one made by ST (the LSM303AGR) and one by NXP (FXOS8700CQ). The micro:bit DAL supports both of these sensors, detecting them at runtime. To date, all v1.5 boards have been manufactured with the LSM303AGR. If we were to move to the NXP part, a round of testing would be required and we would notify the [DAL and Devices mailing list.](http://eepurl.com/dyRx-v)
130+
The V1.5 micro:bit has a footprint for two different motion sensors: one made by ST (the LSM303AGR) and one by NXP (FXOS8700CQ). The micro:bit DAL supports both of these sensors, detecting them at runtime. To date, all V1.5 boards have been manufactured with the LSM303AGR. If we were to move to the NXP part, a round of testing would be required and we would notify the [DAL and Devices mailing list.](http://eepurl.com/dyRx-v)
131131

132132
| item | details
133133
| --- | ---

hardware/edgeconnector.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Only the pins on the front are connected to signals. The back rings are connecte
3030
The diagrams below show the assignation of the micro:bit pins. On the <span class="v2">V2</span> board revision
3131
Pin 9 is no longer jointly shared with the LED display, but Pin 8 and Pin 9 can be configured for NFC (though this is disabled by default).
3232

33-
| V2 | v1
33+
| V2 | V1
3434
| ---- | ----
3535
| ![edge connector V2](/docs/hardware/assets/edge-connector-2.svg) | ![edge connector v1](/docs/hardware/assets/edge_connector.svg)
3636

@@ -40,7 +40,7 @@ Pin 9 is no longer jointly shared with the LED display, but Pin 8 and Pin 9 can
4040

4141
### Pins and Signals
4242

43-
[V2](#pins-and-signals){: #V2-button .btn.sm-btn .variation} [v1](#pins-and-signals){: #v1-button .btn.sm-btn}
43+
[V2](#pins-and-signals){: #V2-button .btn.sm-btn .variation} [V1](#pins-and-signals){: #v1-button .btn.sm-btn}
4444

4545
This table shows various data about each of the pins on the micro:bit edge connector.
4646

@@ -219,7 +219,7 @@ NOTE 2: A common way that the maximum pin voltages can be exceeded, is to attach
219219

220220
NOTE 3: The pin marked 'ACCESSIBILITY' is used to enable/disable an on-board accessibility mode, and should not be used for anything else (even though it can be used as a GPIO for testing). Future versions of the official micro:bit editors may remove the ability to write to this pin.
221221

222-
NOTE 4: The BBC suggest in the safety guide, that the maximum current you can draw from the whole edge connector at any one time is <span class="v1">v1</span>90mA. This is set based on the 30mA budget for on-board peripherals, and the fact that the on-board regulator of the KL26 when powered from USB is rated at a maximum of 120mA. On the latest board revision the maximum current is <span class="V2">V2</span>270mA, though it is possible that the on-board mic and speaker can draw more current, so this value is TBC.
222+
NOTE 4: The BBC suggest in the safety guide, that the maximum current you can draw from the whole edge connector at any one time is <span class="v1">V1</span>90mA. This is set based on the 30mA budget for on-board peripherals, and the fact that the on-board regulator of the KL26 when powered from USB is rated at a maximum of 120mA. On the latest board revision the maximum current is <span class="v2">V2</span>270mA, though it is possible that the on-board mic and speaker can draw more current, so this value is TBC.
223223

224224
### NRF52
225225

hardware/i2c-shared.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ lang: en
1313

1414
The motion sensors on the board are on the same I2C bus as the edge connector I2C pins. This means that if you have an accessory that uses I2C on this bus, you need to check it won’t clash with any of the possible on-board sensors. The [latest board revision does not share the I2C bus](../i2c/).
1515

16-
The v1.5 micro:bit has a footprint for two different motion sensors: one made by ST (the LSM303AGR) and one by NXP (FXOS8700CQ). The micro:bit DAL supports both of these sensors, detecting them at runtime. To date, all v1.5 boards have been manufactured with the LSM303AGR, however we may switch to the NXP part. Before doing so we will perform a round of testing and notify the [DAL and Devices mailing list.](http://eepurl.com/dyRx-v)
16+
The V1.5 micro:bit has a footprint for two different motion sensors: one made by ST (the LSM303AGR) and one by NXP (FXOS8700CQ). The micro:bit DAL supports both of these sensors, detecting them at runtime. To date, all V1.5 boards have been manufactured with the LSM303AGR, however we may switch to the NXP part. Before doing so we will perform a round of testing and notify the [DAL and Devices mailing list.](http://eepurl.com/dyRx-v)
1717

1818
### I2C block diagram
1919

@@ -23,9 +23,9 @@ The v1.5 micro:bit has a footprint for two different motion sensors: one made by
2323

2424
| | accelerometer | magnetometer (compass) |
2525
|---------------------|------------------|------------------------|
26-
| micro:bit v1.3 (MMA8653+MAG3110) | 0x1D (0x3A/0x3B) | 0x0E (0x1C/0x1D) |
27-
| micro:bit v1.5 variant 1 (LSM303AGR) | 0x19 (0x32/0x33) | 0x1E (0x3C/0x3D) |
28-
| micro:bit v1.5 variant 2 (FXOS8700CQ) | 0x1F (0x3E/0x3F) | 0x1F (0x3E/0x3F) |
26+
| micro:bit V1.3 (MMA8653+MAG3110) | 0x1D (0x3A/0x3B) | 0x0E (0x1C/0x1D) |
27+
| micro:bit V1.5 variant 1 (LSM303AGR) | 0x19 (0x32/0x33) | 0x1E (0x3C/0x3D) |
28+
| micro:bit V1.5 variant 2 (FXOS8700CQ) | 0x1F (0x3E/0x3F) | 0x1F (0x3E/0x3F) |
2929

3030
Overall, this means 0x1D, 0x0E (from v1.3), 0x1F and 0x19 (for the revision) are reserved for on-board use.
3131

hardware/power-consumption.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ lang: en
1111

1212
## Power modes
1313

14-
The micro:bit v2 <span class="v2">V2</span> board revision has a range of modes that enable us to conserve power, for example when the board is not being used or when it is powered by battery pack.
14+
The micro:bit V2 <span class="v2">V2</span> board revision has a range of modes that enable us to conserve power, for example when the board is not being used or when it is powered by battery pack.
1515

1616
### Awake
1717

@@ -35,6 +35,6 @@ Inserting a USB power lead will also wake the device.
3535

3636
## LED display
3737

38-
The LED display on the <span class="v2">V2</span> board revision is also brighter than previous revisions, so when using at full brightness you will notice faster battery drain than an equivalent program on a <span class="v1">v1</span> board.
38+
The LED display on the <span class="v2">V2</span> board revision is also brighter than previous revisions, so when using at full brightness you will notice faster battery drain than an equivalent program on a <span class="v1">V1</span> board.
3939

4040
See our tips on [prolonging battery life](https://support.microbit.org/en/support/solutions/articles/19000087231-prolonging-battery-life)

hardware/powersupply.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -22,9 +22,9 @@ Power from the micro:bit can be provided by the 3V and GND pins to small externa
2222

2323
It's is important to stay within the design parameters of the board:
2424

25-
- When powered from USB, the on-board interface chip (KL26<span class="v1">v1</span>/KL27<span class="v2">V2</span>) uses its on-chip regulator to provide power, and this chip is rated at a maximum of 120mA.
25+
- When powered from USB, the on-board interface chip (KL26<span class="v1">V1</span>/KL27<span class="v2">V2</span>) uses its on-chip regulator to provide power, and this chip is rated at a maximum of 120mA.
2626

27-
- The on-board current budget will vary depending on the use of the display, the Bluetooth, microphone, speaker and other peripherals. You should allow a worst case budget of 30mA for when all on-board peripherals are in use, leaving <span class="v1">v1</span>90mA/<span class="v2">V2</span>270mA for circuits plugged into the edge connector.
27+
- The on-board current budget will vary depending on the use of the display, the Bluetooth, microphone, speaker and other peripherals. You should allow a worst case budget of 30mA for when all on-board peripherals are in use, leaving <span class="v1">V1</span>90mA/<span class="v2">V2</span>270mA for circuits plugged into the edge connector.
2828

2929
- When powered from a battery, the KL chip is not powered up and the USB Indicator LED will not light up.
3030

@@ -34,7 +34,7 @@ It's is important to stay within the design parameters of the board:
3434

3535
As taken from each of the chip datasheets, it can be seen that different devices have slightly different operating voltage ranges and absolute maximum voltages. Manufacturers state the operating voltage range as well as the absolute maximum tolerable by the device. You should never exceed the operating voltage range of any of the devices.
3636

37-
### v1 revision
37+
### V1 revision
3838

3939
| Device | min | max | absolutemax
4040
|------------|-------|------|------------
@@ -62,9 +62,9 @@ This table implies an operating voltage range of the micro:bit device as a whole
6262

6363
<!-- TODO: Update these paragraphs to detail that 270mA is TBC budget for V2 -->
6464

65-
When powered from USB, the KL26 <span class="v1">v1</span> interface chip's on-board regulator is used to provide 3.3V to the rest of the board. The latest revision <span class="v2">V2</span> has a seperate regulator on the board.
65+
When powered from USB, the KL26 <span class="v1">V1</span> interface chip's on-board regulator is used to provide 3.3V to the rest of the board. The latest revision <span class="v2">V2</span> has a seperate regulator on the board.
6666

67-
The [KL26 datasheet](http://www.nxp.com/docs/pcn_attachments/16440_KL26P64M48SF5_Rev.4.pdf)<span class="v1">v1</span> section 3.8.2, Table 30. "USB VREG electrical specifications" indicates the maximum current from the regulated supply is 120mA. Some of this current is required to run on-board devices, such as the KL26 itself, the nRF application processor, the motion sensor, and the LED display. When Bluetooth is enabled, the current consumption of the nRF increases slightly. You should budget your current requirements for anything you attach to the micro:bit <span class="v1">v1</span> to not exceed about
67+
The [KL26 datasheet](http://www.nxp.com/docs/pcn_attachments/16440_KL26P64M48SF5_Rev.4.pdf)<span class="v1">V1</span> section 3.8.2, Table 30. "USB VREG electrical specifications" indicates the maximum current from the regulated supply is 120mA. Some of this current is required to run on-board devices, such as the KL26 itself, the nRF application processor, the motion sensor, and the LED display. When Bluetooth is enabled, the current consumption of the nRF increases slightly. You should budget your current requirements for anything you attach to the micro:bit <span class="v1">V1</span> to not exceed about
6868
90mA to give enough safe headroom for worst case with all on-board peripherals in use.
6969

7070
This means that if you require more than 90mA from the edge connector, (e.g. driving lots of NeoPixels or a small motor) these should have power supplied to them externally. You can back-power the micro:bit via its 3V pad, but please be sure to use a properly regulated supply and a protection diode, as explained below, so that your micro:bit always has a supply within the operating range of all the on-board peripherals and the supplies are not able to power each other.
@@ -95,7 +95,7 @@ When powering from the 3V ring or the rounded rectangular pads on the PCB, you s
9595

9696
2. If powered from a voltage source that could generate a voltage higher than the maximum operating voltage of the micro:bit, fit some form of over voltage protection, or proper regulation.
9797

98-
### Power Supply Architecture v1
98+
### Power Supply Architecture V1
9999

100100
The [schematic](/hardware/schematic/) shows the architecture of the power supply.
101101
Key points to note are that there are two BAT60A diodes, one from the 3.3V supply from the KL26/27 interface chip, and one from the external battery connector.

hardware/schematic.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,8 @@ If you're looking to make something of your own based on the micro:bit, you migh
2121

2222
## Schematics
2323

24-
- [v1.3](https://github.com/bbcmicrobit/hardware/blob/master/V1.3B/SCH_BBC-Microbit_V1.3B.pdf)
25-
- [v1.5](https://github.com/bbcmicrobit/hardware/blob/master/V1.5/SCH_BBC-Microbit_V1.5.PDF)
24+
- [V1.3](https://github.com/bbcmicrobit/hardware/blob/master/V1.3B/SCH_BBC-Microbit_V1.3B.pdf)
25+
- [V1.5](https://github.com/bbcmicrobit/hardware/blob/master/V1.5/SCH_BBC-Microbit_V1.5.PDF)
2626
- [V2 TBC](#)
2727

2828
## V2 pinmap
@@ -70,27 +70,27 @@ Below, we've extracted some useful details about the hardware that anyone implem
7070

7171
### LEDS
7272

73-
The LED matrix is physically laid out as a 5x5. On the <span class="v2">V2</span> board this is implemented as a 5x5 matrix, but in the <span class="v1">v1</span>, this is implemented as a scanned matrix of 9x3 (i.e. 9 columns by 3 rows). Row 2 Col 8, and Row 2 Col 9 are not used.
73+
The LED matrix is physically laid out as a 5x5. On the <span class="v2">V2</span> board this is implemented as a 5x5 matrix, but in the <span class="v1">V1</span>, this is implemented as a scanned matrix of 9x3 (i.e. 9 columns by 3 rows). Row 2 Col 8, and Row 2 Col 9 are not used.
7474

7575
The LED matrix is driven via a high-speed multiplex generated by application processor software.
7676
This software also uses the LED Row and Col pins to implement the light sensing feature, as such you may see a difference in sensitivity between board revisions.
7777
Some of the Columns appear on the edge connector, so if you want to use extra GPIO pins, you have to disable the display in software.
7878

7979
### Interface
8080

81-
The Interface sheet shows the KL26/<span class="v1">v1</span>KL27<span class="v2">v2</span> processor, which is an NXP microcontroller with an Arm processor, that implements the USB protocol for the USB connector. This provides a method for loading code onto the application processor, using a drag and drop interface.
81+
The Interface sheet shows the KL26/<span class="v1">V1</span>KL27<span class="v2">V2</span> processor, which is an NXP microcontroller with an Arm processor, that implements the USB protocol for the USB connector. This provides a method for loading code onto the application processor, using a drag and drop interface.
8282

8383
The USB protocol handler on this processor implements a Mass Storage Class device in order to offer the drag and drop code load interface. It also provides a Connected Device Class that allows a serial port interface to be used across the USB.
8484

85-
The interface processor also contains an on-board regulator that steps down the USB voltage to 3.3V suitable for powering the rest of the micro:bit, and you can draw 120mA<span class="v1">v1</span>/300mA<span class="v2">V2</span> from this processor regulator. A TVS device is fitted to suppress ESD spikes and out of range voltages that could be present on the USB connector.
85+
The interface processor also contains an on-board regulator that steps down the USB voltage to 3.3V suitable for powering the rest of the micro:bit, and you can draw 120mA<span class="v1">V1</span>/300mA<span class="v2">V2</span> from this processor regulator. A TVS device is fitted to suppress ESD spikes and out of range voltages that could be present on the USB connector.
8686

8787
This processor does not have any connection to the GPIO pins on the micro:bit.
8888

8989
### Sensors
9090

9191
There is one combined motion sensor IC on the micro:bit, that contains an accelerometer and a magnetometer. The accelerometer measures acceleration in 3 axes, and the magnetometer can be used as a compass, as well as a magnetic field detector.
9292

93-
The device is connected to the application processor [I2C bus](../i2c/), and for the <span class="v1">v1</span> revision this [I2C bus is also shared](../i2c-shared/) to two pins on the edge connector. I2C pull-up resistors are pre-fitted on the board.
93+
The device is connected to the application processor [I2C bus](../i2c/), and for the <span class="v1">V1</span> revision this [I2C bus is also shared](../i2c-shared/) to two pins on the edge connector. I2C pull-up resistors are pre-fitted on the board.
9494

9595
The magnetometer can generate one processor interrupt for the application processor, and the accelerometer can generate two different processor interrupts for the application processor.
9696

0 commit comments

Comments
 (0)