diff --git a/app/_index.md b/app/_index.md
index fe97c21190661c14d800a992b6cb5e95b3494ffc..7bbd509a9f39f43d173467ea8d3b539d303e40f6 100644
--- a/app/_index.md
+++ b/app/_index.md
@@ -2,12 +2,14 @@
title: Companion App
---
+{{< rawhtml >}}
<div class="p-notification--caution">
<p class="p-notification__response">
<span class="p-notification__status">Warning:</span>
We are still in developing the Companion App for iOS and Android
</p>
</div>
+{{< /rawhtml >}}
## We need really help, please follow us [here](developing)
diff --git a/en/userguide/_index.md b/en/userguide/_index.md
index 26a559d12a900df4ea2deae3de1723ee544d4a80..966eea01dc765fcaf47506cf2146c36cc29a6f37 100644
--- a/en/userguide/_index.md
+++ b/en/userguide/_index.md
@@ -16,6 +16,8 @@ The user guide of the card10 is divided into a few sections. Here is an overview
- [Expected run time](general-usage#expected-run-time)
- [Going to standby](general-usage#going-to-standby)
- [Powering off](general-usage#powering-off)
+ - [Starting apps](general-usage#starting-apps)
+ - [Setting your personal state](general-usage#setting-your-personal-state)
- [Installing apps via USB](general-usage#installing-apps-via-usb)
diff --git a/en/userguide/ble.md b/en/userguide/ble.md
index 0f51ecebdd207900f972b0d268ab32697200768a..923a2d586051d97667d3373de330bcb4442d6059 100644
--- a/en/userguide/ble.md
+++ b/en/userguide/ble.md
@@ -36,15 +36,17 @@ To create a pairing open the `Bluetooth` app:
Your card10 is now in pairing mode and can be seen by other devices. You can use the `card10companion` on Android or the system dialog of other devices to find your card10 and start the pairing process:
Android:
+{{< figure src="/media/ug/2-ble-android-1.png" link="/media/ug/2-ble-android-1.png" width="300px">}}
iOS:
card10companion:
Once the pairing process has started both devices will show a confirmation code. Make sure that they both show the same code and accept the pairing on both. If possible the card10 will also show a name of the device which is trying to pair:
-Hint: On Android this dialog sometimes pops up in the background and has to be selected from the status bar:
+**Hint:** On Android this dialog sometimes pops up in the background and has to be selected from the status bar.
Android:
+{{< figure src="/media/ug/2-ble-android-2.png" link="/media/ug/2-ble-android-1.png" width="300px">}}
iOS:
card10companion:
@@ -80,9 +82,11 @@ The companion app for Android allows you to:
- Upload files
- Make your card10 sparkle
-We recommend to install the fdroid app store to install it:
+You can find the latest release of the Companion App in the F-Droid repository:
-Another option is to directly download the APK and install the app manually:
+[Companion App for the card10 Chaos Communication Camp badge](https://f-droid.org/app/de.ccc.events.badge.card10)
+
+Have a look at the [app section](/app) for more information about the app.
## Installing the companion app on iOS
Currently there is no regular iOS release of the card10 companion available. If you want to help out, **please** get in touch:
@@ -96,7 +100,9 @@ Phyphox is a versatile physics experimentation app for smartphones. It can use t
To use the light sensor in Phyphox:
+TBD
+
## Using characteristics via BLE
-BLE uses
+How to use nRF Connect goes here.
diff --git a/en/userguide/general-usage.md b/en/userguide/general-usage.md
index 2d886102ccfaa5f11d231a38ab6c8d4aa5255e5b..5b41c9c7ab8a6ddeabbb45f39fac60f751534148 100644
--- a/en/userguide/general-usage.md
+++ b/en/userguide/general-usage.md
@@ -10,6 +10,9 @@ There are four buttons on the card10 _harmonic_ board: On the top left, just abo
## Powering on
To switch on card10, briefly press the `POWER` button. After showing you which firmware version is installed, it will launch the [default app](../menu-system#selecting-a-default-app).
+[](/media/ug/1-boot-1.jpg)
+[](/media/ug/1-boot-2.jpg)
+[](/media/ug/1-default-watchface.jpg)
### Expected run time
With the default watch face and the current firmware (version 1.16) , a card10 should last around 24 hours. It will go into standby mode when the battery reaches a critically low level. In standby mode it continues to keep the time for multiple days. Even with an "empty" battery.
@@ -50,6 +53,7 @@ by pressing the POWER button briefly. Select the `Personal State` app with the `
and navigate to your state with the `LEFT/UP` and `RIGHT/DOWN` buttons. Unlike the other apps, the state of the personal
state LED will remain blinking and glowing even after you leave the app.
+[](/media/ug/1-ps.jpg)
## Installing apps via USB
Your card10 can function similar to a USB stick in its _USB Storage Mode_. You can use this mode to upload configuration files, firmware updates and apps. Another way to install apps is via [Bluetooth](../ble) using your mobile phone and the [card10companion app](/app).
diff --git a/media/ug/1-boot-1.jpg b/media/ug/1-boot-1.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..21853fe8611c27b4c86fb0bdcf7674b4a89d168a
Binary files /dev/null and b/media/ug/1-boot-1.jpg differ
diff --git a/media/ug/1-boot-2.jpg b/media/ug/1-boot-2.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..94739c44790500673f268aee051c69f310284ff7
Binary files /dev/null and b/media/ug/1-boot-2.jpg differ
diff --git a/media/ug/1-default-watchface.jpg b/media/ug/1-default-watchface.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..cf87343061c676ff9bc01d519d35f166cb96158b
Binary files /dev/null and b/media/ug/1-default-watchface.jpg differ
diff --git a/media/ug/1-ps.jpg b/media/ug/1-ps.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..d5822f5f639a8f44df73437b2b38d4d9d235591c
Binary files /dev/null and b/media/ug/1-ps.jpg differ
diff --git a/media/ug/2-ble-android-1.png b/media/ug/2-ble-android-1.png
new file mode 100755
index 0000000000000000000000000000000000000000..b3890fa401c19a981c46170c24e7210271219868
Binary files /dev/null and b/media/ug/2-ble-android-1.png differ
diff --git a/media/ug/2-ble-android-2.png b/media/ug/2-ble-android-2.png
new file mode 100755
index 0000000000000000000000000000000000000000..00719f065afceb1135688ab35e583ae03f536713
Binary files /dev/null and b/media/ug/2-ble-android-2.png differ