You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: accessories/making-accessories.md
+8-10Lines changed: 8 additions & 10 deletions
Original file line number
Diff line number
Diff line change
@@ -22,25 +22,23 @@ to plug in and remove the board.
22
22
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.
23
23
24
24
### V2 revision
25
-
The edge connector on the <spanclass="V2">V2</span> board revision is backwards compatible with the <spanclass="v1">v1</span> edge connector, but has additional dedicated pins.
25
+
26
+
The edge connector on the <spanclass="V2">V2</span> board revision is backwards compatible with the <spanclass="v1">v1</span> edge connector, but includes additional dedicated pins.
26
27
27
28
* Details of the [edge connector and pinout](/hardware/edgeconnector)
28
29
* Details about [powering things from the board](/hardware/powersupply)
29
30
30
31
## Battery Pads
31
32
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.
34
34
35
-

35
+

36
36
37
37
### V2 revision
38
-
In the <spanclass="v2">V2</span> board revision, the 3V lozenge is connected to the 3V ring on the edge connector.
39
38
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 <spanclass="v2">V2</span> board revision, the 3V lozenge is connected to the 3V ring on the edge connector.
45
40
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.
46
43
44
+
Due to the addition of a speaker, current accessories that use the elongated pads to power the micro:bit will no longer fit.
Copy file name to clipboardExpand all lines: bluetooth/apps-and-examples.md
+4-6Lines changed: 4 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -17,11 +17,9 @@ Below is a curated list of some Bluetooth applications you might like to read
17
17
about and try for yourself with your micro:bit. Please contribute to this list
18
18
if you know of any more. Many listed here are take from the [micro:bit Awesome list](https://github.com/carlosperate/awesome-microbit)
19
19
20
-
21
20
## Applications, tools and examples
22
21
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)
25
23
26
24
[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)
27
25
@@ -33,15 +31,15 @@ if you know of any more. Many listed here are take from the [micro:bit Awesome l
33
31
34
32
[micro:bit Blue App for Android](https://github.com/microbit-foundation/microbit-blue)
[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.
41
39
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.
43
41
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.
45
43
46
44
[microbit-web-bluetooth](https://github.com/thegecko/microbit-web-bluetooth) - Web Bluetooth library implementing the micro:bit Bluetooth Profile.
Copy file name to clipboardExpand all lines: bluetooth/index.md
+12-16Lines changed: 12 additions & 16 deletions
Original file line number
Diff line number
Diff line change
@@ -8,44 +8,40 @@ permalink: /bluetooth/
8
8
ref: bluetooth
9
9
lang: en
10
10
---
11
+
11
12
# 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.
<spanclass="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)).
19
20
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.
23
22
24
23
## micro:bit Bluetooth Features
25
24
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.
28
26
29
27
## Bluetooth and the micro:bit software
30
28
31
29
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.
34
31
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++.
39
33
40
34
## Apps
41
35
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
+
43
38
[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
+
44
40
[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
Copy file name to clipboardExpand all lines: bluetooth/profile.md
+8-24Lines changed: 8 additions & 24 deletions
Original file line number
Diff line number
Diff line change
@@ -11,13 +11,9 @@ lang: en
11
11
12
12
## Overview
13
13
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.
20
15
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-)
21
17
22
18
## BBC micro:bit Bluetooth Profile
23
19
@@ -36,36 +32,24 @@ There are also some example programs in the [microbit-samples](https://github.co
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).
41
36
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.
45
38
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".
47
40
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.
51
42
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.
56
44
57
45
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)
58
46
59
-
60
47
## Challenge
61
48
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.
65
50
66
51
We are seeking collaborators to help us define the new profile elements that expose some of the <spanclass="v2">V2</span> features.
67
52
68
-
69
53
## Further information
70
54
71
55
[Martin Woolley's Bluetooth Blog](https://bluetooth-developer.blogspot.com/) has a range of information on using Bluetooth with micro:bit
Copy file name to clipboardExpand all lines: community/slack.md
+7-12Lines changed: 7 additions & 12 deletions
Original file line number
Diff line number
Diff line change
@@ -9,9 +9,7 @@ ref: community
9
9
lang: en
10
10
---
11
11
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.
15
13
16
14
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.
17
15
@@ -41,12 +39,9 @@ If you'd like to join the slack channel, please fill in the form below. This for
41
39
</iframe>
42
40
43
41
## Other channels and communities
44
-
In addition to the Foundation's own channels of communication, there are many other online communities of support.
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