Skip to content

Commit 670d1f1

Browse files
authored
Remove hard linebreaks and trailing whitespace (#174)
This changeset removes - hopefully all - hard linebreaks in a single pass to make future corrections clearer and concise.
1 parent 6be457a commit 670d1f1

33 files changed

+302
-780
lines changed

accessories/making-accessories.md

+3-5
Original file line numberDiff line numberDiff line change
@@ -14,10 +14,9 @@ A [list of available accessories](https://microbit.org/buy/accessories/) is main
1414

1515
## Using the Edge Connector
1616

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.
1818

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.
2120

2221
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.
2322

@@ -37,8 +36,7 @@ There are two lozenge shaped pads on the back of the micro:bit. These allow you
3736
### V2 revision
3837
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.
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.
4240
- 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.
4341

4442
Due to the addition of a speaker, current accessories that use the lozenges to power the micro:bit will no longer fit.

bluetooth/apps-and-examples.md

+2-6
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,9 @@ ref: bluetooth
99
lang: en
1010
---
1111

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.
1513

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)
1915

2016

2117
## Applications, tools and examples

bluetooth/index.md

+9-16
Original file line numberDiff line numberDiff line change
@@ -9,33 +9,26 @@ ref: bluetooth
99
lang: en
1010
---
1111
# 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.
1513

1614
## Bluetooth software stack
17-
<span class="v1">v1</span> Nordic Semiconductor [Soft Device S110](https://www.nordicsemi.com/Software-and-Tools/Software/S110)
18-
<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)).
15+
<span class="v1">v1</span> Nordic Semiconductor [Soft Device S110](https://www.nordicsemi.com/Software-and-Tools/Software/S110)
16+
<span class="v2">V2</span> Nordic Semiconductor [Soft Device S140](https://www.nordicsemi.com/Software-and-tools/Software/S140)
1917

18+
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)).
2019

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.
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

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.
3430

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++.
3932

4033
## Apps
4134

bluetooth/profile.md

+7-19
Original file line numberDiff line numberDiff line change
@@ -11,12 +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.
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.
1715

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-)
2017

2118

2219
## BBC micro:bit Bluetooth Profile
@@ -36,32 +33,23 @@ There are also some example programs in the [microbit-samples](https://github.co
3633
[bluetooth-eddystone-url]https://github.com/lancaster-university/microbit-samples/tree/master/source/examples/bluetooth-eddystone-url
3734
[bluetooth-uart]https://github.com/lancaster-university/microbit-samples/tree/master/source/examples/bluetooth-uart
3835

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).
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).
4137

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.
4539
These are called **channels** and numbered **0 to 39**.
4640
Channels 37, 38 and 39 are used for “advertising”.
4741

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**.
5043
This helps reduce the impact of congestion from other radio users.
5144

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.
5646

5747
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)
5848

5949

6050
## Challenge
6151

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.
6553

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

community/slack.md

+5-11
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

@@ -25,7 +23,7 @@ In addition to our regular [Micro:bit Educational Foundation newsletter](https:/
2523

2624
## Join us on the microbit-community slack channel!
2725

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!
2927

3028
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.
3129

@@ -43,10 +41,6 @@ If you'd like to join the slack channel, please fill in the form below. This for
4341
## Other channels and communities
4442
In addition to the Foundation's own channels of communication, there are many other online communities of support.
4543

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
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

Comments
 (0)