Skip to content

Commit aa81261

Browse files
committed
Purge linebreaks, more corrections
1 parent 5545958 commit aa81261

24 files changed

+258
-472
lines changed

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
# Microbit Developer Community Docs
44

5-
These docs form the content that is rendered into the [micro:bit Developer Commmunity site](http://tech.microbit.org)
5+
These docs form the content that is rendered into the [micro:bit Developer Community site](http://tech.microbit.org)
66

77
## Using these docs
88

accessories/making-accessories.md

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -22,25 +22,23 @@ to plug in and remove the board.
2222
There are limitations to the current that can be drawn from the micro:bit, and accessories must be designed carefully to ensure they do not damage the micro:bit, or that the micro:bit cannot damage them.
2323

2424
### V2 revision
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+
26+
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 includes additional dedicated pins.
2627

2728
* Details of the [edge connector and pinout](/hardware/edgeconnector)
2829
* Details about [powering things from the board](/hardware/powersupply)
2930

3031
## Battery Pads
3132

32-
There are two lozenge shaped pads on the back of the micro:bit. These allow you to connect a battery holder via a mechanism other than the JST connector.
33-
33+
There are two elongated pads on the back of the micro:bit. These allow you to connect a battery holder directly, instead of via the JST connector.
3434

35-
![Picture of the two lozenges](/docs/accessories/assets/making-accessories-d7c25.png)
35+
![Picture of the two elongated pads](/docs/accessories/assets/making-accessories-d7c25.png)
3636

3737
### V2 revision
38-
In the <span class="v2">V2</span> board revision, the 3V lozenge is connected to the 3V ring on the edge connector.
3938

40-
- If you make an accessory that uses the lozenges, it must be protected from reverse charging
41-
when the board is powered by USB, battery or edge connector.
42-
- You can now source power from the lozenges if you are making an accessory, as they are consistent with the power architecture of the edge connector.
43-
44-
Due to the addition of a speaker, current accessories that use the lozenges to power the micro:bit will no longer fit.
39+
In the <span class="v2">V2</span> board revision, the 3V lozenge is connected to the 3V ring on the edge connector.
4540

41+
- If you make an accessory that uses the elongated pads, it must be protected from reverse charging when the board is powered by USB, battery or edge connector.
42+
- You can now source power from the elongated pads if you are making an accessory. They are consistent with the power architecture of the edge connector.
4643

44+
Due to the addition of a speaker, current accessories that use the elongated pads to power the micro:bit will no longer fit.

bluetooth/apps-and-examples.md

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,9 @@ Below is a curated list of some Bluetooth applications you might like to read
1717
about and try for yourself with your micro:bit. Please contribute to this list
1818
if you know of any more. Many listed here are take from the [micro:bit Awesome list](https://github.com/carlosperate/awesome-microbit)
1919

20-
2120
## Applications, tools and examples
2221

23-
24-
[Android App](https://play.google.com/store/apps/details?id=com.samsung.microbit) faciliates [pairing and flashing programs to the micro:bit](https://support.microbit.org/en/support/solutions/articles/19000051025-pairing-and-flashing-code-via-bluetooth)
22+
[Android App](https://play.google.com/store/apps/details?id=com.samsung.microbit) facilitates [pairing and flashing programs to the micro:bit](https://support.microbit.org/en/support/solutions/articles/19000051025-pairing-and-flashing-code-via-bluetooth)
2523

2624
[iOS App](https://apps.apple.com/gb/app/micro-bit/id1092687276)faciliates [pairing and flashing programs to the micro:bit](https://support.microbit.org/en/support/solutions/articles/19000051025-pairing-and-flashing-code-via-bluetooth)
2725

@@ -33,15 +31,15 @@ if you know of any more. Many listed here are take from the [micro:bit Awesome l
3331

3432
[micro:bit Blue App for Android](https://github.com/microbit-foundation/microbit-blue)
3533

36-
[droidscript microbit](http://www.microbit-js.org/controlling-microbit-with-droidscript/)
34+
[droidscript micro:bit](http://www.microbit-js.org/controlling-microbit-with-droidscript/)
3735

3836
[droidscript plugin](http://www.microbit-js.org/installing-the-microbit-plugin-for-droidscript/)
3937

4038
[Kitronik Move](https://play.google.com/store/apps/details?id=com.kitronik.blemove) - Android app that presents a D-Pad interface to control a micro:bit over Bluetooth LE.
4139

42-
[Workbench](https://edu.workbencheducation.com/partners/microbit) is amulti-device coding canvas for block-based programming that connects with BLE devices via Chrome Web Bluetooth.
40+
[Workbench](https://edu.workbencheducation.com/partners/microbit) is a multi-device coding canvas for block-based programming that connects with BLE devices via Chrome Web Bluetooth.
4341

44-
[microBit.js](https://github.com/antefact/microBit.js) - JavaScript library to interact with BBC micro:bit using web bluetooth API.
42+
[microBit.js](https://github.com/antefact/microBit.js) - JavaScript library to interact with BBC micro:bit using web Bluetooth API.
4543

4644
[microbit-web-bluetooth](https://github.com/thegecko/microbit-web-bluetooth) - Web Bluetooth library implementing the micro:bit Bluetooth Profile.
4745

bluetooth/index.md

Lines changed: 12 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -8,44 +8,40 @@ permalink: /bluetooth/
88
ref: bluetooth
99
lang: en
1010
---
11+
1112
# Overview
12-
The micro:bit processor has an on board
13-
[Bluetooth](http://blog.bluetooth.com/a-developers-guide-to-bluetooth/) transceiver. This is combined with a PCB trace aerial and other minor components alongside a software stack that gives
14-
the micro:bit a certified and credible Bluetooth capability.
13+
14+
The micro:bit processor has an on board [Bluetooth](http://blog.bluetooth.com/a-developers-guide-to-bluetooth/) transceiver. This is combined with a PCB trace aerial and other minor components alongside a software stack that gives the micro:bit a certified and credible Bluetooth capability.
1515

1616
## Bluetooth software stack
17+
1718
<span class="v1">v1</span> Nordic Semiconductor [Soft Device S110](https://www.nordicsemi.com/Software-and-Tools/Software/S110)
1819
<span class="v2">V2</span> Nordic Semiconductor [Soft Device S140](https://www.nordicsemi.com/Software-and-tools/Software/S140) . We may switch to [S113](https://www.nordicsemi.com/Software-and-tools/Software/S113) and [S122](https://www.nordicsemi.com/Software-and-tools/Software/S122) at compile time to save flash memory (if this affects anything you are working on please [contact micro:bit support](https://support.microbit.org/en/support/tickets/new)).
1920

20-
21-
Using Bluetooth, you can connect to other devices and send and receive
22-
data from and to the micro:bit.
21+
Using Bluetooth, you can connect to other devices and send and receive data from and to the micro:bit.
2322

2423
## micro:bit Bluetooth Features
2524

26-
Bluetooth features available on the micro:bit are defined in a
27-
[Bluetooth profile](/bluetooth/profile). The micro:bit supports one, custom developed profile.
25+
Bluetooth features available on the micro:bit are defined in a [Bluetooth profile](/bluetooth/profile). The micro:bit supports one, custom-developed, profile.
2826

2927
## Bluetooth and the micro:bit software
3028

3129
The [DAL/C++](https://lancaster-university.github.io/microbit-docs/ble/profile/#reference-documentation) lists the adopted and custom features available within the profile.
32-
[MakeCode](https://makecode.microbit.org/reference/bluetooth) contains a set of blocks to make use
33-
of the various micro:bit services.
30+
[MakeCode](https://makecode.microbit.org/reference/bluetooth) contains a set of blocks to make use of the various micro:bit services.
3431

35-
The processor also has a number of non-bluetooth proprietary
36-
modes of operation, on which we build the micro:bit radio
37-
protocol. This only works between micro:bits and is what is defined as 'Micro:bit Radio' in the DAL
38-
and 'radio' in MakeCode and MicroPython, as well as Mbed C++.
32+
The processor also has a number of non-bluetooth proprietary modes of operation, on which we build the micro:bit radio protocol. This only works between micro:bits and is what is defined as 'Micro:bit Radio' in the DAL and 'radio' in MakeCode and MicroPython, as well as Mbed C++.
3933

4034
## Apps
4135

42-
[Android App](https://play.google.com/store/apps/details?id=com.samsung.microbit) faciliates [pairing and flashing programs to the micro:bit](https://support.microbit.org/en/support/solutions/articles/19000051025-pairing-and-flashing-code-via-bluetooth)
36+
[Android App](https://play.google.com/store/apps/details?id=com.samsung.microbit) facilitates [pairing and flashing programs to the micro:bit](https://support.microbit.org/en/support/solutions/articles/19000051025-pairing-and-flashing-code-via-bluetooth)
37+
4338
[iOS App](https://apps.apple.com/gb/app/micro-bit/id1092687276)faciliates [pairing and flashing programs to the micro:bit](https://support.microbit.org/en/support/solutions/articles/19000051025-pairing-and-flashing-code-via-bluetooth)
39+
4440
[Swift Playgrounds](https://github.com/microbit-foundation/microbit-swift-playgrounds) contains a Playground Book available in the Swift app and a micro:bit Swift API to develop further resources
41+
4542
Scratch.
4643

4744
## Links
4845

4946
[Bluetooth Specification](https://www.bluetooth.com/specifications/adopted-specifications)
5047

51-

bluetooth/profile.md

Lines changed: 8 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -11,13 +11,9 @@ lang: en
1111

1212
## Overview
1313

14-
The micro:bit supports Bluetooth via a single BBC micro:bit profile
15-
which was custom developed for the device. This profile
16-
allows it to communicate with other BLE capable devices.
17-
18-
If you are looking for information about the 'radio' feature, it is a [proprietary protocol from Nordic
19-
and Lancaster University](https://lancaster-university.github.io/microbit-docs/ubit/radio/). This is not Bluetooth and the difference is described further in [this article on using the micro:bit wirelessly](https://support.microbit.org/support/solutions/articles/19000083637-using-the-micro-bit-wirelessly-)
14+
The micro:bit supports Bluetooth via a single BBC micro:bit profile, which was custom developed for the device. This profile allows it to communicate with other BLE capable devices.
2015

16+
If you are looking for information about the 'radio' feature, it is a [proprietary protocol from Nordic and Lancaster University](https://lancaster-university.github.io/microbit-docs/ubit/radio/). This is not Bluetooth and the difference is described further in [this article on using the micro:bit wirelessly](https://support.microbit.org/support/solutions/articles/19000083637-using-the-micro-bit-wirelessly-)
2117

2218
## BBC micro:bit Bluetooth Profile
2319

@@ -36,36 +32,24 @@ There are also some example programs in the [microbit-samples](https://github.co
3632
[bluetooth-eddystone-url]https://github.com/lancaster-university/microbit-samples/tree/master/source/examples/bluetooth-eddystone-url
3733
[bluetooth-uart]https://github.com/lancaster-university/microbit-samples/tree/master/source/examples/bluetooth-uart
3834

39-
The micro:bit has a Bluetooth 4.1 stack with Bluetooth Low Energy (BLE) and supports
40-
the [GAP Perhipheral Role](https://bluetooth-developer.blogspot.com/2016/07/microbit-and-bluetooth-roles.html).
35+
The micro:bit has a Bluetooth 4.1 stack with Bluetooth Low Energy (BLE) and supports the [GAP Peripheral Role](https://bluetooth-developer.blogspot.com/2016/07/microbit-and-bluetooth-roles.html).
4136

42-
As per all Bluetooth, it operates in the ISM (Industrial Scientific Medical) band
43-
and this starts at **2.4GHz and ends at 2.41GHz**. BLE divides the frequency
44-
band into 50 x 2MHz bands of which 40 are used.
37+
As per all Bluetooth, it operates in the ISM (Industrial Scientific Medical) band and 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.
4538
These are called **channels** and numbered **0 to 39**.
46-
Channels 37, 38 and 39 are used for advertising.
39+
Channels 37, 38 and 39 are used for "advertising".
4740

48-
When devices are connected, they use the other channels in a particular sequence
49-
controlled by a feature called **adaptive frequency hopping**.
50-
This helps reduce the impact of congestion from other radio users.
41+
When devices are connected, they use the other channels in a particular sequence controlled by a feature called **adaptive frequency hopping**. This helps reduce the impact of congestion from other radio users.
5142

52-
Data transfer rates will only be a few 100K per second at best and it very much depends on
53-
how your application uses the Bluetooth features; lots of small temperature containing packets
54-
would have a lower data transfer rate than using the UART service, as it depends on the
55-
proportion of system protocol information vs. application data.
43+
Data transfer rates will only be a few 100K per second at best and it very much depends on how your application uses the Bluetooth features; lots of small temperature containing packets would have a lower data transfer rate than using the UART service, as it depends on the proportion of system protocol information vs. application data.
5644

5745
There are some useful [advanced configuration options in the micro:bit runtime code](https://lancaster-university.github.io/microbit-docs/advanced/#compile-time-options-with-yotta)
5846

59-
6047
## Challenge
6148

62-
It would be possible for anyone with the appropriate knowledge to define and
63-
implement other Bluetooth profiles. You would need to use the Mbed C/C++ environment
64-
to do this.
49+
It would be possible for anyone with the appropriate knowledge to define and implement other Bluetooth profiles. You would need to use the Mbed C/C++ environment to do this.
6550

6651
We are seeking collaborators to help us define the new profile elements that expose some of the <span class="v2">V2</span> features.
6752

68-
6953
## Further information
7054

7155
[Martin Woolley's Bluetooth Blog](https://bluetooth-developer.blogspot.com/) has a range of information on using Bluetooth with micro:bit

community/slack.md

Lines changed: 7 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,7 @@ ref: community
99
lang: en
1010
---
1111

12-
The micro:bit community is already spread across the world, building cool things
13-
with micro:bits and building the software that runs on them. Many micro:bit hardware and software resources are openly licensed, and we want to encourage and support
14-
contributions from anyone interested.
12+
The micro:bit community is already spread across the world, building cool things with micro:bits and building the software that runs on them. Many micro:bit hardware and software resources are openly licensed, and we want to encourage and support contributions from anyone interested.
1513

1614
If you'd like to be part of the world-wide micro:bit developer community, then there are a couple of ways you can do this.
1715

@@ -41,12 +39,9 @@ If you'd like to join the slack channel, please fill in the form below. This for
4139
</iframe>
4240

4341
## Other channels and communities
44-
In addition to the Foundation's own channels of communication, there are many other online communities of support.
45-
46-
- [MakeCode micro:bit forum](https://forum.makecode.com/c/microbit/11)
47-
Connect with the MakeCode team for more technical details regarding developing micro:bit extensions
48-
or working on the MakeCode editor.
49-
- [Mu Gitter](https://gitter.im/mu-editor)
50-
Gitter chat is similar to Slack and aimed at developers using [Mu](https://codewith.mu/)
51-
- [/r/microbit](https://www.reddit.com/r/microbit)
52-
A reddit discussion on micro:bit
42+
43+
In addition to the Foundation's own channels of communication, there are many other online support communities.
44+
45+
- [MakeCode micro:bit forum](https://forum.makecode.com/c/microbit/11) Connect with the MakeCode team for more technical details regarding developing micro:bit extensions or working on the MakeCode editor.
46+
- [Mu Gitter](https://gitter.im/mu-editor) Gitter chat is similar to Slack and aimed at developers using [Mu](https://codewith.mu/)
47+
- [/r/microbit](https://www.reddit.com/r/microbit) A reddit discussion on micro:bit

0 commit comments

Comments
 (0)