From 1627adaccc56e9d2063d5de802903bd792633c15 Mon Sep 17 00:00:00 2001 From: Chris Hannemann Date: Wed, 5 Oct 2016 22:06:42 -0700 Subject: [PATCH 01/14] Fix Gitter Button Button was linked to LoopKit/LoopKit instead of the correct LoopKit/Loop --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 12756e1354..27be542a4a 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ ![App Icon](/Loop/Assets.xcassets/AppIcon.appiconset/Icon-40%402x.png?raw=true) ![WatchApp Icon](/WatchApp/Assets.xcassets/AppIcon.appiconset/watch-40%402x.png?raw=true) [![Build Status](https://travis-ci.org/LoopKit/Loop.svg?branch=master)](https://travis-ci.org/LoopKit/Loop) -[![Join the chat at https://gitter.im/LoopKit/LoopKit](https://badges.gitter.im/LoopKit/LoopKit.svg)](https://gitter.im/LoopKit/LoopKit?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) +[![Join the chat at https://gitter.im/LoopKit/Loop](https://badges.gitter.im/LoopKit/Loop.svg)](https://gitter.im/LoopKit/Loop?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) Loop is an app template for building an artificial pancreas. It is a stone resting on the boulders of work done by [@bewest](https://github.com/bewest/decoding-carelink), [@ps2](https://github.com/ps2/rileylink) and many others. From 17e97e26c77e08b984a31c0466850fa7a201eab6 Mon Sep 17 00:00:00 2001 From: Pete Schwamb Date: Sat, 22 Oct 2016 15:10:07 -0500 Subject: [PATCH 02/14] Update README.md --- README.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 27be542a4a..a05b7772ae 100644 --- a/README.md +++ b/README.md @@ -7,6 +7,8 @@ Loop is an app template for building an artificial pancreas. It is a stone resting on the boulders of work done by [@bewest](https://github.com/bewest/decoding-carelink), [@ps2](https://github.com/ps2/rileylink) and many others. +Loop is built on top of [LoopKit](https://github.com/LoopKit/LoopKit). LoopKit is a set of frameworks that provide data storage, retrieval, and calcluation, as well as boilerplate view controllers used in Loop. + Please understand that this project: - Is highly experimental - Is not approved for therapy @@ -66,13 +68,13 @@ Please understand that this project:
3. Early firmware (US <= 2.4A, AU/EUR <= 2.6A) is required for using Closed Loop and Bolus features.
4. It's not impossible, but comms-heavy and there's some work to be done. File an issue if you're someone who's up for the challenge and can test this hardware configuration. -### RileyLink +### Mac and XCode -Bluetooth LE communication with Minimed pumps is enabled by the [RileyLink](https://github.com/ps2/rileylink), a compact BLE-to-916MHz bridge device designed by the incredible [@ps2](https://github.com/ps2). Please visit the [repository](https://github.com/ps2/rileylink) and the [gitter room](https://gitter.im/ps2/rileylink) for more information. +To build Loop you will need a mac computer, and have Xcode 8 installed on it. You will need to use git, either from the command line, or with a GUI like the Github Desktop Client. -### LoopKit +### RileyLink -Loop is built on top of [LoopKit](https://github.com/LoopKit/LoopKit). LoopKit is a set of frameworks that provide data storage, retrieval, and calcluation, as well as boilerplate view controllers used in Loop. +Bluetooth LE communication with Minimed pumps is enabled by the [RileyLink](https://github.com/ps2/rileylink), a compact BLE-to-916MHz bridge device designed by the incredible [@ps2](https://github.com/ps2). Please visit the [repository](https://github.com/ps2/rileylink) and the [gitter room](https://gitter.im/ps2/rileylink) for more information. # Getting Started From b221ebc26b941a90cab6e544bcddfe4a21bae32c Mon Sep 17 00:00:00 2001 From: Pete Schwamb Date: Sat, 22 Oct 2016 15:12:05 -0500 Subject: [PATCH 03/14] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index a05b7772ae..45c987b0ca 100644 --- a/README.md +++ b/README.md @@ -70,7 +70,7 @@ Please understand that this project: ### Mac and XCode -To build Loop you will need a mac computer, and have Xcode 8 installed on it. You will need to use git, either from the command line, or with a GUI like the Github Desktop Client. +To build Loop you will need a mac computer, and have Xcode 8 installed on it. You will need to use git, either from the command line, or with a GUI like the Github Desktop Client. You can build Loop without an Apple Developer Account, but any apps built this way will expire after a week, so signing up for the $99 developer account is recommended. ### RileyLink From 4be7b4797b68162be24c65990ab656ad9bda8730 Mon Sep 17 00:00:00 2001 From: Pete Schwamb Date: Sat, 22 Oct 2016 15:14:02 -0500 Subject: [PATCH 04/14] Update README.md --- README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 45c987b0ca..1a7109b2a7 100644 --- a/README.md +++ b/README.md @@ -26,7 +26,7 @@ Please understand that this project: Screenshot of bolus failure notification on Apple Watch Screenshot of bolus failure notification on Apple Watch -## Requirements +# Requirements @@ -76,6 +76,10 @@ To build Loop you will need a mac computer, and have Xcode 8 installed on it. Y Bluetooth LE communication with Minimed pumps is enabled by the [RileyLink](https://github.com/ps2/rileylink), a compact BLE-to-916MHz bridge device designed by the incredible [@ps2](https://github.com/ps2). Please visit the [repository](https://github.com/ps2/rileylink) and the [gitter room](https://gitter.im/ps2/rileylink) for more information. +## Carthage + +[Carthage](https://github.com/carthage/carthage) is used to manage framework dependencies. It will need to be [installed on your Mac](https://github.com/carthage/carthage#installing-carthage) to build and run the app, but most users won't have a need to explicitly rebuild any dependencies. + # Getting Started Fork and clone this repository so you can commit the changes you'll make below. @@ -88,10 +92,6 @@ Fork and clone this repository so you can commit the changes you'll make below. Open `Loop.xcodeproj` in Xcode. In the Project Navigator on the left-hand side, open `Loop.xcconfig`. Change the value of `MAIN_APP_BUNDLE_IDENTIFIER` to a unique reverse-domain name of your choosing. -## Installing Carthage - -[Carthage](https://github.com/carthage/carthage) is used to manage framework dependencies. It will need to be [installed on your Mac](https://github.com/carthage/carthage#installing-carthage) to build and run the app, but most users won't have a need to explicitly rebuild any dependencies. - ## Configuring Services Loop optionally supports select third-party remote services, which are configured in the Settings screen. From 6c4b149118f3e0c414b2cfe0d67dd61bbc0c6316 Mon Sep 17 00:00:00 2001 From: Pete Schwamb Date: Sat, 22 Oct 2016 15:14:21 -0500 Subject: [PATCH 05/14] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1a7109b2a7..7379670eac 100644 --- a/README.md +++ b/README.md @@ -76,7 +76,7 @@ To build Loop you will need a mac computer, and have Xcode 8 installed on it. Y Bluetooth LE communication with Minimed pumps is enabled by the [RileyLink](https://github.com/ps2/rileylink), a compact BLE-to-916MHz bridge device designed by the incredible [@ps2](https://github.com/ps2). Please visit the [repository](https://github.com/ps2/rileylink) and the [gitter room](https://gitter.im/ps2/rileylink) for more information. -## Carthage +### Carthage [Carthage](https://github.com/carthage/carthage) is used to manage framework dependencies. It will need to be [installed on your Mac](https://github.com/carthage/carthage#installing-carthage) to build and run the app, but most users won't have a need to explicitly rebuild any dependencies. From 99def0c63f18980d79056f5b1736a191e60e2918 Mon Sep 17 00:00:00 2001 From: Pete Schwamb Date: Sat, 22 Oct 2016 15:21:31 -0500 Subject: [PATCH 06/14] Update README.md --- README.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 7379670eac..6ab0f099bb 100644 --- a/README.md +++ b/README.md @@ -68,9 +68,13 @@ Please understand that this project:
3. Early firmware (US <= 2.4A, AU/EUR <= 2.6A) is required for using Closed Loop and Bolus features.
4. It's not impossible, but comms-heavy and there's some work to be done. File an issue if you're someone who's up for the challenge and can test this hardware configuration. -### Mac and XCode +### Mac and Xcode -To build Loop you will need a mac computer, and have Xcode 8 installed on it. You will need to use git, either from the command line, or with a GUI like the Github Desktop Client. You can build Loop without an Apple Developer Account, but any apps built this way will expire after a week, so signing up for the $99 developer account is recommended. +To build Loop you will need a Mac, and have Xcode 8 installed on it. You will need to use git, either from the command line, or with a GUI like the Github Desktop Client. You can build Loop without an Apple Developer Account, but any apps built this way will expire after a week, so signing up for the $99 developer account is recommended. + +### iOS Phone + +Loop will run on on any iPhone that is compatible with iOS 10. ### RileyLink From ba24971221a93e29edb809cd66b823644bf8ffe6 Mon Sep 17 00:00:00 2001 From: Pete Schwamb Date: Mon, 31 Oct 2016 19:07:25 -0500 Subject: [PATCH 07/14] Update README.md --- README.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/README.md b/README.md index 6ab0f099bb..99020820e0 100644 --- a/README.md +++ b/README.md @@ -96,6 +96,10 @@ Fork and clone this repository so you can commit the changes you'll make below. Open `Loop.xcodeproj` in Xcode. In the Project Navigator on the left-hand side, open `Loop.xcconfig`. Change the value of `MAIN_APP_BUNDLE_IDENTIFIER` to a unique reverse-domain name of your choosing. +## In-App Setup + +Follow the instructions at [In-app-setup]. + ## Configuring Services Loop optionally supports select third-party remote services, which are configured in the Settings screen. From 570c36be1f5f7811e711a7de6011681f2659cea7 Mon Sep 17 00:00:00 2001 From: Pete Schwamb Date: Mon, 31 Oct 2016 19:08:01 -0500 Subject: [PATCH 08/14] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 99020820e0..2216ae4124 100644 --- a/README.md +++ b/README.md @@ -98,7 +98,7 @@ Open `Loop.xcodeproj` in Xcode. In the Project Navigator on the left-hand side, ## In-App Setup -Follow the instructions at [In-app-setup]. +Follow the instructions at [In-app-setup](In-app-setup). ## Configuring Services From a2faeeb87abbddf476aee08bc05a5f04d8cc3149 Mon Sep 17 00:00:00 2001 From: Pete Schwamb Date: Mon, 31 Oct 2016 19:11:58 -0500 Subject: [PATCH 09/14] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 2216ae4124..db26e03e4d 100644 --- a/README.md +++ b/README.md @@ -98,7 +98,7 @@ Open `Loop.xcodeproj` in Xcode. In the Project Navigator on the left-hand side, ## In-App Setup -Follow the instructions at [In-app-setup](In-app-setup). +Follow the instructions at [In-app-setup](https://github.com/LoopKit/Loop/wiki/In-app-setup). ## Configuring Services From 59cc7e3c95a30652e775ea863e29eefeaaf49322 Mon Sep 17 00:00:00 2001 From: Pete Schwamb Date: Mon, 31 Oct 2016 19:24:56 -0500 Subject: [PATCH 10/14] Update README.md --- README.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index db26e03e4d..f368e9e2cc 100644 --- a/README.md +++ b/README.md @@ -36,29 +36,29 @@ Please understand that this project: - - + + - - - - + + + + - - + + - - + +
MM 522/722MM 523/723MM 554/754MM 523/7233MM 554/7543
CGMDexcom G4✅1 2✅1 3✅1 3Dexcom G41 ✅2✅✅
Dexcom G5 ✅2✅3✅3✅✅
MM CGM ❌4✅3✅3✅✅
@@ -66,7 +66,7 @@ Please understand that this project:
1. Offline access to glucose requires a Receiver with Share and the [Share2 app](https://itunes.apple.com/us/app/dexcom-share2/id834775275?mt=8) to be running on the same device. Internet-dependent access via Share servers is also supported.
2. Pump must have a remote ID added in the [Remote Options](https://www.medtronicdiabetes.com/sites/default/files/library/download-library/workbooks/x22_menu_map.pdf) menu.
3. Early firmware (US <= 2.4A, AU/EUR <= 2.6A) is required for using Closed Loop and Bolus features. -
4. It's not impossible, but comms-heavy and there's some work to be done. File an issue if you're someone who's up for the challenge and can test this hardware configuration. +
4. It's not impossible, but comms-heavy and there's [some work to be done](https://github.com/LoopKit/Loop/issues/100). ### Mac and Xcode From 1eb4537827730d72fe973fa0eb60431bdb5eea7d Mon Sep 17 00:00:00 2001 From: Pete Schwamb Date: Mon, 31 Oct 2016 19:29:29 -0500 Subject: [PATCH 11/14] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index f368e9e2cc..867e28c2b9 100644 --- a/README.md +++ b/README.md @@ -86,7 +86,7 @@ Bluetooth LE communication with Minimed pumps is enabled by the [RileyLink](http # Getting Started -Fork and clone this repository so you can commit the changes you'll make below. +[Fork](https://help.github.com/articles/fork-a-repo/) and [clone](https://help.github.com/articles/cloning-a-repository/) this repository so you can commit the changes you'll make below. [Sign up for the Loop Users announcement list](https://groups.google.com/forum/#!forum/loop-ios-users) to stay informed of critical issues that may arise. From 4b50da6e84460c4140bf37cf21b441f4728df600 Mon Sep 17 00:00:00 2001 From: Pete Schwamb Date: Mon, 31 Oct 2016 20:05:45 -0500 Subject: [PATCH 12/14] Update README.md --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 867e28c2b9..3507e11c72 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@ [![Build Status](https://travis-ci.org/LoopKit/Loop.svg?branch=master)](https://travis-ci.org/LoopKit/Loop) [![Join the chat at https://gitter.im/LoopKit/Loop](https://badges.gitter.im/LoopKit/Loop.svg)](https://gitter.im/LoopKit/Loop?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) -Loop is an app template for building an artificial pancreas. It is a stone resting on the boulders of work done by [@bewest](https://github.com/bewest/decoding-carelink), [@ps2](https://github.com/ps2/rileylink) and many others. +Loop is an app template for building an automated insulin delivery system. It is a stone resting on the boulders of work done by many others. Loop is built on top of [LoopKit](https://github.com/LoopKit/LoopKit). LoopKit is a set of frameworks that provide data storage, retrieval, and calcluation, as well as boilerplate view controllers used in Loop. @@ -78,7 +78,7 @@ Loop will run on on any iPhone that is compatible with iOS 10. ### RileyLink -Bluetooth LE communication with Minimed pumps is enabled by the [RileyLink](https://github.com/ps2/rileylink), a compact BLE-to-916MHz bridge device designed by the incredible [@ps2](https://github.com/ps2). Please visit the [repository](https://github.com/ps2/rileylink) and the [gitter room](https://gitter.im/ps2/rileylink) for more information. +Bluetooth LE communication with Minimed pumps is enabled by the [RileyLink](https://github.com/ps2/rileylink), a compact BLE-to-916MHz bridge device designed by [@ps2](https://github.com/ps2). Please visit the [repository](https://github.com/ps2/rileylink) and the [gitter room](https://gitter.im/ps2/rileylink) for more information. ### Carthage From 5d88519aba198d4f40343385b707ad1882dfb0bc Mon Sep 17 00:00:00 2001 From: Pete Schwamb Date: Tue, 1 Nov 2016 08:56:49 -0500 Subject: [PATCH 13/14] Update README.md --- README.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 3507e11c72..8f1f1526fe 100644 --- a/README.md +++ b/README.md @@ -32,10 +32,11 @@ Please understand that this project: - Insulin Pump + Insulin Pump - MM 522/722 + MM 515/7152 + MM 522/7222 MM 523/7233 MM 554/7543 @@ -44,18 +45,21 @@ Please understand that this project: CGM Dexcom G41 - ✅2 + ✅ + ✅ ✅ ✅ Dexcom G5 - ✅2 + ✅ + ✅ ✅ ✅ MM CGM + ❌ ❌4 ✅ ✅ From 08719e2d0586b781a30e06705eeb14d1a60b5118 Mon Sep 17 00:00:00 2001 From: katie disimone Date: Tue, 1 Nov 2016 18:04:11 -0700 Subject: [PATCH 14/14] Update for Guide link --- README.md | 29 +++-------------------------- 1 file changed, 3 insertions(+), 26 deletions(-) diff --git a/README.md b/README.md index 8f1f1526fe..de872c6df1 100644 --- a/README.md +++ b/README.md @@ -74,7 +74,7 @@ Please understand that this project: ### Mac and Xcode -To build Loop you will need a Mac, and have Xcode 8 installed on it. You will need to use git, either from the command line, or with a GUI like the Github Desktop Client. You can build Loop without an Apple Developer Account, but any apps built this way will expire after a week, so signing up for the $99 developer account is recommended. +To build Loop you will need a Mac, and have Xcode 8 installed on it. You can build Loop without an Apple Developer Account, but any apps built this way will expire after a week, so signing up for the $99 developer account is recommended. ### iOS Phone @@ -90,34 +90,11 @@ Bluetooth LE communication with Minimed pumps is enabled by the [RileyLink](http # Getting Started -[Fork](https://help.github.com/articles/fork-a-repo/) and [clone](https://help.github.com/articles/cloning-a-repository/) this repository so you can commit the changes you'll make below. - [Sign up for the Loop Users announcement list](https://groups.google.com/forum/#!forum/loop-ios-users) to stay informed of critical issues that may arise. -## Assigning a Bundle Identifier - -[![Assigning a bundle identifier](/Documentation/Assigning%20a%20bundle%20identifier.png?raw=true)](/Documentation/Assigning%20a%20bundle%20identifier.png) - -Open `Loop.xcodeproj` in Xcode. In the Project Navigator on the left-hand side, open `Loop.xcconfig`. Change the value of `MAIN_APP_BUNDLE_IDENTIFIER` to a unique reverse-domain name of your choosing. - -## In-App Setup - -Follow the instructions at [In-app-setup](https://github.com/LoopKit/Loop/wiki/In-app-setup). - -## Configuring Services - -Loop optionally supports select third-party remote services, which are configured in the Settings screen. - -| Service | Description -| ---------------------- | ------------- -| Dexcom Share | Downloads glucose data if a local G5 Transmitter or G4 Receiver with Share is not available. -| Nightscout | Uploads treatments and other pump data. Note that you will need to set "Nightscout history uploading" to "On" in Settings for treatments to be fetched from your pump and uploaded to Nightscout. -| mLab | Uploads diagnostic data about each loop run, as well as app errors. At this time, it is strongly recommended that you configure this service in case retrospective analysis is needed. -| Amplitude | Tracks private, single-user behavioral and system analytics (no health data is sent) - -# Making it Your Own +[Please visit the Wiki for a "Guide to Loop" setup, installation, FAQs, and use.](https://github.com/LoopKit/Loop/wiki) -[Please visit the Wiki for more info on customizing the app](https://github.com/LoopKit/Loop/wiki/Personalizing-Your-App-Name-&-Icon) +(Note: there is also a tab for the Wiki at the top of this page) # License and Code of Conduct