gettingstarted.md 2.16 KB
Newer Older
Lila Fisch's avatar
Lila Fisch committed
1
2
3
4
5
6
# getting started

You just received your card10 - what now?

## card10 assembly

miriamino's avatar
miriamino committed
7
[Here](/en/assembleyourcard10)'s a step by step guide with pictures for assembling your card10
miriamino's avatar
miriamino committed
8

9
10
11
## card10 navigation
There are four buttons on the card10 _harmonic_ board: On the top left, just above the USB-C connector is the POWER button. Below it is the LLEFT button. The buttons on the right side are closer together. On this side, the top button is the SELECT button, the one below it is the RIGHT button.
 
Lila Fisch's avatar
Lila Fisch committed
12
<img class="center" alt="Drawing of card10 with button names" src="/media/card10buttons.svg"  width="220" height="auto" align="center">
Lila Fisch's avatar
Lila Fisch committed
13
14


15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
### switching your card10 on and off

To switch on card10, briefly press the POWER button. To switch it off again, press and hold down the power button for several seconds (usually this is around three seconds, however for some apps it can take over ten seconds).

### starting apps

When your card10 is switched on, a short press of the POWER button
brings you to the app menu. You can scroll down with the RIGHT button, 
and up with the LEFT button. The SELECT button starts the selected app. 
The POWER button starts the app called 'main.py', which is also the app 
that will automatically start when you turn on your card10.

### USB storage

Your card10 can function similar to a USB stick, if you start it in _USB storage mode_. You can use this mode to upload _configuration files_ and _micropython scripts_. To enter _USB storage mode_, first switch off your card10 with a long press of the POWER button. Next, hold down the RIGHT button and the POWER button, until your display shows the text "USB activated. Ready.".

Now when you connect the card10 to your laptop via USB, it will show up as a storage device. Don't forget to unmount the card10 storage device.
The USB storage mode is exited by briefly pressing the POWER button.

### setting your nickname
To set your nickname, create a file called `nickname.txt` on your laptop. 
Start your card10 in USB storage mode, then copy `nickname.txt` onto the card10. 
Now look for an app called 'nickname.py' (TODO: this app might need downloading first...), 
which will display the nickname.

### making LEDs blink

Lila Fisch's avatar
Lila Fisch committed
42
43