diff --git a/.gitignore b/.gitignore
index 95a36d069..4a31df57b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -15,3 +15,4 @@ _book
*.mobi
*.pdf
.*.sw[op]
+build/
diff --git a/Makefile b/Makefile
index cd56958a6..17f835c27 100644
--- a/Makefile
+++ b/Makefile
@@ -220,6 +220,6 @@ pseudoxml:
.PHONY: serve
serve:
@echo
- make clean build html
+ make clean html
(cd $(BUILDDIR)/html/; python -m SimpleHTTPServer 8000 )
diff --git a/docs/conf.py b/docs/conf.py
index a21419c34..e718624c7 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -40,6 +40,7 @@
'sphinx.ext.ifconfig',
'sphinx.ext.autodoc',
'sphinx.ext.todo',
+ 'sphinx_markdown_tables',
# 'alabaster',
]
diff --git a/docs/docs/Customize-Iterate/bluetooth-tethering-edison.md b/docs/docs/Customize-Iterate/bluetooth-tethering-edison.md
index 9400ae9bf..8948c6bd4 100644
--- a/docs/docs/Customize-Iterate/bluetooth-tethering-edison.md
+++ b/docs/docs/Customize-Iterate/bluetooth-tethering-edison.md
@@ -32,35 +32,32 @@ Below is an image that shows how a rig automatically switches from a known wifi
Certain phones don't work well using bluetooth tethering with OpenAPS. Various users have experimented, and the list below shows those that have been found to work okay, those that don't and those with variable effectiveness. If you have something that is not on the list, please feel free to add it.
-
-Cellphone | Works with Bluetooth Tethering? | Issues/Experiences with BT | Use with xDrip/xDripAPS and Dexcom G5
- |
---|
Google Pixel 3XL with Android 9 | Yes | Supports tethering to both Wifi and Cellular network. No issues switching. |
- |
---|
Google Pixel 2 with Android 8 | Yes | Supports tethering to both Wifi and Cellular network. No issues switching. |
- |
---|
LG Nexus 5X with Android 7 | Yes | Supports tethering to both Wifi and Cellular network. No issues switching. | Works well with Dexcom G5 and xDrip. No issues with compatibility. 90%+ capture rate.
- |
---|
Google Pixel with Android 7 | Yes | Supports tethering to both Wifi and Cellular network. No issues switching. | Works well with Dexcom G5 and xDrip. No issues with compatibility. 90%+ capture rate.
- |
---|
Sony Xperia Z5 Compact with Android 7 | Yes | Works with tethering for network access. It regularly disconnects from the rig (which doesn't seem to affect data flow) and roughly every 24-36 hours this results in complete loss of connectivity and requires a full reboot of the rig and the phone. Doesn't work well with phone swapping between Wifi and mobile - causes BT dropouts that require a reboot of the rig. | No issues running xDrip/xDripAPS alongside the tethered connection. Achieves 90%+ packet collection from Dexcom G5.
- |
---|
Xiaomi Redmi 4 with MIUI 8 (Android 6) | No | Tethering can be set up, but it drops regularly requiring rig reboots. When phone switches between Wifi and cellular signal requires rig to be rebooted. | Significant packet drops and data becomes almost unusable.
- |
---|
Xiaomi Redmi Note 4(X) -Snapdragon SoC version!!! | Yes | Tethering works in same time with Blukon(Nightrider) and SW3 connected. Also, read Notes for MIUI below* | Excellent coverage.
- |
---|
Xiaomi Redmi 3 with MIUI 6 (Android 5) | Yes | No issues seen when tethered to cellular network. Doesn't allow tethering to wifi. | Works fine with Dexcom G5 - 90% collection rate.
- |
---|
Xiaomi Mi A1 with AndroidOne (vanilla Android 8.0) | Yes | OpenAPS bluetooth tethering works fine with Blue Car Autotether. | Not tested with Dexcom.
- |
---|
Samsung Galaxy S6 (Android 7) | Yes | Tethering to rig and cellular works okay. No data on swapping between cellular and wifi connections. | Use with Dexcom G5 and rig not effective. Significant packet loss.
- |
---|
Samsung Galaxy Junior | Yes | Phone tethering switching between wifi and mobile not elegant and causes some issues | Difficulties found when using xDrip with the OpenAPS tethering. Packet loss occurs.
- |
---|
iPhone | Yes | Users have experienced various levels of success with the iPhone bluetooth tethering and when the rig switches between wifi and BT | Not Applicable. Experimental version of Loop to do something similar doesn't yet have feedback.
- |
---|
Acer Phone | No | Many data drops on the bluetooth connection for rig. Recommended to avoid. | xDrip compatibility is poor - numerous drops throughout the day.
- |
---|
Samsumg Galaxy S7 Edge (G935F) Android 7.0 | Yes | Excellent BT tether using apps 'Bt AutoTether' and 'BT Tether' | xDrip+ with G5 > 95% capture.
- |
---|
Samsung Galaxy A3 (2016) Android 6 | Yes | Excellent BT tether using app 'Blue Car Tethering' | xDrip+ with G4, reliable capture using xDrip+ and using normal tether when running with Dexcom in G4-upload mode
- |
---|
Elephone P9000 Android 7 | Yes | Seems to work well, switching on/off BT tehethering as expected. Using 'Blue Car Tethering' with rig selected. Tested with phone screen off, works fine. |
- |
---|
Samsung Galaxy A5 (2017) Android 7.0 | Yes | Excellent BT tether, intermitent disconnecting when the area is flooded with other bluetooth devices. Use 'BT AutoTether' app along side to maintain connection | xDrip+ with G5, works really well with G5 transmitter directly, no compatibility issues and 95%+ consistent capture rate.
- |
---|
Samsung Galaxy S8 Android 7.0 | Yes | Excellent BT tether, no need for 3rd party app to keep BT teter alive, can be set in settings | xDrip+ with Libre/RFDuino transmitter, 99%+ capture rate,
- |
---|
Motorolo Moto Z Play | Yes | Excellent BT tethering; highly reliable using Blue Car Tethering. | Not tested (using Enlite sensor).
- |
---|
Wiko Wim Lite | Intermittent | Works most of the time. Note, several issues with this phone: 1) NSClient has a tendency to crash on this phone and 2) Bluetooth tethering works intermittently with Blue Car Autotether and not at all with BT AutoTether. Note that this phone has a tendency to freeze and reboot on its own, so I think the phone itself is the issue. | Not tested (using Enlite sensor).
- |
---|
Xiaomi Mi Mix 2 with LineageOS 15.1 | Yes | Excellent connectivity - has worked almost flawlessly with tethering. Battery life has also been very good. | Works brilliantly with xDrip+ and G6 - capture rate typically more than 95%.
- |
---|
Nokia 2.1 with Android 8.1 Oreo Go Edition | Yes | Excellent bluetooth tethering to cellular network. No noted network drops. Works excellent as an offline option with XDripAPS. Awesome battery life(4000mAH) | Works well with Dexcom G5 and xDrip. No issues with compatibility. Generally 95%+ capture rate.
- |
---|
OnePlus 6 (A6003) with OxygenOS 9.0 | Yes | Excellent connectivity - Tethering has been good and picks up right away. Battery life very good and really fast charge. | xDrip+ w/ G5 - capture rates generally better than 98% on current nightlies.
- |
---|
Samsung S10/S10e with Android Pie | Not on TMobile Native | Both the S10 and S10e are fully capable of bluetooth pairing and tethering, but unlike Verizon, T-Mobile deprovisions bluetooth tethering for unknown and inexplicable reasons. On all of their phones as far as we know. | Verizon and OEM Unlocked phones may work.
-
- |
---|
+| **Cellphone** | Works with Bluetooth Tethering? | Issues/Experiences with BT | Use with xDrip/xDripAPS and Dexcom G5 |
+| ------------- | ------------------------------- | -------------------------- | ------------------------------------- |
+| **Google Pixel 3XL with Android 9** | Yes | Supports tethering to both Wifi and Cellular network. No issues switching. |
+| **Google Pixel 2 with Android 8** | Yes | Supports tethering to both Wifi and Cellular network. No issues switching. |
+| **LG Nexus 5X with Android 7** | Yes | Supports tethering to both Wifi and Cellular network. No issues switching. | Works well with Dexcom G5 and xDrip. No issues with compatibility. 90%+ capture rate. |
+| **Google Pixel with Android 7** | Yes | Supports tethering to both Wifi and Cellular network. No issues switching. | Works well with Dexcom G5 and xDrip. No issues with compatibility. 90%+ capture rate. |
+| **Sony Xperia Z5 Compact with Android 7** | Yes | Works with tethering for network access. It regularly disconnects from the rig (which doesn't seem to affect data flow) and roughly every 24-36 hours this results in complete loss of connectivity and requires a full reboot of the rig and the phone. Doesn't work well with phone swapping between Wifi and mobile - causes BT dropouts that require a reboot of the rig. | No issues running xDrip/xDripAPS alongside the tethered connection. Achieves 90%+ packet collection from Dexcom G5. |
+| **Xiaomi Redmi 4 with MIUI 8 (Android 6)** | No | Tethering can be set up, but it drops regularly requiring rig reboots. When phone switches between Wifi and cellular signal requires rig to be rebooted. | Significant packet drops and data becomes almost unusable. |
+| **Xiaomi Redmi Note 4(X) -Snapdragon SoC version!!!** | Yes | Tethering works in same time with Blukon(Nightrider) and SW3 connected. Also, read Notes for MIUI below* | Excellent coverage. |
+| **Xiaomi Redmi 3 with MIUI 6 (Android 5)** | Yes | No issues seen when tethered to cellular network. Doesn't allow tethering to wifi. | Works fine with Dexcom G5 - 90% collection rate. |
+| **Xiaomi Mi A1 with AndroidOne (vanilla Android 8.0)** | Yes | OpenAPS bluetooth tethering works fine with Blue Car Autotether. | Not tested with Dexcom. |
+| **Samsung Galaxy S6 (Android 7)** | Yes | Tethering to rig and cellular works okay. No data on swapping between cellular and wifi connections. | Use with Dexcom G5 and rig not effective. Significant packet loss. |
+| **Samsung Galaxy Junior** | Yes | Phone tethering switching between wifi and mobile not elegant and causes some issues | Difficulties found when using xDrip with the OpenAPS tethering. Packet loss occurs. |
+| **iPhone** | Yes | Users have experienced various levels of success with the iPhone bluetooth tethering and when the rig switches between wifi and BT | Not Applicable. Experimental version of Loop to do something similar doesn't yet have feedback. |
+| **Acer Phone** | No | Many data drops on the bluetooth connection for rig. Recommended to avoid. | xDrip compatibility is poor - numerous drops throughout the day. |
+| **Samsumg Galaxy S7 Edge (G935F) Android 7.0** | Yes | Excellent BT tether using apps 'Bt AutoTether' and 'BT Tether' | xDrip+ with G5 > 95% capture. |
+| **Samsung Galaxy A3 (2016) Android 6** | Yes | Excellent BT tether using app 'Blue Car Tethering' | xDrip+ with G4, reliable capture using xDrip+ and using normal tether when running with Dexcom in G4-upload mode |
+| **Elephone P9000 Android 7** | Yes | Seems to work well, switching on/off BT tethering as expected. Using 'Blue Car Tethering' with rig selected. Tested with phone screen off, works fine. |
+| **Samsung Galaxy A5 (2017) Android 7.0** | Yes | Excellent BT tether, intermittent disconnecting when the area is flooded with other bluetooth devices. Use 'BT AutoTether' app along side to maintain connection | xDrip+ with G5, works really well with G5 transmitter directly, no compatibility issues and 95%+ consistent capture rate. |
+| **Samsung Galaxy S8 Android 7.0** | Yes | Excellent BT tether, no need for 3rd party app to keep BT tether alive, can be set in settings | xDrip+ with Libre/RFDuino transmitter, 99%+ capture rate, |
+| **Motorolo Moto Z Play** | Yes | Excellent BT tethering; highly reliable using Blue Car Tethering. | Not tested (using Enlite sensor). |
+| **Wiko Wim Lite** | Intermittent | Works most of the time. Note, several issues with this phone: 1) NSClient has a tendency to crash on this phone and 2) Bluetooth tethering works intermittently with Blue Car Autotether and not at all with BT AutoTether. Note that this phone has a tendency to freeze and reboot on its own, so I think the phone itself is the issue. | Not tested (using Enlite sensor). |
+| **Xiaomi Mi Mix 2 with LineageOS 15.1** | Yes | Excellent connectivity - has worked almost flawlessly with tethering. Battery life has also been very good. | Works brilliantly with xDrip+ and G6 - capture rate typically more than 95%. |
+| **Nokia 2.1 with Android 8.1 Oreo Go Edition** | Yes | Excellent bluetooth tethering to cellular network. No noted network drops. Works excellent as an offline option with XDripAPS. Awesome battery life(4000mAH) | Works well with Dexcom G5 and xDrip. No issues with compatibility. Generally 95%+ capture rate. |
+| **OnePlus 6 (A6003) with OxygenOS 9.0** | Yes | Excellent connectivity - Tethering has been good and picks up right away. Battery life very good and really fast charge. | xDrip+ w/ G5 - capture rates generally better than 98% on current nightlies. |
+| **Samsung S10/S10e with Android Pie** | Not on TMobile Native | Both the S10 and S10e are fully capable of bluetooth pairing and tethering, but unlike Verizon, T-Mobile deprovisions bluetooth tethering for unknown and inexplicable reasons. On all of their phones as far as we know. | Verizon and OEM Unlocked phones may work. |
**********************************************************************************************
*Notes for MIUI users. MIUI kills processes in background to save battery. To get best results:
diff --git a/docs/docs/Customize-Iterate/offline-looping-and-monitoring.md b/docs/docs/Customize-Iterate/offline-looping-and-monitoring.md
index 90d97c91a..daf09e885 100644
--- a/docs/docs/Customize-Iterate/offline-looping-and-monitoring.md
+++ b/docs/docs/Customize-Iterate/offline-looping-and-monitoring.md
@@ -88,110 +88,29 @@ The oref0-setup option for `xdrip-js` installs Logger by default.
> NOTE: Lookout, Logger (xdrip-js-logger), and xdrip-js library should be considered a WIP (Work In Progress), i.e., do not use if you cannot watch your BG and loop very carefully, and tolerate issues, failures, idiosynchrosies. Also please plan on contributing either through testing and feedback, updates, documentation, etc.
A summary of their features:
-
-
-
- Feature |
- Lookout |
- Logger |
-
-
- Still unfinished, i.e., a work-in-progress? |
- Yes |
- Yes |
-
-
- Rig continues updating BG and looping while offline using xdripAPS? |
- Yes |
- Yes |
-
-
- Offline (network) mode supports backfill to Nightscout? |
- Yes |
- Yes |
-
-
- Offline (away from transmitter times) supports backfill? |
- Yes |
- Yes |
-
-
- Uses Dexcom official calibration? |
- Yes |
- Yes |
-
-
- Can use with expired/battery replaced transmitter? |
- Yes |
- Yes |
-
-
- Can interact with rig-hosted web page? (e.g., for calibration, start/stop sensor) |
- Yes |
- No, can use rig cmd line while offline |
-
-
- Also able to calibrate and start/stop sensor thru receiver? |
- Yes |
- Yes, for non-expired transmitter/session |
-
-
- Calibrate through Web/Nightscout? |
- Yes (local rig Web UI) |
- Yes |
-
-
- Calibrate through pump-connected meter (e.g., Contour Next Link)? |
- No |
- Yes |
-
-
- Calibrate from command line? |
- Yes |
- Yes |
-
-
- Linear Squared Regression Calibration |
- Yes, for > 7 day extension |
- Yes |
-
-
- Single Point Linear Calibration |
- Yes, for > 7 day extension |
- Yes |
-
-
- Calculate and send Noise with entries |
- Yes |
- Yes |
-
-
- Calculate glucose trending |
- Yes |
- Yes |
-
-
- Start Stop Sensor |
- Yes via UI |
- Yes via NS/cmd line |
-
-
- Reset Expired Transmitter |
- Yes via UI |
- Yes via cmd line |
-
-
- Support mmol |
- Yes |
- Yes, in NS and for Meter-Pump Calibration |
-
-
- View transmitter battery/resistance levels |
- Yes via NS CGM pill |
- Yes |
-
-
-
+
+| Feature | Lookout | Logger |
+| ------- | ------- | ------ |
+| Still unfinished, i.e., a work-in-progress? | Yes | Yes |
+| Rig continues updating BG and looping while offline using xdripAPS? | Yes | Yes |
+| Offline (network) mode supports backfill to Nightscout? | Yes | Yes |
+| Offline (away from transmitter times) supports backfill? | Yes | Yes |
+| Uses Dexcom official calibration? | Yes | Yes |
+| Can use with expired/battery replaced transmitter? | Yes | Yes |
+| Can interact with rig-hosted web page? (e.g., for calibration, start/stop sensor) | Yes | No, can use rig cmd line while offline |
+| Also able to calibrate and start/stop sensor thru receiver? | Yes | Yes, for non-expired transmitter/session |
+| Calibrate through Web/Nightscout? | Yes (local rig Web UI) | Yes |
+| Calibrate through pump-connected meter (e.g., Contour Next Link)? | No | Yes |
+| Calibrate from command line? | Yes | Yes |
+| Linear Squared Regression Calibration | Yes, for > 7 day extension | Yes |
+| Single Point Linear Calibration | Yes, for > 7 day extension | Yes |
+| Calculate and send Noise with entries | Yes | Yes |
+| Calculate glucose trending | Yes | Yes |
+| Start Stop Sensor | Yes via UI | Yes via NS/cmd line |
+| Reset Expired Transmitter | Yes via UI | Yes via cmd line |
+| Support mmol | Yes | Yes, in NS and for Meter-Pump Calibration |
+| View transmitter battery/resistance levels | Yes via NS CGM pill | Yes |
+
* Lookout and Logger (xdrip-js-logger) are documented separately:
* Lookout: [https://github.com/xdrip-js/Lookout/blob/dev/README.md](https://github.com/xdrip-js/Lookout/blob/dev/README.md)
* Logger: [https://github.com/xdrip-js/Logger/blob/dev/README.md](https://github.com/xdrip-js/Logger/blob/dev/README.md)
diff --git a/docs/docs/Gear Up/edison.md b/docs/docs/Gear Up/edison.md
index d1bf3ff9e..c27013675 100644
--- a/docs/docs/Gear Up/edison.md
+++ b/docs/docs/Gear Up/edison.md
@@ -106,11 +106,11 @@ Solder it to the board. It's the hole near the "o" from Radio. Make sure to not
This is your connection scheme for the RPi to RFM69HCW. Stick the RFM69HCW on a bread board, and connect:
-Board | Connect | Connect | Connect | Connect | Connect | Connect | Connect | Connect
-------|------|------|------|------|------|------|------|------
-RPi | 3.3V | GND | MOSI | MISO | SCLK | | CE1_N ||
-RPi PIN | 17 | 25 | 19 | 21 | 23 | 15 | 26 | 22
-RFM69HCW | VIN or 3.3V | GND | MOSI | MISO | SCK or CLK | G0 or DIO0 | CS or NSS | RST or RESET
+| Board | Connect | Connect | Connect | Connect | Connect | Connect | Connect | Connect |
+| ----- | ------- | ------- | ------- | ------- | ------- | ------- | ------- | ------- |
+| RPi | 3.3V | GND | MOSI | MISO | SCLK | | CE1_N | |
+| RPi PIN | 17 | 25 | 19 | 21 | 23 | 15 | 26 | 22 |
+| RFM69HCW | VIN or 3.3V | GND | MOSI | MISO | SCK or CLK | G0 or DIO0 | CS or NSS | RST or RESET |
![Picture of RPI0WH with FM69HCW connection diagram](../Images/build-your-rig/rpii2RFM69HCW.JPG)
diff --git a/docs/docs/Resources/switching-between-DIY-systems.md b/docs/docs/Resources/switching-between-DIY-systems.md
index b050764e3..566ad3689 100644
--- a/docs/docs/Resources/switching-between-DIY-systems.md
+++ b/docs/docs/Resources/switching-between-DIY-systems.md
@@ -16,31 +16,11 @@ If you’re coming to try OpenAPS from a Loop system, there’s going to be some
### Main Hardware Differences:
-