Setup and Configuration

In order to run omnipy, you need to set up your raspberry pi and your android device. Follow the steps in this document to set it up.

Setting up the Raspberry Pi

Install omnipy image

1. Download the image file from the latest release. The file is usually named "omnipy.a.b.c.zip" where a, b and c denote version numbers.

2. Write the image to an SD Card using software such as:

• Etcher (Windows, MacOS, Linux)
• Rufus (Windows)
• or anything you feel comfortable with.

3. Insert the SD-Card into the Raspberry Pi, attach the power cable and let your raspberry pi run. Omnipy will install itself automatically and be ready to use in about 4 minutes.

Note: On Pi Zero, the green light will flash seemingly random during sd-card access, if your light does not come on or stays lit green; then there is something wrong with either your Raspberry Pi or with the sd-card you have prepared.

Pair with your Android

After the raspberry pi setup is complete (and you have waited 4 minutes), you can now set up your android device to establish an automatic connection to omnipy running on the raspberry pi.

1. Open Bluetooth Settings and make sure Bluetooth is turned on.
2. Go to Bluetooth devices or bluetooth settings, choose "Pair new device" and wait for "omnipy" appear in the list. Note: If you have paired with this raspberry pi device previously, unpair it first. Then scan for devices and pair it again.
3. Click on "omnipy" to pair the raspberry pi via bluetooth. The pairing will happen automatically without any interaction.
4. After pairing is done, find the "Bluetooth tethering" or "Mobile hotspot / via bluetooth" option on your android phone and turn it on. After you turn on bluetooth tethering, omnipy will connect automatically to your phone within one minute.
5. For some Android phones (eg Samsung S7), to maintain the tethering, for example after phone reboot, you will need to install the BT AutoTether app (from the Play Store) and select the omnipy device.

Install Android APS Omnipy version

The simplest way to install AAPS is to download the prebuilt version for omnipy from the releases page. You can also build the software from the sources as explained in further sections.

1. Download the apk file from the latest release. The file is usually named "omnipy.a.b.c-AAPS.x.y.z.apk" where a, b and c denote version of omnipy and x,y and z refer to the version of Android APS.

2. Copy the file to your android and install the apk.

3. Run the Android APS application and in pump selection, choose "Omnipy".

4. Click the settings icon next to it and then click "Set password"

5. Type "piesnotalie" (without the quotes) as this is the default password on the omnipy image.

6. Click back button and continue with AndroidAPS setup

Omnipy setup is completed.

---

Head over to the following pages to learn how to:

1. Setup a new pod
2. Advanced setup