pumpy: computer control of your syringe pumps

Pumpy allows you to control your Harvard syringe pump or Mighty Mini piston pump from your computer over an RS-232 interface.

Supported pumps

• Harvard Pump 11
• Harvard Pump 11 Plus
• Harvard PHD2000
• Mighty Mini piston pump
• Harvard Pump 33

Features

• For Harvard Pump 11, Pump 11 Plus, and PHD2000:
  • infuse
  • withdraw
  • set diameter
  • set flow rate
  • set target volume
  • wait until target volume
• For Mighty Mini:
  • set flow rate
  • start
  • top
• For Harvard Pump 33:
  • set mode
  • set syringe 1 diameter
  • set syringe 2 diameter
  • set syringe 1 flow rate
  • set syringe 2 flow rate
  • set syringe 1 direction
  • set syringe 2 direction
• Supports logging to record all operations.

Requirements

• Python 2.7.3 or higher
• PySerial 2.6 or higher
• Computer with RS-232 port or a USB-serial adapter
• Cable to connect your pump. See the pump manual for the correct wiring.

Install

pip install pumpy

Usage

Run python -m pumpy --help to see command line options.

Alternatively you can use it in your existing code:

chain = pumpy.Chain('/dev/tty.usbserial-FTWOFH91A')

p11 = pumpy.Pump(chain,address=1)
p11.setdiameter(10)  # mm
p11.setflowrate(2000)  ## microL/min
p11.settargetvolume(200)  ## microL
p11.infuse()
p11.waituntiltarget()  ## blocks until target reached
p11.withdraw()
p11.waituntiltarget()

phd = pumpy.PHD2000(chain,address=4)
phd.setdiameter(24)
phd.setflowrate(600)
phd.infuse()
phd.stop()
phd.withdraw()
phd.stop()
phd.settargetvolume(100)
phd.infuse()
phd.waituntiltarget()

chain.close()

chain = pumpy.Chain('COM4') # on Windows

p33 = pumpy.Pump33(chain, address=0)
p33.setmode('PRO')
p33.setdiameter1(10.3)
p33.setdiameter2(10.3)
p33.setflowrate1(200)
p33.setflowrate2(100)
p33.setdirection1('INF')
p33.setdirection2('REF')
p33.start()
p33.stop()

chain.close()

Known Issues

1. Harvard PHD2000 supports higher precision when setting flow rates/diameters than the Pump 11. At present everything is truncated for compatibility with the Pump 11.
2. PHD2000 requires "withdraw, stop, infuse" rather than "withdraw, infuse" otherwise it doesn't respond.
3. PHD2000 will only take notice of target volumes when it has been put into volume mode using the keypad.

Future work

1. Add Pump 33 to pumpy.vi
2. Harvard PHD2000 supports Model '22' Protocol and Model '44' Protocol. Add support to Model '44' Protocol to supplement the current support for Model '22' Protocol.

Acknowledgements

Thanks to Sam Macbeth for adding support for the Mighty Mini.