From 742b24a28a9bc5b8a8ed33a857685de0a4ccc847 Mon Sep 17 00:00:00 2001 From: Peli de Halleux Date: Wed, 8 Mar 2017 05:01:11 -0800 Subject: [PATCH] added link to list of resellers --- README.md | 2 +- docs/about.md | 9 +++++++-- docs/device.md | 35 ++++++++++++++++++++++++++++------- docs/device/contents.md | 19 ------------------- pxtarget.json | 4 ++++ 5 files changed, 40 insertions(+), 29 deletions(-) delete mode 100644 docs/device/contents.md diff --git a/README.md b/README.md index 879d51d8..11b2d312 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # micro:bit target for PXT -This target allow to program a [BBC micro:bit](https://www.microbit.co.uk/) using +This target allow to program a [BBC micro:bit](https://microbit.org/) using PXT ([Microsoft Programming Experience Toolkit](https://github.com/Microsoft/pxt)). * [Try it live](https://pxt.microbit.org) diff --git a/docs/about.md b/docs/about.md index ebf451ff..009cddaa 100644 --- a/docs/about.md +++ b/docs/about.md @@ -4,8 +4,7 @@ ### @description A Blocks / Javascript code editor for the micro:bit, a pocket-size computer with 5x5 display, sensors and Bluetooth. -The [BBC micro:bit](https://www.microbit.co.uk) is a [pocket-size computer](/device) with a 5x5 display of 25 LEDs, Bluetooth and sensors that can be programmed by anyone. -The BBC micro:bit was made possible by many [partners](https://www.microbit.co.uk/partners). +The [BBC micro:bit](https://microbit.org) is a [pocket-size computer](/device) with a 5x5 display of 25 LEDs, Bluetooth and sensors that can be programmed by anyone. The BBC micro:bit was made possible by many [partners](https://www.microbit.co.uk/partners). The micro:bit provides an easy and fun introduction to programming and making – switch on, program it to do something fun – wear it, customize it. Just like Arduino, the micro:bit can be connected to and interact with sensors, displays, and other devices. @@ -16,6 +15,12 @@ Just like Arduino, the micro:bit can be connected to and interact with sensors, The BBC micro:bit is packaged with sensors, radio and other goodies. Learn about the [hardware components](/device) of the micro:bit to make the most of it! +### ~ hint + +**Looking to buy a micro:bit?** See the [list of resellers](https://microbit.org/resellers). + +### ~ + ## Programming: [Blocks](/blocks) or [JavaScript](/javascript) You can program the micro:bit using [Blocks](/blocks) or [JavaScript](/javascript) in your web browser via the [micro:bit APIs](/reference): diff --git a/docs/device.md b/docs/device.md index 550f73be..62aa61c2 100644 --- a/docs/device.md +++ b/docs/device.md @@ -1,9 +1,17 @@ # Device + +### ~ hint + +**Looking to buy a micro:bit?** See the [list of resellers](https://microbit.org/resellers). + +### ~ + All the bits and pieces that make up the BBC micro:bit ![](/static/mb/device-0.png) + ### LED Screen and Status LED The red lights are [LEDs](/device/screen) (light emitting diodes) and form a 5 x 5 LED Screen. @@ -23,19 +31,24 @@ When you have downloaded and run your code onto your micro:bit, press Button R t ### USB connection -When you plug in your micro:bit, it should appear as ``MICROBIT``. +When you plug in your micro:bit via [USB](/device/usb), it should appear as a ``MICROBIT`` drive. + If you accidentally hold down the reset button as you’re plugging in your micro:bit, -the micro:bit will appear as a MAINTENANCE drive instead of ``MICROBIT``. This is known as maintenance mode.** +the micro:bit will appear as a MAINTENANCE drive instead of ``MICROBIT``. This is known as maintenance mode. To continue programming your micro:bit YOU MUST unplug your USB and reconnect it. Check that the drive now shows as ``MICROBIT``. -**Use with caution. If you click on the drive while it shows as ``MAINTENANCE``, +### ~ hint + +Use with caution. If you click on the drive while it shows as ``MAINTENANCE``, you can see which version of firmware you have running on your micro:bit. Firmware on your micro:bit should be up-to-date already. You can find the version of firmware in the 'version.txt' file on the micro:bit. Further information on the firmware can be found here: https://developer.mbed.org/platforms/Microbit/#firmware +### ~ + ### Compass The compass can detect magnetic fields such as the Earth’s magnetic field. @@ -51,14 +64,22 @@ Output is in milli-g. The device will also detect a small number of standard act ### Pins -The pins can be a form of input or output. -There are labels for the input/output pins P0, P1, P2, which you can attach external sensors to such as thermometers or moisture detectors. -You can read more about large and small pins [here](/device/pins). +The [pins](/device/pins) can be a form of electrical input or output. +There are labels for the input/output pins ``P0``, ``P1``, ``P2``, which you can attach external sensors to such as thermometers or moisture detectors. ### Light level The screen can also be used a light level sensor (it's a really cool trick). +### Runtime + +The micro:bit embodies many fundamental concepts in computer science. To learn more, read [the micro:bit - a reactive system](/device/reactive). + + +Sometimes, your micro:bit may display an error code. For more information, see: + +* [the error codes](/device/error-codes) + ### How do I connect the micro:bit to my computer? Your micro:bit can be connected to your computer via a micro USB cable. @@ -90,4 +111,4 @@ control the micro:bit or the micro:bit can control another BLE device. ### Technical Information The micro:bit has been designed to be a bare-board micro controller for use by children aged 11-12. -More information is available at the [BBC web site](http://www.microbit.co.uk/device). +More information is available at the [Microbit Foundation web site](https://microbit.org/device). diff --git a/docs/device/contents.md b/docs/device/contents.md deleted file mode 100644 index 26e5b35e..00000000 --- a/docs/device/contents.md +++ /dev/null @@ -1,19 +0,0 @@ -# micro:bit - the device - -The micro:bit is a very capable device with many components: - -* [the USB connector](/device/usb) -* [the LED screen](/device/screen) -* [the buttons] -* [the accelerometer] -* [the compass] -* [the pins](/device/pins) -* [the battery plug] - -The micro:bit embodies many fundamental concepts in computer science. To learn more, read: - -* [the micro:bit - a reactive system](/device/reactive) - -Sometimes, your micro:bit may display an error code. For more information, see: - -* [the error codes](/device/error-codes) diff --git a/pxtarget.json b/pxtarget.json index 2b5b50f6..50c466a1 100644 --- a/pxtarget.json +++ b/pxtarget.json @@ -269,6 +269,10 @@ { "name": "Hardware", "path": "/device" + }, + { + "name": "Shop", + "path": "https://microbit.org/resellers" } ], "hasReferenceDocs": true,