Linux
This section details installing the Pulse Pal driver and MATLAB client on a computer running Ubuntu 14.04.
The PC must have
1. Ubuntu14.04
2. 1GB+ RAM
3. If you plan to use MATLAB, use MATLAB r2011a or a more recent version.
Download the Pulse Pal software (Skip this step if you wish to use version control to keep Pulse Pal's software and firmware current)
Pulse Pal can be downloaded from its repository:
https://github.com/PulsePal/PulsePal/archive/master.zip
Extract the zip, and copy the contents of the PulsePal-master folder to \Documents\PulsePal\
Clone the code repository (Skip this step if you do not wish to use version control to keep PulsePal's software and firmware current)
Pulse Pal's software is frequently updated with new features and improvements. To keep Pulse Pal current for everyone, we use a revision control system called Git.
Git's command line usage can be tricky, so instead, we use a simple and powerful user interface to Git called SourceTree.
1. Download and install SourceTree.
2. If necessary, click to install the .net framework during SourceTree installation.
3. Open SourceTree.
4. If you do not have Git installed, you will be prompted with three ways to install it. Select "Download an embedded version of Git".
5. Next, enter a name and Email address. This is your signature for commits.
6. Leave checkboxes on their default settings (Global config file permissions and automatic line ending).
7. If you are prompted that you don't have a global ignore file, click "Yes" to create one.
8. Select "Use PuTTY" from the SSH client configuration menu
9. Select "No" to create an SSH key later.
10. Do not connect to a hosting service when prompted. Click "Finish" and then "Skip test".
11. From the menu bar, click "Clone / New".
12. In the "Source path / URL" field, type https://github.com/PulsePal/PulsePal.git
13. In the "Destination path" field, the default is /Documents/PulsePal. This is where the Pulse Pal software will reside on your hard drive.
15. Click "Clone".
If all went well, this should copy the latest Pulse Pal client to your computer. The repository will appear in the listbox on the lefthand side of the SourceTree window.
For more on using SourceTree to keep your Pulse Pal version current, see the SourceTree FAQ
Add your username to the "dialout" group, if this hasn't already been done:
From the terminal> sudo usermod -a -G dialout pulsepaluser (if pulsepaluser is your username)
Driver and firmware installation (skip this section if the latest firmware was already installed on the Pulse Pal device)
1. Download Leaflabs MapleIDE, extract the zip folder and save the extracted folder somewhere permanent on your PC.
2. Plug the Pulse Pal device into the computer's USB port.
3. No drivers are necessary since you're using Linux - but you'll have to install Java.
4. To install Java with aptitude, first install aptitude: sudo apt-get install aptitude
5. Install Java: sudo aptitude install openjdk-6-jre
4. Next, navigate to the Maple program folder and run the maple-ide shell script: sh maple-ide
5. From the "Tools" menu, choose "Board" and then "LeafLabs Maple Rev3+ to Flash".
6. From the "Serial Port" menu, choose "/dev/ttyACMX" where X is the port number.
7. From the File menu in MapleIDE, choose "Open" and select "\Documents\PulsePal\Firmware\PulsePal_X_X", where X_X is the latest firmware version. A new window should open with the firmware.
8. In the new window, click the "upload" button (the right-pointing arrow button below the "tools" drop-menu).
If all went well, the progress indicator should finish, and be replaced with a message: "Done uploading". In orange text below, should read "Verify successful".
Rarely, you may see an error in red: "Couldn't find the DFU device". If you see this, try uploading the firmware again, and plug in Pulse Pal's USB port the moment you see "Searching for DFU device" in the dark green console window. Further guidance on uploading firmware is available on the Leaflabs Maple documentation website: http://leaflabs.com/docs/ide.html#upload