PrismaflexRecordPlaybackTool 7 - Beta - Instructions

Contents
Contents.................................................................................................................................................. 1
Introduction ............................................................................................................................................ 1
Requirements.......................................................................................................................................... 1
Features .................................................................................................................................................. 2
Caveats & Deviations ............................................................................................................................... 2
USB Serial Ports (COM Port, RS232) ......................................................................................................... 3
How to Launch ........................................................................................................................................ 3
How to Record ........................................................................................................................................ 4
How to Playback ...................................................................................................................................... 4
How to View ............................................................................................................................................ 5

Introduction
The PrismaflexRecordPlaybackTool 7 - Beta is a valuable tool intended to allow a Windows PC to output
data as if it were a real Prismaflex or PrisMax, and to view each message and all parameter values in that
message, both the header and body. This facilitates development and testing by allowing you to repeat
the same treatments over and over, as well as to view the correct values for every parameter in every
message.

The PrismaflexRecordPlaybackTool 7 - Beta is not "released formally-validated" software. Use it to

facilitate your development, but use a real Prismaflex or PrisMax at some point for final validation. The
intention is that this tool will allow you to rapidly develop a 100% good driver such that your validation
with a real Prismaflex or Prismax will be a formality, that is a more rapid final step. Final validation can
be on a customer's Prismaflex or PrisMax to accelerate release.

Requirements
The PrismaflexRecordPlaybackTool 7 - Beta runs on Windows XP through Windows 10. CPU and RAM
requirements are very low so it works on old single-core and new multi-core processors.

PrismaflexRecordPlaybackTool 7 - Instructions.docx Page 1 of 6

Charles Zuelchner
 PrismaflexRecordPlaybackTool 7 - Beta - Instructions

Features
The PrismaflexRecordPlaybackTool 7 - Beta is intended for has 3 functions.
1. Record Prismaflex or PrisMax data from an Ethernet or RS232 port to a PCAP file (Wireshark
format).
2. Playback Prismaflex or PrisMax data from a PCAP file over an Ethernet or R232 port.
3. View Prismaflex or PrisMax data from a PCAP file (Wireshark format).

Caveats & Deviations

1. The PrismaflexRecordPlaybackTool 7 - Beta is not "released formally-validated" software,
however It has been used extensively and successfully.
2. It is designed for Prismaflex, however, it works with PrisMax with the following deviations.
a. Record: No deviations.
b. Playback: No deviations.
c. View: The Viewer has these expected deviations all related to mapping an integer into
friendly text. The integer will always be correct, but the text may be incorrect when
viewing a PrisMax data file. This is exactly as expected based on the document
"Prismaflex 8.xx to Prismax 2.x Differences*.pdf".
i. Enumerations: For parameters where the Viewer converts Prismax
enumerations into friendly text, the conversions use Prismaflex mappings,
therefore, they may not have correct text if the data you are viewing is from a
Prismaflex. The parameters that this tool maps to text are located in the
message header:
1. Therapy Type (PrisMax calls it Therapy ID)
2. Therapy Status (PrisMax calls it Therapy States)
ii. Extra Parameters: In the message body, PrisMax has extra parameters not
found in Prismaflex. Therefore, when viewing PrisMax data, these parameters
will not have a friendly text name. Instead the parameter code (an integer) is
repeated.
Code Name
65536 PFR Makeup Enabled
65537 Auto Effluent Enabled
65538 Auto Effluent Drain Paused
65539 Auto Effluent Draining
65540 Auto Liquid Level Enabled
65541 Blood Warmer in Use
65542 TherMax Temperature Set Point
65543 Battery Charge Capacity
65544 On Battery
65545 HP-X Cartridge Type
65546 Communication Version Number
65547 System Time Offset Value
65548 Filtration Fraction Type

PrismaflexRecordPlaybackTool 7 - Instructions.docx Page 2 of 6

Charles Zuelchner
 PrismaflexRecordPlaybackTool 7 - Beta - Instructions

USB Serial Ports (COM Port, RS232)

If you are using USB COM ports, enable the ports before starting the tool, that is, plug in the USB cable
before starting the tool.
If you require more than one USB COM port, plug in one port at a time and discover the new COM
number by viewing the new port in the Windows Device Manager (Control Panel --> Ports COM & LPT)
before plugging in the next USB COM port.

