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
+3-5
Original file line number
Diff line number
Diff line change
@@ -14,10 +14,9 @@ A [list of available accessories](https://microbit.org/buy/accessories/) is main
14
14
15
15
## Using the Edge Connector
16
16
17
-
The micro:bit card edge connector, commonly referred to as the 'edge connector' or the 'pins' makes accessory design easy.
17
+
The micro:bit card edge connector, commonly referred to as the 'edge connector' or the 'pins' makes accessory design easy.
18
18
19
-
Many micro:bit accessories are designed to use an edge connector socket, so it is simple
20
-
to plug in and remove the board.
19
+
Many micro:bit accessories are designed to use an edge connector socket, so it is simple to plug in and remove the board.
21
20
22
21
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
22
@@ -37,8 +36,7 @@ There are two lozenge shaped pads on the back of the micro:bit. These allow you
37
36
### V2 revision
38
37
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.
39
+
- If you make an accessory that uses the lozenges, it must be protected from reverse charging when the board is powered by USB, battery or edge connector.
42
40
- 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
41
44
42
Due to the addition of a speaker, current accessories that use the lozenges to power the micro:bit will no longer fit.
Copy file name to clipboardExpand all lines: bluetooth/apps-and-examples.md
+2-6
Original file line number
Diff line number
Diff line change
@@ -9,13 +9,9 @@ ref: bluetooth
9
9
lang: en
10
10
---
11
11
12
-
Bluetooth applications can run on a variety of devices, including but not limited
13
-
to smart phones and tablets. You can also run Bluetooth enabled applications
14
-
on devices such as a Raspberry Pi.
12
+
Bluetooth applications can run on a variety of devices, including but not limited to smart phones and tablets. You can also run Bluetooth enabled applications on devices such as a Raspberry Pi.
15
13
16
-
Below is a curated list of some Bluetooth applications you might like to read
17
-
about and try for yourself with your micro:bit. Please contribute to this list
18
-
if you know of any more. Many listed here are take from the [micro:bit Awesome list](https://github.com/carlosperate/awesome-microbit)
14
+
Below is a curated list of some Bluetooth applications you might like to read about and try for yourself with your micro:bit. Please contribute to this list if you know of any more. Many listed here are take from the [micro:bit Awesome list](https://github.com/carlosperate/awesome-microbit)
Copy file name to clipboardExpand all lines: bluetooth/index.md
+9-16
Original file line number
Diff line number
Diff line change
@@ -9,33 +9,26 @@ ref: bluetooth
9
9
lang: en
10
10
---
11
11
# 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.
12
+
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)).
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)).
20
19
21
-
Using Bluetooth, you can connect to other devices and send and receive
22
-
data from and to the micro:bit.
20
+
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
-
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.
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. [MakeCode](https://makecode.microbit.org/reference/bluetooth) contains a set of blocks to make use of the various micro:bit services.
34
30
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++.
31
+
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++.
Copy file name to clipboardExpand all lines: bluetooth/profile.md
+7-19
Original file line number
Diff line number
Diff line change
@@ -11,12 +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.
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.
17
15
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-)
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-)
20
17
21
18
22
19
## BBC micro:bit Bluetooth Profile
@@ -36,32 +33,23 @@ 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).
36
+
The micro:bit has a Bluetooth 4.1 stack with Bluetooth Low Energy (BLE) and supports the [GAP Perhipheral Role](https://bluetooth-developer.blogspot.com/2016/07/microbit-and-bluetooth-roles.html).
41
37
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.
38
+
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
39
These are called **channels** and numbered **0 to 39**.
46
40
Channels 37, 38 and 39 are used for “advertising”.
47
41
48
-
When devices are connected, they use the other channels in a particular sequence
49
-
controlled by a feature called **adaptive frequency hopping**.
42
+
When devices are connected, they use the other channels in a particular sequence controlled by a feature called **adaptive frequency hopping**.
50
43
This helps reduce the impact of congestion from other radio users.
51
44
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.
45
+
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
46
57
47
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
48
59
49
60
50
## Challenge
61
51
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.
52
+
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
53
66
54
We are seeking collaborators to help us define the new profile elements that expose some of the <spanclass="v2">V2</span> features.
Copy file name to clipboardExpand all lines: community/slack.md
+5-11
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
@@ -25,7 +23,7 @@ In addition to our regular [Micro:bit Educational Foundation newsletter](https:/
25
23
26
24
## Join us on the microbit-community slack channel!
27
25
28
-
[Slack](https://slack) is a messaging service that allows teams and communities to connect online. It's a brilliant tool for live collaboration and the place to be for current micro:bit chatter!
26
+
[Slack](https://slack) is a messaging service that allows teams and communities to connect online. It's a brilliant tool for live collaboration and the place to be for current micro:bit chatter!
29
27
30
28
Please note that Slack complements, but does not replace [micro:bit help & support](http://support.microbit.org, where you can search for help and ask the team questions.
31
29
@@ -43,10 +41,6 @@ If you'd like to join the slack channel, please fill in the form below. This for
43
41
## Other channels and communities
44
42
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
44
+
-[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.
45
+
-[Mu Gitter](https://gitter.im/mu-editor) Gitter chat is similar to Slack and aimed at developers using [Mu](https://codewith.mu/)
46
+
-[/r/microbit](https://www.reddit.com/r/microbit) A reddit discussion on micro:bit
0 commit comments