pxt-swge-beacon

This PXT package allows the micro:bit to generate Bluetooth beacons to which droids from the droid depot will respond.

!! Version Compatibility Issues !!

As of December 2020, this extension does not work with the default MakeCode environment, which has changed since this extension was first created. In order to use this extension you will need to use the Version 1 MakeCode editor at https://makecode.microbit.org/v1.

This extension will also not work with V2 micro:bit. V2 micro:bit uses the CODAL runtime, which does not include the mbed API this extension utilizes.

Reference:

• MakeCode Extension compatibility V1 and V2
• The micro:bit runtime DAL/CODAL

Usage

In MakeCode, open an existing project or create a new project. Click on the gear icon at the top-right and select extensions from the drop-down menu. In the search box enter github:ruthsarian/pxt-swge-beacon, press enter, and select swge-beacon when it comes up. Your project will now include SWGE beacon blocks under the Bluetooth section with some more advanced versions of those blocks under the more subsection.

MakeCode Examples

• https://makecode.microbit.org/v1/_ggJDJ096VcsL
• https://makecode.microbit.org/v1/_R5HKd6gTkUcc

Video Tutorial

• https://www.youtube.com/watch?v=UUo-L128cFc

Block Descriptions

SWGE Location Beacon zone

• zone: Select from a drop-down list the location the beacon should represent.
• numeric version: there is a version of this block that accepts a numeric value for zone under "bluetooth : more"

SWGE Droid Beacon personality

• personality: Select from a drop-down list the personality the beacon should represent.
• usage note: Droids will not react to this type of beacon for up to 2 hours after last encountering a location beacon.
• numeric version: there is a version of this block that accepts a numeric value for personality under "bluetooth : more"

SWGE Advanced Location Beacon zone, react_interval, rssi

• zone: Set the location zone for the beacon. Valid values are 1 - 7.
• react_interval: Controls how long the droid will wait before its next reaction to the same beacon. This value is in seconds, then multiplied by 5. For example, a value of 24 would cause the droid to react every 2 minutes (24 x 5 = 120 seconds or 2 minutes). The minimum reaction time interval is 1 minute. This means any value less than 12 will be treated as 12 (12 x 5 = 60 seconds) by the droid.
• rssi: The minimum signal strength the droid must receive the beacon before it reacts. Value is in dBm and the default value is -90 which offers maximum distance (tens of feet). A value of around -26 will be a minimum distance of a few inches.
• note: this block can be found under the bluetooth "more" subsection.

SWGE Generic Beacon mfr_id, beacon_data

• mfr_id: A 2-byte value (0-65535) that identifies the manufacturer for the beacon. For droid beacons this should be set to 0x0183.
• beacon_data: The raw beacon data; see tables below for details.
• input values: input values will be treated as hexadecimal if they begin with 0x otherwise they are treated as an array of bytes.
• note: this block may be found under "bluetooth : more"

Beacon Format

Droid beacons are typically 6 bytes long. Below is a table that describes the purpose of each byte for droid and location beacons.

Location Beacon

This beacon identifies a location. These beacons are placed throughout the park and droids will react to them as they are encountered.

Example value: 0x0A040102A601

Droid Beacon

This beacon identifies a location. These beacons are placed throughout the park and droids will react to them as they are encountered.

Example value: 0x030444818201

Personality Chip and Affiliation IDs

Supported targets

• for PXT/microbit (The metadata above is needed for package search.)