Getting Started

You just received your card10 - what now?

card10 assembly

Here’s a step by step guide with pictures for assembling your card10

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 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.

Drawing of card10 with button names

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.

choosing your personal state

Card10 comes with an app to set your personal state. 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.

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.

Important:Don't forget to eject/unmount the card10 before unplugging it or pressing any buttons on the card10

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. 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 for more options of the app.

adding apps

The hatchery also has more apps written by other card10 users. To get these apps on your card10, you can either use the 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, to add the files. 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, create a folder with the name of the app, and then place all files for the app inside this folder.

activate BLE

Initially, BLE is disabled for privacy reasons. If you want to use it, you have to activate it first.

Next

Now it is time to start playing with the card10, writing your own micropython code! Continue in the first interhacktions section.