How to Launch
Double-click the EXE in order to launch an instance.
Note that you can launch multiple instances allowing you to
1. Simultaneous Playback/Record: Playback a PCAP file on one instance and record the output to
a new PCAP file on another instance. This can be useful if you want to create a new smaller
PCAP file that only has the "interesting parts" from a larger PCAP file, for instance if you want to
skip the long Priming phases or go directly to messages with particular alarms.
2. Simultaneous View/Playback: View the contents of a PCAP file on one instance while playing
back the same PCAP file on another instance. Note that PrismaflexRecordPlaybackTool 7 - Beta
locks its PCAP file. Therefore, to view and playback the same PCAP file, first make a copy of the
PCAP file then use one copy to view and the other copy to playback.

PrismaflexRecordPlaybackTool 7 - Instructions.docx Page 3 of 6

Charles Zuelchner
 PrismaflexRecordPlaybackTool 7 - Beta - Instructions

How to Record
1. Launch PrismaflexRecordPlaybackTool 7 - Beta.
2. Click the "Record" tab.
3. Capture From: Select the port you want to receive on.
4. Save To: Select the target folder to save the new PCAP file. The PCAP will be auto-named based
on port and timestamp.
5. Click "Start" to begin recording. "Start" always creates a new file.
6. Note that the counter in the lower left shows activity.
7. Click "Stop" to stop recording. "Stop" always closes the new file.

How to Playback
1. Launch PrismaflexRecordPlaybackTool 7 - Beta.
2. Click the "Playback" tab.
3. File: Select the target PCAP that you wish to playback.
4. Send to: Select the port you want to transmit on.
8. Click "Start" to begin playback.
9. Note that the counter in the lower left shows activity.
10. Click "Stop" to stop playback. "Stop" always closes the new file.

PrismaflexRecordPlaybackTool 7 - Instructions.docx Page 4 of 6

Charles Zuelchner
 PrismaflexRecordPlaybackTool 7 - Beta - Instructions

How to View
1. Launch PrismaflexRecordPlaybackTool 7 - Beta.
2. Click the "Playback" tab.
3. Select the target PCAP that you wish to view.
4. Ignore the port selection.
5. Do not press the "Start" button.
6. Click the "Tools → Open Viewer" menu in the lower right corner.
7. A viewer window appears. You must close the viewer window to return to the EXE.
8. To find a message with an alarm, note that the message will be 12 bytes longer than a message
with no alarm (see "Left Pane" below for "sz"). Scroll the left pane looking for an "sz" change.
9. There are three panes:
a. Left Pane (List of all Messages):
i. All messages are listed in chronological order.
ii. Click the message you want to view.
iii. Each entry shows the showing.
1. PCAP Timestamp for this message (PC timestamp when this message
was received).
2. tt: TherapyType (integer)
3. ts: TherapyStatus (integer)
4. sz: Message length in bytes.
5. pid: Patient ID
b. Top Right Pane (Header for this message)
i. Contains the parameters found in the Prismaflex and PrisMax header.
ii. TherapyType and TherapyStatus use Prismaflex text mapping, and will not show
correct text when viewing PrisMax data. The integer is always correct.
iii. Clock: the timestamp of the Prismaflex clock. Note that it may not match the
PCAP timestamp.
c. Bottom Right Pane (Body, S-Records, for this message)
i. Each S-Record has one entry.
ii. Format is Code, Name, Type, Value.
iii. For example "36 BOLUS_VOL (SET): 99" means:
1. Code is 36,
2. Name is BOLUS_VOL
3. Type is SET (not ACT, not ALARM)
4. Value is 99. Note that this is the raw integer value. In the case of
BOLUS_VOL a shift of one decimal place is required to get the final value
of 9.9 ml (as described in the Programmers Guides for Prismaflex and
PrisMax.

PrismaflexRecordPlaybackTool 7 - Instructions.docx Page 5 of 6

Charles Zuelchner
 PrismaflexRecordPlaybackTool 7 - Beta - Instructions

PrismaflexRecordPlaybackTool 7 - Instructions.docx Page 6 of 6

Charles Zuelchner