You just received your card10 - what now?
Here’s a step by step guide with pictures for assembling your card10
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.
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).
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.
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.
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.
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.
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.
Initially, BLE is disabled for privacy reasons. If you want to use it, you have to activate it first.
ble.txtwith (exactly) the content
active=truethen reset the board.
Now it is time to start playing with the card10, writing your own micropython code! Continue in the first interhacktions section.