RileyLink iOS App
The main purpose of the RileyLink iOS App is for developers to test and build the device commands. The RileyLink iOS app connects to a RileyLink via Bluetooth Low Energy (BLE, or Bluetooth Smart)
- Communicate with specific Medtronic Pumps dating before 2012. Read the Loop documentation for more information about which pumps are working.
- Communicate with the OmniPod.
How to contibute
Test edge cases
Try to test as many use cases as possible by using the test command to send the command to the Pod. The test command line can be inserted here. It will send the command by using the test command button in the app: https://github.com/ps2/rileylink_ios/blob/omnikit/OmniKit/PodCommsSession.swift#L133
Create issues for failing test cases
If there is an error, create an Issue here https://github.com/ps2/rileylink_ios/issues with:
- A description which steps you took.
- The console output from Xcode as a text snippet
If you own a RTL-SDR USB Device, also try to capture the radio messages as well and adding this to the Issue by using this capture program: https://github.com/Lytrix/openomni/tree/rtlomni which might help as well in trying to see what radio commands were send.
Add unit tests
You can also add your test as a unit test if there is no similiar test written yet here: https://github.com/ps2/rileylink_ios/tree/omnikit/OmniKitTests
PR new communication commands or refactored code
Always run all Omnikit tests before making a PR request and also solve any errors which the travis build can find. Create a new PR to the omnikit branch if you have created a new part in the communication commands.
WARNING the PODs used will fail rapidly, so testing will require a lot of PODs.
Flash the Rileylink Device
Flash your Rileylink device to version 2.0 or greater if you are using an earlier version using the dev branch of https://github.com/ps2/rileylink/tree/dev subg_rfspy and ble113_rfspy (there are two chips) need to be flashed.
Clone this repo to your machine
git clone https://github.com/ps2/rileylink_ios.git cd rileylink_ios git checkout omnikit // To switch the branch or do it Xcode using the branch button in the menu on the top left.
Install the Rileylink iOS app to your phone
You'll need Xcode, which is available for free, but will only build apps that last a week. To make your apps run longer, you'll have to sign up for a developer account. Read this tutorial how to sign up: https://loopkit.github.io/loopdocs/setup/build/installing/
- Connect your iphone with a usb lightning connector to your laptop
- Select your iphone name at the top page pull down menu (it usually shows generic device)
- Then just clicking on the build and run button in Xcode should build and install the app to your connected phone.
How to Use
To use the Rileylink, it has to connect to a Rileylink device first. If you don't see your RileyLink, close any app that uses the Rileylink or reboot your phone.
Setup an Omnipod
Click on Setup POD. Follow the same steps as with the PDM, but only push once to insert canula, else the Pod wil fail. If all went well you should see something like this:
To start testing commands you can edit the test command setting in xCode here and issue the command after rebuilding the app on your phone and push the test command button:
Setup a Medtronic pump
- Pump ID - Enter in your six digit pump ID