Skip to content

Documentation and library for decoding omnipod communications.

License

MIT, MIT licenses found

Licenses found

MIT
LICENSE
MIT
LICENSE_LIQUID_DSP
Notifications You must be signed in to change notification settings

openaps/openomni

Repository files navigation

OpenOmni

Documentation and python library for decoding omnipod communications. Join the Slack channel to discuss this work.

Build Status

Current Status

We have figured out the RF modulation and packet/message encoding. We are now working on decoding meaning of the bytes in the body for each of the Message Types.

Areas to focus on

There are two ways we could use help, beyond trying to crack the two byte crc at the end of messages (though if you want to tackle that, please do!):

  1. Capture data from different pods and commands using omni_listen_rfcat. If you can document what was being done with the PDM while the packets were recorded, that would be a plus, but raw data can be helpful too. Submit these as new wiki pages and add your new page to the Packet Captures page.
  2. Start decoding fields for individual commands. A good way to start doing this is to repeatedly perform a certain type of action on the PDM tweaking 1 thing each time, and inspecting the generated packets to see which bytes differ.

What you'll need

One of the following. If you use the TI stick, you will need to flash firmware onto it using a CC-Debugger.

Installation

Prerequisites:

  • python 2.7 (already installed on MacOS, for windows, download it here)
  • pip
  • On mac, you'll need libusb. brew install libusb (If you don't have Homebrew installed, go here first: https://brew.sh/)

You can install openomni in editable mode like this:

git clone https://github.com/openaps/openomni.git
cd openomni/openomni
pip install -e . --process-dependency-links

** Note: You may need to add 'sudo' before the pip install line if you are using a system python install.

** Note: You can capture packets by plugging an RFCat into a USB port -- then go to the command line, and navigate to this directory: /openomni/bin/ and type:

omni_listen_rfcat

Then issue commands from your PDM and they'll appear at the command line.

=======

** Please note the details below are related to a project created to better understand how the omnipod communicates **

Stay Up to Date!

Join the Slack channel to discuss this work.

Contributors on Slack: (in no particular order)

(To view, you must be logged into the OmniAPS Slack channel. Click here to join.)

Rules for Contributing to this Repository

  • All code updates require the use of Pull Requests.
  • Documentation updates can be made directly on master.

https://files.slack.com/files-pri/T0B2X082E-F0D390KTP/download/pod_datacap_23oct2015.odt


About

Documentation and library for decoding omnipod communications.

Resources

License

MIT, MIT licenses found

Licenses found

MIT
LICENSE
MIT
LICENSE_LIQUID_DSP

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published