Resources

• Making your first PR (pull request)
• Advanced tips for adding multiple images to documentation
• For Clinicians – A General Introduction and Guide to OpenAPS
  • The steps for building a DIY Closed Loop:
  • How A DIY Closed Loop Works
  • How data is gathered:
  • How does it know what to do?
  • Examples of OpenAPS algorithm decision making:
    • Here are examples of the purple prediction lines, and how they might differ:
    • Here are examples of different time frames that influence the needed adjustments to insulin delivery:
    • Scenario 1 - Zero Temp for safety
    • Scenario 2 - Zero temp for safety
    • Scenario 3 - More insulin needed
    • Scenario 4 - Low temping for safety
  • Optimizing settings and making changes
  • Summary
• Technical Resources
  • Raspberry Pi
  • Git and GitHub
  • Linux Shell / Terminal
  • Python
  • Useful Apps
  • Markdown syntax
• Medtronic Button Error Troubleshooting
• Troubleshooting
  • Generally useful linux commands
  • Dealing with npm run global-install errors
  • Dealing with a corrupted git repository
  • Debugging Disk Space Issues
  • Environment variables
  • Wifi and hotspot issues
    • My wifi connection keeps dropping or I keep getting kicked out of ssh
    • I forget to switch back to home wifi and it runs up my data plan
    • I am having trouble consistently connecting to my wifi hotspot when I leave the house
    • I am not able to connect to my wireless access point on my iPhone
  • Common error messages
    • Permission not allowed
    • ValueError: need more than 0 values to unpack
    • Unable to upload to Nightscout
    • No JSON object could be decoded
    • json: error: input is not JSON
    • TypeError: Cannot read property ‘zzzz’ of undefined
    • Could not parse carbratio date when invoking profile report
    • Could not get subg rfspy state or version ccprog or cannot connect to CC111x radio
      • Using an Intel Edision + Explorer Block:
      • Using a Raspberry Pi + Explorer HAT:
    • Monitor/mmtune.json is empty or does not exist
      • Only verified to work with Intel Edison + Explorer Block
  • Dealing with the CareLink USB Stick
• OpenAPS Overview and Project History
• Glossary
  • AP and OpenAPS high-level terminology
  • OpenAPS-specific terminology
• Tips for switching from another DIY closed loop system to OpenAPS rig (or running both)
  • Other things you should know before starting:
  • Main Hardware Differences:
  • Assumptions for this Cheat Sheet Guide
  • High Level Recommended Rig parts list
  • Getting started on OpenAPS - the setup links
    • Building your Rig:
    • Flashing your rig:
    • Nightscout
    • Installing oref0/”installing the loop”
    • Personalizing your loop:
  • The big differences between Loop and OpenAPS:
    • Targets and algorithm differences
    • “MaxIOB” and other safety settings
      • MaxIOB
      • Other safety settings
    • Parents in particular may want to review the optional settings
    • Connectivity
    • Carbs
    • Boluses and how OpenAPS gets pump history
    • Multiple rigs
    • Troubleshooting
  • Running multiple kinds of DIY systems
    • Ready to get started with OpenAPS?
    • Where to get help with OpenAPS setup and maintenance:
• Manual Edison Flashing instructions - all computer types
  • Helpful notes before you get started
  • Prerequisites
    • If you’re using a Raspberry Pi - prerequisites:
    • If you’re using a Windows PC - prerequisites:
    • If you’re using a Mac to flash - prerequisites:
  • Downloading image
    • Jubilinux
  • Connecting cables and starting console
    • If you’re using a Raspberry Pi for console:
    • If you’re using a Windows PC for console:
    • If you’re using a Mac for console:
    • All platforms:
  • Flashing image onto the Edison
    • If you’re using a Raspberry Pi - starting flash:
    • If you’re using a Mac - starting flash:
    • If you’re using a Windows PC - starting flash:
    • All platforms:
  • Initial Edison Setup
  • Set up Wifi:
  • Install packages, ssh keys, and other settings
  • Troubleshooting
    • Troubleshooting the flash process
    • Troubleshooting rescue mode
    • Override DNS resolvers
    • IP address conflicts (able to ping external but not LAN addresses)
    • Interrupting Kernel Messages in Console/Screen Mode
      • Fix for individual console/screen session:
      • Permanent solution:
