Device-Adapter Beaglebone Setup
This tutorial contains content that is not displayed on mobile browsers. Please use a desktop/laptop browser to take advantage of all images.
This guide will assist you in setting up a Beaglebone Black (BBB) as a device-adapter for integrating supported medical devices into OpenICE. The device adapters function as means of converting the proprietary data output from existing medical devices into the common data fabric used in OpenICE. OpenICE uses the terminology from ISO/IEEE 11073-10101 as maintained by the Rosetta Terminology Mapping Management Service.
OpenICE device adapters can be used for acquisition of waveform and numeric medical data as well as settings and alarms from supported medical devices. The export capabilities of the connected medical device determine the capabilites of the platform, i.e. if a device does not export waveforms, OpenICE analytics that require waveform input are not possible for that device.
The OpenICE device-adapter service is the core software that functions as the intermediary between the medical device and the OpenICE network. The device-adapter service is a Java application that can run on any Java friendly hardware platform, including embedded systems, laptops, servers, Raspberry Pis, Intel Galileos, Beagleboards, etc. This device-adapter is not intended to be a permanent solution. Ideally, the functionality of the device-adapter would be available natively from a future medical device.
This tutorial uses Beaglebone Black (Revision C or B) as the hardware platform. BBB is a single board, Linux-driven computing platform. It was chosen as the preliminary implementation platform due to the open-hardware, community supported design, and the high performance to cost ratio of the device. At the time of writing, a Beaglebone Black can be purchased for $55.
Currently Compatible Devices
- Philips MPxx Intellivue - Ethernet Connection
- Philips MPxx Intellivue - Serial Connection
- Masimo Radical 7
- Dräger Apollo
- Dräger Evita XL
- Dräger Evita 4
- Dräger V500
- Ivy 450C
- Capnostream 20
- Nellcor N595
Included Device Simulators
- Multi-Parameter Patient Monitor
- Non-Invasive Blood Pressure
- End Tidal CO2
- Infusion Pump
- Pulse Oximetry
- Beaglebone Black
- This process was created and tested with a BBB revision C board running the stock Debian Linux distribution.
- 5V Power Supply
- Please use a dedicated 5V 1A power supply for your BBB during this process. The flashing process may use more than the 500mA allowed by some USB 2.0 laptop and computer ports. Exceeding this limit could disable the power and corrupt the memory on the BBB.
- MicroSD Card
- At least 4GB of space is required for Revision C (or 2GB for Revision B). This process was tested with an 8GB card. You will also need some method of connecting the MicroSD card to your computer. A simple USB adapter is recommended.
- A Computer
- Needed for preparing the MicroSD card. This process should be possible on any operating system. Windows users will have to ensure that they have the tools needed for decompressing .tar.xz images. This will be easiest on either Linux or OS X.
- Revision C Disk Image
- Revision B Disk Image
- Download the MD PnP Beaglebone Black eMMC flasher. Details about the software installed in disk image can be found below. This image will replace the onboard memory (eMMC) of the BBB.
Software Installed in the Disk Image:
- Debian 7.8
- The disk image contains a Debian filesystem from beagleboard.org. The exact kernel installed is 3.8.13-bone71.
- Oracle SE JDK
- The Java Standard Edition Development Kit is installed for ease of debugging on-board applications. The JDK version is 8u33.
- MD PnP OpenICE
- MD PnP provides a demo application for both serving as the medical device adapter and for viewing and interacting with the OpenICE network on a computer. Later in the tutorial, we will configure the installed demo application to function as a device adapter. To view and interact with the data on your personal computer, simply install the software by clicking the big green download button on the linked page.
- NTP Daemon
- The Network Time Protocol daemon (NTPd) package is installed on the disk image. The OpenICE environment requires all nodes to sync to a NTP clock for data accuracy and alignment. The time zone of the BBB image has been set to U.S. Eastern.
Prepare the MicroSD Card
Now we are going to create a MicroSD card that the BBB can use to automatically flash its memory.
- Copy the BBB disk image to MicroSD card. On a Linux system with the MicroSD card identified as /dev/sdX the following command can be used:
- (for Revision C) xz -dc bone-debian-7.8-lxde-4gb-armhf-2015-03-01-4gb-openice-0.6.2.img.xz | dd of=/dev/sdX bs=1024K
- (for Revision B) xz -dc bone-debian-7.8-console-armhf-2015-03-01-2gb-openice-0.6.2.img.xz | dd of=/dev/sdX bs=1024K
That's it. Your MicroSD card is ready.
Flashing the Memory
NOTE: This process will overwrite the contents of your BBB's internal (eMMC) memory. Backup any content you wish to preserve.
- Insert the MicroSD card into the BBB.
- Plug in the BBB power supply.
NOTE: If you are using a revision A or B beaglebone not previously flashed with an updated version of u-boot you may need to hold down the "option/boot" button (near the microSD card slot) to boot from the microSD card.
WARNING: Do not use the USB power during the flashing process. eLinux reports that this process may exceed 500mA and trigger a PC or laptop to disable USB power. Please use a dedicated 5V 1A power supply as detailed above.
- When the image starts copying onto the BBB the four LEDs will illuminate successively from end to end.
- When flashing is complete all the LEDs will illuminate and some finalization steps will occur. After another minute or two the LEDs will extinguish and the beaglebone will power down, remove the power and MicroSD card.
- Your beagle is now running Debian 7.8 and has the OpenICE device adapter software installed. It can now be configured to run as a device adapter for any of the supported devices. In the next section we will configure the adapter to communicate with a Philips MP70.
- The default user is "debian". The default password is "debian".
NOTE: The BBB with Debian may take up to 3 minutes to boot without a network cable attached.
Your new device-adapter is ready to use. You can start the software with OpenICE-1.0.0/bin/OpenICE from the home directory. Check out the next page for more instructions.