andyp123 / ergamigo

Utility for sending data from a Concept 2 rower to a connected client via websockets.

ErgServer

Utility for getting workout data from a Concept 2 rowing machine and sending it via websockets to connected clients on multiple devices.

Requirements:

• Python 2.7.6+
• Python library 'pyusb'
• Python library 'pyrow' (http://www.newhavenrowingclub.org/pyrow/ - included)
• Python library 'SimpleWebSockets' (http://opiate.github.io/SimpleWebSocketServer/ - included)

pyrow is Copyright (c) 2011, Sam Gambrell. Licensed under the simplified BSD license.
SimpleWebSockets is Copyright (c) 2013, Dave P. Licensed under the MIT license.

Installation:

1. Get Python 2.7.6 or above and install it. Most Linux distros and MacOS should already have it installed, but Windows does not come with it by default, so head over to http://www.python.org/
2. Make sure libusb is installed. It is installed by default in many linux distros, but you need to install on MacOS and Windows. (http://www.libusb.org/)
3. Install pyusb 1.0+. (http://walac.github.io/pyusb/)
4. From a terminal, move into the directory containing 'ergserver.py' and run it with a Concept 2 erg connected. If you use the erg with the program running, you should see messages at the console.
5. With a server open, run test_client.html in Chrome. If all has gone successfully and you do some rowing, force curves will be drawn on screen!

By default, running ergserver.py with no command line arguments will start a websocket server with your machines ip address on port 8000. This can be changed by running with options:
--host '127.0.0.1' - set the host ip manually
--port 8000 - set the port manually

NOTE: You may not be able to read from the USB due to insufficient permissions. To fix this you can either:

1. run as root 'sudo python ergserver.py'
2. set up permission to read from the concept 2 erg using udev rules.
   Create a file in /etc/udev/rules.d/ named 'c2erg.rules' containing the following:
   SUBSYSTEM=="usb", ENV{DEVTYPE}=="usb_device", MODE="0666", ATTRS{idVendor}=="17a4"

This should enable access to the erg (actually all connected Concept 2 devices) without having to run as root.

TIPS: To list connected usb devices and check the vendor and product codes, type 'lsusb' at the terminal. 'lsusb -v' prints verbose information. To reload the udev rules, enter 'udevadm control --reload-rules' at the terminal. You'll probably need to unplug the erg, reload, then reconnect for this to work.

Raspberry Pi Installation Notes:

I'm only part way into getting ergserver to work on Raspberry pi, but so far it looks like the same setup procedure should work. I will add details regarding erg connection once I have tested it.

Python may need to be upgraded manually, since the version on the version of Raspbian I am using is a little old and may not work with SimpleWebSockets.

Install USB related dependencies with: apt-get install libusb-1.0-0 apt-get install python-pip pip install pyusb

NOTE: Do not install pyusb with the apt-get command, since it will most likely be an out of date version (0.4), which will lead to errors about usb.core not existing when you try to run ergserver.py. On the most recent versions of pip, you may encounter issues relating to there not being the required version, so you will need to enable pre-release versions with 'pip install --pre pyusb'.