gettingstarted.md 4.48 KB
Newer Older
Lila Fisch's avatar
Lila Fisch committed
1
2
3
---
title: Getting Started
---
Lila Fisch's avatar
Lila Fisch committed
4
5
6
7
8

You just received your card10 - what now?

## card10 assembly

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

11
## card10 navigation
Julian's avatar
Julian committed
12
There are four buttons on the card10 _harmonic_ board: On the top left, just above the USB-C connector is the POWER button. Below is the LEFT 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.
13
 
schneider's avatar
schneider committed
14
[![Drawing of card10 with button names](/media/card10buttons.svg)](/media/card10buttons.svg)
Lila Fisch's avatar
Lila Fisch committed
15
16


17
18
19
20
21
22
23
24
25
26
27
28
### 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.

29
30
31
32
33
34
35
### choosing your personal state
Card10 comes with an app to set your [personal state](/ps). As with the nickname, enter the menu
by pressing the POWER button briefly. This time, select the `personal_state.py` app with the POWER button,
and navigate to your state with the LEFT and RIGHT buttons. Unlike the other apps, the state of the personal
state LED will remain blinking and glowing as you set it in the app.


36
37
### USB storage

schneider's avatar
schneider committed
38
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.".
39

40
41
42
43
44
45
46
47
48
Now when you connect the card10 to your laptop via USB, it will show up as a storage device. 

<div class="p-notification--caution">
  <p class="p-notification__response">
    <span class="p-notification__status">Important:</span>Don't forget to eject/unmount the card10 before unplugging it or pressing any buttons on the card10
  </p>
</div>


49
50
51
52
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. 
53
54
55
56
57
58
59
Start your card10 in USB storage mode, then copy `nickname.txt` onto the card10. Eject the USB device.
Then briefly press the POWER button to exit the storage mode, and then a second time, to enter the menu.
You can scroll up and down using the LEFT and RIGHT buttons. 
Now look for an app called 'nickname.py', select it by pressing the SELECT button.
If you have successfully uploaded a `nickname.txt` file, your nickname will now show up on the display.
You can also upload a `nickname.json` file instead, to get some more options. 
Have a look at the [hatchery](https://badge.team/projects/card10_nickname) for more options of the app.
60

61
62
63
64
### adding apps

The [hatchery](https://badge.team/) also has more apps written by other card10 users. To get these apps on your card10,
you can either use the [app](/app), or you can upload them via USB storage: Download and extract the `tar.gz` files (or download all files individually). Put your card10 in [usb storage mode](/en/gettingstarted#usb-storage-mode), to add the files.
marble's avatar
marble committed
65
All apps are placed in the `apps` folder. In the `apps` folder, all apps have their own folder, named after the app name (e.g. `apps/app_name`). To add a new app,
66
67
create a folder with the name of the app, and then place all files for the app inside this folder. 

koalo's avatar
koalo committed
68
69
70
71
72
### activate BLE
Initially, BLE is disabled for privacy reasons. If you want to use it, you have to activate it first.

  * Via the menu: Select the ble.py from the menu and press the SELECT button to enable BLE. The board will restart with activated BLE. Deactivation can be done via the same app.
  * Manually: Start the card10 in _USB storage mode_ and add a file `ble.txt` with (exactly) the content `active=true` then reset the board.
73
 
Martin U's avatar
Martin U committed
74
75
76
77
78
### basic ECG howto
Have a look at [how to use the ECG](../ecg/).

For better results use [USB-C electrodes](../ecg_kit_assembly/)

Lila Fisch's avatar
Lila Fisch committed
79

80
81
## Next
Now it is time to start playing with the card10, writing your own micropython code!
Lila Fisch's avatar
Lila Fisch committed
82
Continue in the [first interhacktions](/en/firstinterhacktions) section.