2.1.28, initiation update to PXT v5.28.24 (#54)

docs/calliope/firststeps/5x5LED.md

@@ -0,0 +1,58 @@
+# ERSTE SCHRITTE: The 5X5 LED MATRIX
+
+## Introduction @unplugged
+
+Amongst other things, the Calliope mini comes with 25 red LEDs that can be turned on and off individually. If, for example, you wanted to display your name, you could program individual LEDs to light up in sequence so as to display the letters of your name one after the other. As this would be rather complex, you can also enter the character string into a text field and the Calliope Mini will light up the necessary LEDs in the correct order for you.
+
+## Step 1 @fullscreen
+
+
+### DISPLAYING A CHARACTER STRING
+To show your chosen sting of characters on the LED matrix, select the show string block from the Basic menu. Next, drag and attach this block to the Start block in the main screen. The text contained within the inverted commas will now be displayed on the Calliope mini when the program is started.
+
+```blocks
+basic.showString("hi!")
+```
+
+## Step 2 @fullscreen
+
+### DISPLAYING NUMBERS
+If you’d prefer to show a number instead of text, replace the text block in the main screen with the show number block from the Basic menu.
+
+```blocks
+basic.showNumber(0)
+```
+
+## Step 3 @fullscreen
+
+### DISPLAYING IMAGES
+To display a heart, a smiley or even a duck on your Calliope mini, Choose the show iconn block from the Basic menu and select any number of different images by simply clicking on the picture in the block.
+
+```blocks
+basic.showIcon(IconNames.Heart)
+```
+
+## Step 4 @fullscreen
+
+You can also create your very own images:
+Just select this block from the Basic menu and click in the boxes to create your very own image.
+
+```blocks
+basic.showLeds(`
+    . . . . .
+    . . . . .
+    . . . . .
+    . . . . .
+    . . . . .
+    `)
+```
+
+## Step 4 @fullscreen
+
+Wenn du keine Pause zwischen 2 Bildern festlegst, zeigt der Calliope mini das erste Bild null Sekunden lang, also gar nicht. Den Warte ms Block findest du im Menü Kontrolle.
+
+```blocks
+basic.showIcon(IconNames.Heart)
+basic.pause(100)
+basic.showIcon(IconNames.Yes)
+```

docs/calliope/firststeps/Decisions.md

@@ -0,0 +1,23 @@
+# ERSTE SCHRITTE: DAS 5X5 LED RASTER
+
+## Introduction @unplugged
+
+Options within a program can be made dependent not only on inputs, but also on other conditions. For example, you can create an oracle that randomly shows a sad or a happy smiley:
+
+## Step 1 @fullscreen
+
+### If – then do relationship
+The actions below the "then“ are only executed if the condition before is fulfilled.
+In this case, the heart will not be visible on the LED grid, as the decision variable is not equal to 1. You can find the if…then block in the Logic section.
+
+## Step 2 @fullscreen
+
+### And on we go
+After the if…then block the program continues in any case, no matter whether the condition was fulfilled before or not.
+
+## Step 3 @fullscreen
+
+### If – then – else
+If you expand the if…then block, the first if condition is checked first, if it is not fulfilled the second if condition is checked. Only those actions are triggered for which the associated condition is fulfilled.
+
+Click on the + on the bottom of the block to unfold the if…then block. The probability to display either a happy or a sad smiley on the LED grid is 50/50.

docs/calliope/firststeps/Inputs.md

@@ -0,0 +1,32 @@
+# FIRST STEPS: INPUTS
+
+## Introduction @unplugged
+
+So far all the programmed text, numbers and images have been displayed on the LED matrix immediately after being loaded onto the Calliope mini. However, if you would prefer to have an event take place after a specific input, you need to use the one of the main blocks from the Input section. In this case we are using the "on button A pressed“ block. By using this block, the Calliope mini will wait until your chosen condition is met before anything is displaying.
+
+## Step 1 @fullscreen
+
+### Buttons
+The Calliope mini has two input buttons: Button A (in red) and Button B (in blue). When one of the buttons is pressed, the circuit is completed.
+By using the "on button A pressed“ block from Input, you can display your output as soon as button A has been pressed.
+
+## Step 2 @fullscreen
+
+### Shake
+You can request the position and movement of the Calliope mini and run an action once a change of the values has been detected.
+Use the "on shake“ block from the Input section. Add an "show string Hi!" block from the Basic section and change the content of the string.Your text will be displayed when you shake the Calliope mini. The gesture can be changed by using the dropdown menu to choose the condition.
+
+## Step 3 @fullscreen
+
+### Pins
+The Calliope mini has five rounded corners: -, +, 0 , 1, 2, and 3. If you place one finger on the – corner and another finger on one of the numbered corners, a small electrical current will flow through your body and back to the Calliope mini, thus closing the electrical circuit.
+
+Use the „on pin Pin0 pressed" block from Input. Use the "show string Hi!" block from the basic section.
+Your text will be displayed when pin – and pin 0 are both pressed at the same time.
+
+## Step 4 @fullscreen
+
+### Various input
+You can program the Calliope mini to respond to more than one input. There are two possible ways of doing this:
+You can use indiviual events separated from each other with different actions to run after that condition is met.
+Nevertheless, you can also use an "if" or "while" condition (from the Logic and Loops sections) and wait for your inputs to be met.

docs/calliope/firststeps/Loops.md

@@ -0,0 +1,18 @@
+# FIRST STEPS: LOOPS
+
+## Introduction @unplugged
+
+As you may have noticed in previous exercises, your program was executed only once by Calliope mini. To change this, you can use loops. Use an infinite loop so that the text runs over the LED grid of your Calliope mini infinitely often.  
+
+## Step 1 @fullscreen
+
+### Infinite loop
+The simplest way is to use a foverever block, from the basic section.
+Everything inside will be repeated forever.
+
+## Step 2 @fullscreen
+
+Of course, you can also specify how often something should be repeated:
+
+### Repeat block
+Use the „on start“ block or any other block that usually initiates a one time cycle. Take the "Repeat 4 times" block from the Loops section and enter the desired number in the number field. Whatever task is within this block will be executed for the number of times you entered within the “Repeat …“ number.

docs/calliope/firststeps/Mathematics.md

@@ -0,0 +1,17 @@
+# FIRST STEPS: MATHEMATICS
+
+## Introduction @unplugged
+
+Calliope mini offers you the possibility to use different mathematical operations. You can calculate numbers, create random numbers and save your results in variables.
+
+## Step 1 @fullscreen
+
+### Calculation of numbers
+The Calliope mini is able to perform the 4 basic arithmetic operations addition, subtraction, multiplication and division out of the box:
+
+You can find the required block in the menu Math. From the block's drop-down list you can choose between the four basic arithmetic operations and the exponentiation. To see the result of your calculation, you have to put the block inside a „show number" block from the Basic section. The Calliope mini displays the result of your calculation on the LED grid.
+
+## Step 2 @fullscreen
+
+### Random numbers
+You can have Calliope mini create a random number: You can find the corresponding block in the menu Math ("pick random 0 to 10"). By changing the two numbers within the block, you determine how small or how large the random number is allowed to become.

docs/calliope/firststeps/Output.md

@@ -0,0 +1,23 @@
+# ERSTE SCHRITTE: DAS 5X5 LED RASTER
+
+## Introduction @unplugged
+
+As well as the red LED matrix the Calliope mini also has a built-in loudspeaker (or piezo speaker to be more precise) that allows you to play different tones and an LED with which you can display a huge variety of different colours.
+
+## Step 1 @fullscreen
+
+### The RGB-LED
+The white square under the LED matrix is the RGB-LED. Itworks in exactly the same way as watercolours do. Within this LED there are three smaller LEDs: one red, one green and one blue. When you select a colour in your programming environment, the Calliope mini will automatically display this colour by mixing the three base colours together,
+
+Within the Basic section you select the "set led to red“ block and 
+
+## Step 2 @fullscreen
+
+### Light sensor
+The light is measured by the LED matrix. You can select the light sensor by dragging the block from the Input section into the number block. With this block you can change the colour you want to display. Simply click on the red tap and choose another colour from the menu.
+To turn the LED off, you can use the "turn build-in led off“ block or put the value "0“ on the name of the color.
+
+## Step 3 @fullscreen
+
+### The speaker
+You can play individual notes or music pieces. Simply open the Music section and drag the "play tone 262 Hz for 1 beat“ and chance the value of the tone to see how you can adjust the height of the note.

docs/calliope/firststeps/Radio.md

@@ -0,0 +1,25 @@
+# FIRST STEPS: RADIO
+
+## Introduction @unplugged
+
+There is a Radio module built into the Calliope Mini. This allows for several Calliope mini to communicate with each other and transmit information. To try this out yourself, you will need at least two Calliope mini.
+
+
+## Step 1 @fullscreen
+
+### Allocating a channel
+Firstly you must decide on a channel to use. Only those Calliope mini that are using the same channel will be able to exchange messages with each other. A Calliope mini will not be able to transmit or receive over several channels at the same time. To be able to send information, you must open the radio block and use the radio set group block.
+Please ensure that the channel number you select is between 0 and 255.
+
+## Step 2 @fullscreen
+
+### Sending a message
+To send a message you should select the "radio send string“ block. Now you can enter the string that will be sent on the channel.
+
+## Step 3 @fullscreen
+
+###Receive a message
+Set the same channel as on the sending Calliope mini one.
+Use the "on radio received receivedString“ block to look for data.
+Include the "show string receivedString“ inside.
+Let’s try with two (or more) Calliope mini!

docs/calliope/firststeps/Sensors.md

@@ -0,0 +1,30 @@
+# ERSTE SCHRITTE: DAS 5X5 LED RASTER
+
+## Introduction @unplugged
+
+The Calliope mini is equipped with a number of sensors: It has a temperature sensor, a light sensor, a compass as well as a microphone.
+
+## Step 1 @fullscreen
+
+### Displaying sensor data
+In order to display data from your sensors on the Calliope mini’s LED matrix, you need to select a sensor (value). To do so go to the Basic section and select the "show number 0“ block. Within the number you can now change the "0“ to the value of a sensor.
+
+## Step 2 @fullscreen
+
+### Acceleration sensor
+You can select the acceleration values by dragging the block from the Input section and place it on top of the "0“ (which will disappear).
+
+## Step 3 @fullscreen
+
+### Light sensor
+The light is measured by the LED matrix. You can select the light sensor by dragging the block from the Input section into the number block.
+
+## Step 4 @fullscreen
+
+### Compass
+The built in magnetometer allows the Calliope mini to tell in which direction it is facing. This sensor will provide a value between 0 and 360 degrees. The compass will need to be calibrated before use. Follow the instructions on the Calliope mini and tilt it in a circular fashion to display a complete circle. You can start using it by dragging the block from the Input section into the number block.
+
+## Step 4 @fullscreen
+
+### Temperature sensor
+You can select the temperature sensor by dragging the block from the Input section into the number block.

docs/calliope/firststeps/Variables.md

@@ -0,0 +1,20 @@
+# ERSTE SCHRITTE: DAS 5X5 LED RASTER
+
+## Introduction @unplugged
+
+As in a football match, where the number of goals scored during the match can change, the value of a variable can also change during a running program.
+
+By clicking on the Variables section and then on the "Make a variable…“ button within this section you will generate a new variable. Now you can determine the name.
+
+## Step 1 @fullscreen
+
+By clicking on the Variables section and then on the "Make a variable…“ button within this section you will generate a new variable. Now you can determine the name.
+
+## Step 2 @fullscreen
+
+You can find a separate block for each variable, which you can use to display its value on the LED grid of Calliope mini by selecting the "show number 0“ block and use the "set variable to 0“ block from the Variables section and add this on a line before. if you change this number, the number on the grid will change accordingly.
+
+## Step 3 @fullscreen
+
+### Count your score
+By combining what you have learned so far, you can program a simple score counter: When button A is pressed, the number of goals variable is increased by one numerical value and then displayed. Have a try!

docs/calliope/firststeps/firstSteps.md

@@ -0,0 +1,61 @@
+# First Steps
+
+## Introduction @unplugged
+
+### 1) Connecting
+
+Connect your mini to your computer via a micro USB cable or Bluetooth. Macs, PCs, Chromebooks, Linux systems, Smartphones and Tablets are supported.
+
+Your Calliope mini will show up on your computer as a drive called 'MINI'.
+
+Open your favourite browser and head to our website and select Editor in the main navigation.
+
+For example drag and drop some blocks and try your program on the Simulator within the editor.
+
+Click the Download button in the editor. This will download a 'hex' file, which is a compact format of your program that your mini can read. Once the file has been downloaded, just copy it to your Calliope mini just like copying a file to a USB stick.
+
+![Connecting Image](/docs/calliope/firststeps/connecting.jpg)
+
+
+## Introduction @unplugged
+
+### 2) Power it Up
+
+The Calliope mini requires a power source to work. You can either connect your Calliope mini directly to a computer using a Micro USB cable or you can power it using a battery pack.
+Here are the instructions on how to connect the battery pack to your Calliope mini:
+
+The supplied battery pack requires two AAA batteries.
+
+Carefully insert the small white plastic connector from the battery pack into the board’s battery socket.
+
+Be careful to insure that the ridge on the plug is facing upwards.
+
+If the plug slides easily into the socket then you are attaching it correctly. Otherwise, turn the plug round and re-insert it into the socket. Slide it to "on“ and your Calliope mini is powered by the batteries.
+
+![Powering Image](/docs/calliope/firststeps/powerItUp.png)
+
+
+## Introduction @unplugged
+
+### 3) Play!
+
+You can now play arround or try some of our other guided first-steps tutorials...
+
+[Learn how to write your name on the LED-Matrix](#tutorial:/calliope/firststeps/5x5LED)
+
+[Play with colors and sound](#tutorial:/calliope/firststeps/Output)
+
+[See how to Controll your mini with the buttons and pins](#tutorial:/calliope/firststeps/Inputs)
+
+
+## Step 1
+
+Play!
+
+You can now play arround or try some of our other guided first-steps tutorials...
+
+[Learn how to write your name on the LED-Matrix](#tutorial:/calliope/firststeps/5x5LED)
+
+[Play with colors and sound](#tutorial:/calliope/firststeps/Output)
+
+[See how to Controll your mini with the buttons and pins](#tutorial:/calliope/firststeps/Inputs)