Skip to content
/ minimed_rf Public

Decoding the radio protocol used by medtronic pumps, enlite cgm, and mysentry monitor.

Notifications You must be signed in to change notification settings

ps2/minimed_rf

Repository files navigation

minimed_rf

Many Medtronic insulin pumps are capable of sending CGM data to a remote monitor called MySentry. This project provides ruby libraries and tools to decode the message sent between the devices. To capture and send packets, you can use something like RileyLink or an SDR.

rf modulation

The frequency used is 916.5MHz, and the modulation is ASK/OOK. Data rate is 16kBaud. I use an RX filter BW of 203kHz since the pump, sensor, and MySentry all use different antennas and the frequency varies a bit from the center.

Here are the settings I use to configure a cc1110 with a 24MHz crystal:

/* RF settings SoC: CC1110 */
SYNC1     = 0xFF; // sync word, high byte
SYNC0     = 0x00; // sync word, low byte
PKTLEN    = 0xFF; // packet length
PKTCTRL1  = 0x00; // packet automation control
PKTCTRL0  = 0x00; // packet automation control
ADDR      = 0x00;
CHANNR    = 0x02; // channel number
FSCTRL1   = 0x06; // frequency synthesizer control
FSCTRL0   = 0x00;
FREQ2     = 0x26; // frequency control word, high byte
FREQ1     = 0x2F; // frequency control word, middle byte
FREQ0     = 0xE4; // frequency control word, low byte
MDMCFG4   = 0xB9; // modem configuration
MDMCFG3   = 0x66; // modem configuration
MDMCFG2   = 0x33; // modem configuration
MDMCFG1   = 0x61; // modem configuration
MDMCFG0   = 0xe6; // modem configuration
DEVIATN   = 0x15; // modem deviation setting
MCSM2     = 0x07;
MCSM1     = 0x30;
MCSM0     = 0x18; // main radio control state machine configuration
FOCCFG    = 0x17; // frequency offset compensation configuration
BSCFG     = 0x6C;
FREND1    = 0x56; // front end tx configuration
FREND0    = 0x11; // front end tx configuration
FSCAL3    = 0xE9; // frequency synthesizer calibration
FSCAL2    = 0x2A; // frequency synthesizer calibration
FSCAL1    = 0x00; // frequency synthesizer calibration
FSCAL0    = 0x1F; // frequency synthesizer calibration
TEST1     = 0x31; // various test settings
TEST0     = 0x09; // various test settings
PA_TABLE0 = 0x00; // needs to be explicitly set!
PA_TABLE1 = 0x57; // pa power setting 0 dBm

data encoding

The data is encoded using an encoding called 4b6b. It looks like this:

    "010101" => "0",
    "110001" => "1",
    "110010" => "2",
    "100011" => "3",
    "110100" => "4",
    "100101" => "5",
    "100110" => "6",
    "010110" => "7",
    "011010" => "8",
    "011001" => "9",
    "101010" => "a",
    "001011" => "b",
    "101100" => "c",
    "001101" => "d",
    "001110" => "e",
    "011100" => "f"

A raw (encoded) packet looks something like this:

ab29595959655743a5d31c7254ec4b54e55a54b555d0dd0e5555716aa563571566c9ac7258e565574555d1c55555555568bc7256c55554e55a54b55555556c55

Once you have decoded the data, the packets start to show some recognizable fields:

a259705504e541120e1b0e080b004d4e00018a03010628127e0504004f0000008b120c000e080b00000c

a2 identifies the type of packet, 597055 is the pump number, etc... The 0c at the end is an 8bit crc.

usage

ruby -I lib bin/mmdecode <packetdata>

example

ruby -I lib bin/mmdecode ab29595959655743a5d31c7254ec4b54e55a54b555d0dd0e5555716aa563571566c9ac7258e565574555d1c55555555568bc7256c55554e55a54b55555556c55
a2 597055 PumpStatus: #101 2014-08-11 18:14:00 -0500 - Glucose=154 PreviousGlucose=156 ActiveInsulin=1.975

Flow control

If you're using a device that doesn't have flow control (like the ERF stick), set the appropriate environment variable before use:

export RFSPY_RTSCTS=0
ruby -I lib bin/mmtune /dev/ttyMFD1 123123

Thanks

Thanks to @bewest and @loudnate and others who have provided many insights into the Minimed protocols. Much of the pump-specific knowledge has been figured out by @bewest in his decoding-carelink repository.

About

Decoding the radio protocol used by medtronic pumps, enlite cgm, and mysentry monitor.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •