Merge pull request #1 from LoopKit/master

Updated new Omnipod updates

Author: Lytrix

docs/faqs/FAQs.md

@@ -72,6 +72,10 @@ The short answer is (1) when you first build and (2) once per year minimum after
 
 The longer answer is that Loop code is updated periodically to include new features and bug fixes.  When those updates are released, you'll need access to an Apple computer again to update your Loop app.  Loop updates are not available through the iPhone's app store...instead you do the app upate yourself with [update instructions here](https://loopkit.github.io/loopdocs/setup/update/updating/). In general, probably a few times a year there are updates to Loop released that you'd want to take the time to install.
 
+## Can I use a VirtualMachine to build?
+
+Yes, you can. These documents will not provide instructions on how to do that however. You'll need to figure that part out on your own.
+
 ## Will I need to build a new Loop if I switch between Medtronic and Omnipod regularly?
 
 No. Loop will have the option to move between different pump types from within the same Loop app.
@@ -88,6 +92,8 @@ Moral of the story, out of all the ways to save money...borrowing someone's deve
 
 There is a [whole page about MDT pumps](https://loopkit.github.io/loopdocs/setup/requirements/mdt-pump/); how to find them, how to find supplies, and assessing whether your Medtronic pump is compatible. Go check out that page for more info.
 
+With the addition of omnipod support, you can also now use omnipod suppliers however you'd normally source them.
+
 ## Can I pay someone else to do this?
 
 NOOOO...you really need to figure this out yourself. This is an automated insulin delivery system and you really need to know how to build and operate this yourself.
@@ -96,7 +102,7 @@ NOOOO...you really need to figure this out yourself. This is an automated insuli
 
 For Medtronic users, you simply go back to old school pump use until you get a new RileyLink. You can either let your temp basal finish by itself (30 minutes or less) or cancel the temp basal on the pump's menu. For bolusing, you'd go back to using the pump's blus commands. When you get a RileyLink (either finding your old one or getting your backup RileyLink out) and Loop running again, you'll want to do one thing. Enter in any carbs to Loop that you may have eaten in the recent past that could still be affecting blood glucose. While Loop will read whatever insulin deliveries had happened while the RileyLink was missing, it will not read any carbs you entered into the pump...so make sure to add those to Loop and backdate them to the time they were eaten. That will help make the transition smoother to Looping again.
 
-For pod users, your pod will finish any currently running temporary basal rate and then revert back to your scheduled basal rate. Without a RileyLink, you will not be able to affect any pod use; no basal changes, suspends, or boluses. If you only have a backup RileyLink, you can simply connect to the new RileyLink on the same Loop app and it will work with the existing pod session. If you don't have a backup RileyLink, you'll have to remove the pod and start a new pod paired with your PDM until you get a new RileyLink.
+For pod users, your pod will finish any currently running temporary basal rate and then revert back to your scheduled basal rate. Without a RileyLink, you will not be able to affect any pod use; no basal changes, suspends, or boluses. If you have a backup RileyLink, you can simply connect to the new RileyLink on the same Loop app and it will work with the existing pod session. If you don't have a backup RileyLink, you'll have to remove the pod and start a new pod paired with your PDM until you get a new RileyLink.
 
 ## What if I lose or get a new iPhone?
 

docs/faqs/cgm-faqs.md

@@ -0,0 +1,21 @@
+# CGM FAQs
+
+## What CGMs does Loop work with?
+
+Loop works Dexcom G4 with share, G5, G6, Share and the Medtronic CGM systems compatible with Looping pumps.
+
+Read the details [here](https://loopkit.github.io/loopdocs/setup/requirements/cgm/).
+
+## Can I use Libre sensors with a reader like Miao Miao?
+
+If you want to use a sensor, such as Libre, you will need to modify Loop to accomplish that use. Loop code does not natively support that sensor, nor reader. 
+
+## Can Loop read CGM data from Nightscout?
+
+Loop does not read from, nor upload to, CGM data for Nightscout. You would need to use a solution such as NightscoutShareServer and make changes to Loop code in order to do that. Please search the Looped group in Facebook for posts regarding that option, as it is not a part of standard Loop use and is a community-based modification. You will need to do your homework and research to make that happen.
+
+## Can Spike or Xdrip be used with Loop?
+
+Spike and Xdrip are not supported by Loop. You will need to implement community-based modifications to Loop in order to use those apps with Loop. Please search the Looped group in Facebook for posts regarding those options, as they are not a part of standrad Loop use.
+
+

docs/faqs/omnipod-faqs.md

@@ -2,11 +2,11 @@
 
 ## Is Omnipod supported on Loop?
 
-No, not yet. Omnipod has been in the process of being "hacked" for several years now and this has been a tremendous amount of work. The work has been fruitful...but it is not ready for public release yet. When it is ready, we promise to update these documents with instructions and information about Omnipod Loop.
+No, not yet. But, VERY soon. Omnipod has been in the process of being "hacked" for several years now and this has been a tremendous amount of work. The work has been fruitful...but it is not ready for public release yet. When it is ready, we promise to update these documents with instructions and information about Omnipod Loop.
 
 ## Which pods will work with Loop?
 
-The Loop system described in these documents (aka DIY Loop) will work with Eros pods...these are the current pods on the market in wide release.  The newer DASH pods will not be compatible with DIY Loop.  Tidepool has begun a process to bring [DIY Loop through FDA approval](https://tidepool.org/blog/tidepool-delivering-loop) and Insulet has been announced as the [first pump partner for that project](https://diatribe.org/omnipod-first-insulin-pump-partner-tidepool-loop). Tidepool Loop will be using DASH pods, no RileyLink required.  If you would like to stay informed about Tidepool Loop progress, you can fill out an interest form [here](https://tidepool.org/loop). 
+The Loop system described in these documents (aka DIY Loop) will work with Eros pods...these are the current pods on the market in wide release. The newer DASH pods will not be compatible with DIY Loop. Tidepool has begun a process to bring [DIY Loop through FDA approval](https://tidepool.org/blog/tidepool-delivering-loop) and Insulet has been announced as the [first pump partner for that project](https://diatribe.org/omnipod-first-insulin-pump-partner-tidepool-loop). Tidepool Loop will be using DASH pods, no RileyLink required.  If you would like to stay informed about Tidepool Loop progress, you can fill out an interest form [here](https://tidepool.org/loop). 
 
 Summary of eventual systems:
 
@@ -15,7 +15,7 @@ Summary of eventual systems:
 
 ## Do I still need a PDM with Omnipod Loop?
 
-No, pods are monogamous little creatures. They will pair with only one device at a time for safety reasons...so a pod is either paired with a PDM or your Loop app on your iPhone. When Loop is ready for Omnipod, it will not use a PDM...and in fact you cannot use a PDM for a pod that has been activated with Loop. That doesn't mean you should get rid of your PDM. You should still keep it around in case your lose your phone or lose your RileyLink. You'd want to swap out to a new pod and pair it with the PDM if you lose a critical part of your Omnipod Loop gear.
+No, pods are monogamous little creatures. They will pair with only one device at a time for safety reasons...so a pod is either paired with a PDM or your Loop app on your iPhone. In other words, your PDM can stay in the diabetes closet while you are Looping. You cannot use the PDM for a pod that has been activated with Loop. That doesn't mean you should get rid of your PDM. Instead, keep it for backup situations if you lose your phone. See below for what to do if you lose your phone or RileyLink. 
 
 ## Can I cancel a temp basal Loop sets? How about a bolus?
 
@@ -28,13 +28,19 @@ Yes, you will be able to cancel a temp basal or a bolus in progress. There is a
 Insulin will remain suspended until the user either clicks on the "Tap to Resume" command from Loop's main screen or the "resume delivery" command accessed by tapping the pod age icon. Once insulin delivery is resumed, you will be resumed at your scheduled basal rate. If a bolus was interrupted, the bolus will not resume. If you don't turn on open loop mode, within 5 minutes of resuming insulin delivery, your Loop should resume automatic temp basal adjustments.
 
 ## What if I lose my phone or RileyLink?
-For pod users, your pod will finish any currently running temporary basal rate and then revert back to your scheduled basal rate. Without a phone or RileyLink however, you will not be able to affect any pod use; no basal change, suspend, or bolus. You will need to remove the Loop pod and put on a new pod paired with your PDM until you can get a new RileyLink and/or phone. If you only have lost the RileyLink (not the phone) and have a backup RileyLink, you can simply connect to the new RileyLink on the same Loop app and it will work with the existing pod session.
+For pod users, your pod will finish any currently running temporary basal rate and then revert back to your scheduled basal rate. Without a phone or RileyLink however, you will not be able to affect any pod use; no basal change, suspend, cancel, or bolus. To do anything other than let basals continue, you will need to take action depending on the situation.
+
+* Lost RileyLink only: You can find replace your missing RileyLink with one from your backup supplies. No problem to switch out to a different Rileylink mid-pod session. If you don't have a backup RileyLink to use, then you will need to remove the pod and put on a new pod paired with your PDM until you can get a new RileyLink.
+
+* Lost iPhone only: You will need to remove the pod and put on a new pod paired with your PDM until you can get a new phone and Loop app built onto it.
+
+* Lost both RileyLink and phone: You're having a really bad day. You'll need a hug and follow the same directions as if you lost the phone as shown in the bullet above.
 
 ## Is there an increase in pod failures on Loop?
-Yes, likely there will be an increase in your usual pod failure ("screaming pod") rate. The pod communications are a bit "neurotic" and full of safety checks to make sure the pod and PDM/phone are on the same page. Recreating these safety checks and communications have been the reason why the development of this pump on Loop has been so long and cumbersome. There are built-in pod errors within the pod's firmware so that it errors (screams) anytime it is uncertain of its status. With Loop communicating every 5 minutes with the pod, this increases the chances of a pod "scream". You should make sure you have adequate pod supplies long term to cover this potential increase in failure. As well, you should make sure to travel with backup pods day-to-day (although you are probably already doing that).
+In the early stages of development, there were. Thankfully to the hard work of Pete Schwamb and others, pod failure rate is now no longer increased compared to typical pod use with a PDM.
 
 ## What do you do to stop a screaming pod?
-Screaming pods can be silenced by carrying a paperclip. Simply put the paperclip in the small hole that is on the bottom (the side opposite where the cannula is) of the pod as shown. Push the paperclip in until you hear a little click, that click is breaking the circuit that let's the audible scream go.
+Screaming pods can be silenced by carrying a paperclip. Simply put the paperclip in the small hole that is on the bottom (the side opposite where the cannula is) of the pod as shown. Push the paperclip in until you hear a little click, that click is breaking the circuit that let's the audible scream go. 
 
 <p align="center">
 <img src="../img/paperclip.jpg" width="500">

docs/operation/loop-settings/cgm.md

@@ -39,4 +39,4 @@ Users who are using Spike app to access other CGM types (or to avoid using the D
 
 ## Next Step: Configuration
 
-Now that you have added your CGM source, we need to complete the configuration and settings in your Loop. Please head over to the [Configuration page](https://loopkit.github.io/loopdocs/operation/loop-settings/configuration) for guidance with this important part of Loop's setup.
+Now that you have added your CGM source, we need to complete the configuration and settings in your Loop. Please head over to the [Configuration page](https://loopkit.github.io/loopdocs/operation/loop-settings/configurations/) for guidance with this important part of Loop's setup.

docs/setup/requirements/computer.md

@@ -1,29 +1,39 @@
 # Apple Computer
 
-Apple regularly updates their iPhone software (iOS), computer software (macOS) and Xcode application.  Loop's team of developers works hard to update Loop code as the new Apple updates are pushed out.
+Apple regularly updates their iPhone software (iOS), computer software (macOS) and Xcode application.  Loop's developers work hard to update Loop code as the new Apple updates are pushed out.
+
+**Do not install beta releases of Xcode, iOS or macOS on devices running or building Loop.** 
 
 ********
-The most recent version of iOS is 12.1.4
+The most recent version of iOS is 12.2
 
-The most recent version of macOS is 10.14.3
+The most recent version of macOS is 10.14.4
 
-The most recent version of Xcode is 10.1
+The most recent version of Xcode is 10.12.1
 
-The most recent version of Loop is 1.9.4
+The most recent version of Loop is 1.9.5
 
-The most recent version of watchOS is 5.1.3
+The most recent version of watchOS is 5.2
 *********
 
-The way Apple updates tend to happen is that one equipment's update will tend to require updating other pieces of Apple equipment.  For example, if you update your iOS on the iPhone, you may need an updated version of Xcode to install a new Loop app onto your phone.  And the new Xcode will require the volunteer developers of Loop to make updates to the Loop source code.  Finally, new Xcode updates also frequently come with macOS updates on your computer.
+The way Apple updates happen is that one equipment's update will tend to require updating other pieces of Apple equipment. For example, if you update your iOS on the iPhone, you may need an updated version of Xcode to install a new Loop app onto your phone.  And the new Xcode will require the developers of Loop to make updates to the Loop source code.  Finally, new Xcode updates also frequently require macOS updates on your computer.
+
+## When can you use Xcode 10.1 and macOS 10.13.6?
+These versions are being phased out because Apple has moved onto newer versions. For now, if you can't upgrade your Apple computer to Mojave (and are stuck at macOS 10.13.6), you can still build so long as you:
 
-**Currently, if you have iOS 12 or newer on your iPhone, at a minimum you will need Xcode 10.1 and High Sierra macOS 10.13.6 to be able to build Loop 1.9.4.  Older versions of macOS or Xcode are not compatible with the current Loop version on iOS 12.**
+* Use Loop master branch (so you will be able to use Omnipod Loop or Loop dev branches)
+* Have not updated your iPhone to iOS 12.2
 
-Do not install beta releases of Xcode, iOS or macOS on devices running Loop.  
+If you want to use omnipod or Loop-dev branches, you will have to use Mojave macOS and Xcode 10.2.
+If you updated your iPhone to iOS 12.2, you will also have to use Mojave macOS and Xcode 10.2
 
-If you are considering an update to your Loop app, check to make sure your computer and Xcode have any available updates installed prior to building the new app.
+## Omnipod and dev users
+In order to build Omnipod Loop, you will be required to use macOS 10.4.3 (Mojave) and Xcode 10.2 at a minimum. The version of Loop that supports Omnipod and Loop's dev branch both require the updated versions of macOS and Xcode.
 
+## Computer access
 Computer access is only required when you are initially installing the Loop app, updating to a newer release, or making changes to the underlying Loop code.  You do NOT need access to an Apple computer in order to troubleshoot or change Loop settings, such as basal profiles or carb ratios.
 
+## Finding your macOS version
 Where can you find your computer’s macOS version?  Click on the Apple icon in the upper left corner of your Mac’s display.  Select “About This Mac” from the dropdown menu, and it will display the macOS version number.
 
 <p align="center">
@@ -32,4 +42,3 @@ Where can you find your computer’s macOS version?  Click on the Apple icon in
 
 If your computer is running an out-of-date macOS, you can read whether you can upgrade to the latest macOS version [here](http://www.apple.com/macos/how-to-upgrade/#hardware-requirements).  The degree to which you can upgrade an older Apple computer will depend on the age and model of the computer.
 
-Please note that for now, Xcode 10.1 will still install on computers using the last High Sierra update (macOS 10.13.6).  This will inevitably change in the near future, as Mojave has replaced High Sierra for Apple's most recent macOS system.  Therefore, Mojave (macOS 14) will eventually be a minimum requirement to build Loop app, likely with the next major Xcode update.  

docs/setup/requirements/img/macosx.png

@@ -1,6 +1,6 @@
 # iPhone or iPod Touch
 
-Loop will run on on any iPhone or iPod Touch that is running iOS 11.1 or later, but the most current version is iOS 12.1.4. Therefore, compatible devices include:
+Loop will run on on any iPhone or iPod Touch that is running iOS 12 or later, but the most current version is iOS 12.2. Therefore, compatible devices include:
 
 * iPhone X, XS, XR, XS Max
 
@@ -16,11 +16,17 @@ Loop will run on on any iPhone or iPod Touch that is running iOS 11.1 or later,
 
 * iPod Touch, 6th generation or newer
 
-Does Loop work on iPads? No. Loop needs Apple's Health app to be on the device in order for Loop to access and store your insulin, blood glucose, and carbohydrate data for looping. Therefore, Loop does not work on iPads because they do not have Health capabilities.
+!!!info "Attention: iOS 12.2 users"
+    If you are using iOS 12.2, you will need to use macOS 10.14.3 (Mojave) and Xcode 10.2 at a minimum.
 
-Does Loop work on Android phones? No. Loop is written in Swift language for iOS devices, and needs Health integration (see comment above about iPads).
+## Does Loop work on iPads? 
+No. Loop needs Apple's Health app to be on the device in order for Loop to access and store your insulin, blood glucose, and carbohydrate data for looping. Therefore, Loop does not work on iPads because they do not have Health capabilities.
 
-Where can you find your iPhone’s iOS version?  Go to your iPhone’s Settings>General>About.  The iOS will be listed under “Version”
+## Does Loop work on Android phones? 
+No. Loop is written in Swift language for iOS devices, and needs Health integration (see comment above about iPads).
+
+## Where can you find your iPhone’s iOS version?  
+Go to your iPhone’s Settings>General>About.  The iOS will be listed under “Version”
 
 <p align="center">
 <img src="../img/ios.png" width="250">