• Manual Edison Flashing instructions - FOR MAC
  • Hardware Assumptions for this page
  • High Level Recommended Rig parts list
  • Getting Physical: Build your rig/put the physical pieces together
    • Attach your battery into the explorer board plug.
  • Software-build your rig
    • 1. Preparing/flashing the Edison/reflashing the Edison
      • 1-1. Install homebrew
      • 1-2. Install a bunch of other stuff (dfu-util, coreutils, gnu-getopt)
      • 1-3. Install lsusb
      • 1-4. Start Edison in screen mode
      • 1-5. Flash the Edison
      • 1-6. Return to the other Terminal Window that we left off of in Step 4.
      • 1-7. Now we wait and watch.
      • 1-8. Wifi for Edison
      • 1-9. Multiple wifi networks
      • 1-10. Installing packages, SSH keys, and other settings
    • 2. Installing the looping script (openaps-setup.sh)
    • 3. Personalizing your settings
• Manual Edison Flashing instructions - FOR WINDOWS
  • Hardware Assumptions for this page
  • Preparing/flashing the Edison
    • 1-1 Prepare Windows Computer
      • Side Note regarding computers with less than 6 GB RAM
      • Download jubilinux and dfu-util
    • 1-2 Prepare Edison
    • 1-3 Flash the Edison
      • Errors when flashing the rig
    • 1-4 Hostname for Edison
    • 1.5 Set up Wifi
    • 1.6 Test internet connection
    • 1.7 Install packages, ssh keys, and other settings
• Deprecated: Pi Hardware info
  • WARNING: THIS SETUP IS CURRENTLY DEPRECATED AND NOT RECOMMENDED (July 2017)
  • Raspberry Pi 2
  • Raspberry Pi 3 Model B
  • CareLink USB Stick - NOT RECOMMENDED
  • Recommended alternative to Carelink USB - Use a TI stick
  • Micro SD Card
  • WiFi Adapter (Raspberry Pi 2 only)
  • 2.1 Amp USB Battery Power Supply
  • USB Cables
  • Cases
  • HDMI Cable, USB Keyboard, USB Mouse
• Setting Up Your Raspberry Pi
  • WARNING - THIS DOCUMENT IS DEPRECATED (NOT RECOMMENDED) AND UNMAINTAINED. We suggest you look to the top of the docs for information on the currently recommended hardware setup instead. As of November 2017 there are new and simplified Raspberry Pi setup instructions linked from there. The instructions below should only be used for troubleshooting purposes if the new instructions aren’t working.
  • Newer Path
    • Newer Path: Setting Up Your Raspberry Pi using Windows
      • Newer Path: Setup your TI cc1111 radio stick
    • Newer Path: Install Raspian (Jessie) on your Pi
      • Using Pixal:
    • Newer Path: Update the repository and upgrade the installed packages:
    • Newer Path: Update Firmware
    • Newer Path: Find I.P. address
    • Newer Path: Disable Network Power Managemen
    • NOTE IT IS CRITICAL it goes just below ‘iface wlan0 inet manual’ If you put it above this line your Pi Wifi will not work!
    • Newer Path: Setup network wpa_supplicant
      • Note: I set up a wifi and a wifi hotspot (phone)
      • Note: Where I use “ “ they are to be included
      • Exit and save
    • Newer Path Setup Network Interface
      • Newer Path: Match the following.
    • Newer Path: Configure USB tethering on newer androids [optional]
    • Newer Path: Wifi and Hotspot auto restart
      • This will create the file
    • Newer Path: Turn off GUI interface
    • Newer Path - install openaps dependencies and install oref0
    • Newer Path - Optional Installs
      • Enable watchdog
      • newer Path - Make sure GPIO library is installed
      • Newer Path - Configure Bluetooth Low Energy tethering [optional]
      • Newer Path - App to check core temp (optional)
• Older instructions for original Pi-based setups
  • Download and Install Raspbian Jessie
    • Download Raspbian
    • Write Raspbian to the Micro SD Card
      • Detailed Windows Instructions
  • Connect and configure WiFi
    • Path 1: Keyboard, Mouse, and HDMI monitor/TV
    • Path 2: Console or Ethernet cable
      • Configure WiFi Settings
    • Path 3: Headless WiFi configuration (Windows/Linux only)
  • Test SSH Access
    • Windows
    • Mac OS X / Linux
    • iOS
    • Android
  • Configure the Raspberry Pi
    • Verify your Raspbian Version
    • Run raspi-config
    • Note on Time Zone
    • Note on Date and Time in Event of Power Compromise
  • Setting up an SSH key for Password-less Login [optional]
    • Windows
    • Mac and Linux
  • Wifi reliability tweaks [optional]
  • Watchdog [optional]
  • Update the Raspberry Pi [optional]
  • Disable HDMI to conserve power [optional]
  • Configure Bluetooth Low Energy tethering [optional]

Prev.: Ways to Contribute to OpenAPS

Next: Making your first PR (pull request)

​