Setup and Configuration

WARNING WORK IN PROGRESS

Do not attempt to setup the software right now, unless you can read & understand the code and able to make necessary configuration changes. Please follow the progress on these two projects:

omnipy project
AndroidAPS Omnipod project

These are tasks related to making the project less about me and more about everyone, so please stick with me until they are complete. Many thanks for your patience!

Setup

In order to run omnipy, you need to set up two devices and install a variety of software on the two of them. Here are the 5 steps to get omnipy up and running with AndroidAPS:

Step 1: Android - Get a clean device

Your android device will come with a preinstalled Android operating system and you only need to install the (yet) unofficial AndroidAPS version that has built-in support for omnipy.

Android users unfortunately don't have much say when it comes to preinstalled software on their phones, but it is advised to not install any software other than AndroidAPS on your device. If you have the experience and possibility to root your device, it may prove beneficial to do it, if you can eliminate the possibility of your phone's OS to interfere with the operation of AndroidAPS software and the phone's general management of connectivity options / battery optimizations. Be aware there is a real danger that you may lose some hardware functionality, due to many custom roms providing some sort of compatible device drivers, but not the actual ones from the manufacturer. If you exactly know what you're doing, then please go ahead. Otherwise stay away from experimenting on a device which is going to host a critical application for your well-being.

Step 2: Install Android APS

tbd

Step 3: Enable bluetooth tethering on Android

All android devices have support for creating a local network with the purpose of sharing the phone's internet connection. An actual internet connection is normally not needed to enable this feature.

For omnipy to work, you need to enable bluetooth tethering on android and let the raspberry pi connect to your android via bluetooth. The omnipy setup script will run you through the necessary steps to establish a bluetooth PAN (Personal Area Network) connection.

Note that on some devices this function is called a "Hotspot" or elements of it may be part of a hotspot configuration, where you can optionally enable Bluetooth tethering.

If you don't have the bluetooth option, or feeling adventurous, see the last section in this document for alternative configuration options.

Step 4: Install Debian OS on the Raspberry Pi

tbd

Step 5: Install omnipy on the Raspberry Pi

tbd

Various Notes

Networking

There are many options to network these two devices. Here is some of them:

• Bluetooth tethering on android device (preferred method)
• Wireless hot-spot on the android device
• Wireless AP on the raspberry pi
• Wi-Fi direct
• USB tethering