Support for use with Bluetooth

Find tips and tricks to control your Calliope mini with a smartphone or tablet!

Getting started

‘Pairing’ is what you have to do in order to connect the Calliope mini with another device like a smartphone or tablet. Why? Well, pairing is all about security. You wouldn’t want anyone else's device to connect to your Calliope mini and let it take control. So by pairing your mobile device with your Calliope mini you ensure that only your devices can communicate with each other.

Using the Calliope mini the first time
If you are using your Calliope mini for the first time, your mini should be ready to connect to other devices. The Calliope mini welcomes you with a short start animation. Follow the instructions and at the end the Calliope mini jumps into the mini menu. Just select program number 5, by using Button A and Button B, shake the mini. Now you are ready to select it from within the Playground!

Coding with the Calliope Swift Playground
To use the Playground the latest default program is required.

ACurrent program
**In case that the latest default program is already on the Calliope mini. **

Characteristics: After the demo sequence has been played you can switch between mode 1-5.
Instruction: Confirm mode 5 by shaking.

Now the Calliope mini is ready to connect to the Playground via Bluetooth.

Bdefault program
** In case that the latest default program is NOT installed on the Calliope mini and you are only using the iPad. **

Characteristics: After the demo sequence has been played, you can switch between mode 1-4 or execute a completely different script.

Instruction: The current default program can be transferred via the Calliope App ('Your Script's' / 'Calliope - mini-start'). Therefore the app has to be connected to the mini via the manual pairing, see manual pairing.

Now the Calliope mini is ready to connect to the Playground.

CPrevious program
** In case that the latest default program is NOT installed on the Calliope mini and you are using a Computer and the iPad. ** 1. Connect your Calliope mini via USB with your computer using the USB cable.
2. Download the current default program here.
Default Program .HEX
  1. Copy HEX-file to the "MINI" drive.

Get the Calliope mini Swift Playground

If you want to use the Calliope Swift Playground please make sure to set up your iPad first!

1. Install the Swift Playgrounds app on your iPad.

Swift Playgrounds App

2 Click to install the Playground immediately
and switch to step number 6.

Calliope mini Playground
or copy this URL:
calliope-edu.github.io/playground/feed.json.

3. Open Swift Playgrounds on your iPad, under the 'What's Next' section tap 'See All'

4. Scroll to the bottom of that section and tap 'Enter a Subscription URL'

5. Paste in the copied URL and tap 'subscribe', confirm that you want to use a third party subscription.

6. You should now be subscribed to the Calliope mini channel!

7. Tap 'Get' to download the book to your device. Once downloaded, tap on the icon to open it. You will be reminded again that the Playground belongs to a third party. Confirm this to open it.

Connect your Calliope mini within the Playground
The Calliope mini and the iPad are connected. The program code is transferred via Bluetooth and deletes the previous script but not the firmware on the mini. The last transferred program is always executed.
If the mini is disconnected from the power supply and then switched on again or the reset button is pressed, the last program transferred from the playground is deleted and the Calliope mini menu with the programs 1-5 is executed.

To establish a connection to send code to your Calliope mini from within the Playground you need to follow these steps:

1Mode 5
Switch to program 5 on your Calliope mini using Button A and Button B.
2Confirm

Shake the Calliope mini to confirm your selection.

3ID Pattern

The Calliope LED-Display will show an ID-Pattern.

4Connect

Press the little red Button on the top right within your Playground.

5Enter ID-Pattern

Enter ID-Pattern to connect the two devices.

6Ready

The red button will turn green.
Now you are ready to start coding with Swift!

Coding with the Calliope mini App
The two devices are connected by manual pairing. The program code is transferred via Bluetooth and deletes the previous script (as well as the firmware), just like the USB transfer. Therefore only the manual pairing is possible after the transfer of the first code.
If the mini is disconnected from the power supply and then switched on again, the last transferred program can still be executed.

1Start

Start the Calliope mini App.

2Manual Pairing

1. Press Button A+B and Reset for a few seconds
2. Release Reset
3. Release Button A+B when you see the pairing icon or a pattern on the LED-Display.

3Enter ID

Enter ID-Pattern to connect the two devices.

Transfer Code from the App to the Calliope mini
1. Use an editor to create a script or transfer existing programs.

2. From now on you can transfer code from the app via Bluetooth. It should not be necessary to pair again and again.

3. Process of transferring code to the Calliope mini:
'Searching for mini' (this phase can last up to 10 seconds) | 'Restart' | 'Flash' | 'Flashing succeeded'.

DEBUG

The connection is interrupted
If the app does not jump to the Flash phase, the connection is interrupted.
To re-establish this connection, the app must be closed and reopened. The connection is automatically re-established. Now code can be transferred again.

Code cannot be transmitted
Please set the Calliope mini to pairing mode and connect it in the app via 'select different mini'.

Manual Pairing Problem
The mini can no longer be manually set to pairing mode.
1. Transfer the latest firmware via App or USB on the Calliope mini.
2. Set the Calliope mini to pairing mode.
3. The ID-Pattern is displayed on the LED grid.

TIPS

Demo Sequence
The demo sequence is played only once after the firmware has been installed.
Press RESET immediately to skip Demo Sequence.

Manual Pairing
To access the pairing icon you have to press Button A+B and Reset simultaneously for a few seconds, release Reset and Button A+B when you see the pairing icon appearing. Now you can select the Calliope mini from within your app.

Bluetooth package
If you are using MakeCode to write your programs please include the Bluetooth package and select project settings from the settings menu and select "No pairing required". Now pairing is very easy!

There are circumstances which will result in pairing data being lost however and when this happens you will need to pair again.

Currently, flashing new code via a USB cable causes the Calliope mini Bluetooth pairing data to be lost. Consequently, if you do flash new code to your Calliope mini using a USB cable you will need to pair again.

In contrast if you upload new code to your Calliope mini over Bluetooth you will not need to pair again.

If you do find yourself needing to pair again you will first need to remove the pairing from your other device (i.e. smartphone or tablet):

On iOS go into Settings/Bluetooth, select your Calliope mini and then select Forget This Device
On Android go into Settings/Bluetooth, select the ‘cog’ next to your Calliope mini and then select FORGET.