Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Remove hard linebreaks and trailing whitespace #174

Merged
merged 1 commit into from
Oct 16, 2020
Merged

Remove hard linebreaks and trailing whitespace #174

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 3 additions & 5 deletions accessories/making-accessories.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,10 +14,9 @@ A [list of available accessories](https://microbit.org/buy/accessories/) is main

## Using the Edge Connector

The micro:bit card edge connector, commonly referred to as the 'edge connector' or the 'pins' makes accessory design easy.
The micro:bit card edge connector, commonly referred to as the 'edge connector' or the 'pins' makes accessory design easy.

Many micro:bit accessories are designed to use an edge connector socket, so it is simple
to plug in and remove the board.
Many micro:bit accessories are designed to use an edge connector socket, so it is simple to plug in and remove the board.

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.

Expand All @@ -37,8 +36,7 @@ There are two lozenge shaped pads on the back of the micro:bit. These allow you
### V2 revision
In the <span class="v2">V2</span> board revision, the 3V lozenge is connected to the 3V ring on the edge connector.

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

Due to the addition of a speaker, current accessories that use the lozenges to power the micro:bit will no longer fit.
Expand Down
8 changes: 2 additions & 6 deletions bluetooth/apps-and-examples.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,9 @@ ref: bluetooth
lang: en
---

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

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


## Applications, tools and examples
Expand Down
25 changes: 9 additions & 16 deletions bluetooth/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,33 +9,26 @@ ref: bluetooth
lang: en
---
# Overview
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.
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.

## Bluetooth software stack
<span class="v1">v1</span> Nordic Semiconductor [Soft Device S110](https://www.nordicsemi.com/Software-and-Tools/Software/S110)
<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)).
<span class="v1">v1</span> Nordic Semiconductor [Soft Device S110](https://www.nordicsemi.com/Software-and-Tools/Software/S110)
<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)).

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

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

## micro:bit Bluetooth Features

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

## Bluetooth and the micro:bit software

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

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

## Apps

Expand Down
26 changes: 7 additions & 19 deletions bluetooth/profile.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,12 +11,9 @@ lang: en

## Overview

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

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


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

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

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

When devices are connected, they use the other channels in a particular sequence
controlled by a feature called **adaptive frequency hopping**.
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.

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

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)


## Challenge

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

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

Expand Down
16 changes: 5 additions & 11 deletions community/slack.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,9 +9,7 @@ ref: community
lang: en
---

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

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.

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

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

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

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.

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

- [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.
- [Mu Gitter](https://gitter.im/mu-editor)
Gitter chat is similar to Slack and aimed at developers using [Mu](https://codewith.mu/)
- [/r/microbit](https://www.reddit.com/r/microbit)
A reddit discussion on micro:bit
- [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.
- [Mu Gitter](https://gitter.im/mu-editor) Gitter chat is similar to Slack and aimed at developers using [Mu](https://codewith.mu/)
- [/r/microbit](https://www.reddit.com/r/microbit) A reddit discussion on micro:bit
Loading