Serial Commands

help

  • Displays a list of available commands

[terminal command=”help” desktop=”785″ mobile=”785″]help       -Show Help Information
echo on
echo off

Movement Commands
———————————————-
start      -Pump Run
stop       -Pump Stop
pause      -Pump Pause
———————————————-

Setting Commands
———————————————-
set diameter [x.x]        -Pump Set Diameter
set rate [x.x]            -Pump Set Rate
set volume [x.x]          -Pump Set Volume (+infuse,-withdraws)
set delay [xxx]           -Pump Set Delay
set primerate [x.x]       -Pump Set Priming rate
———————————————-

Status Commands
———————————————-
read limit parameter      -Pump Return Max/Min volume & Rate
dispensed volume          -Pump Return volume Dispensed
elapsed time              -Pump Return Time Elapsed
———————————————-

Additional Optional Command
———————————————-
hexw2 [units] [mode] [diameter] [volume] [rate] [delay] – Send All Settings
hexw2 [units] [mode] [diameter] [volume] [rate] [delay] start – Send All Settings and Starts
———————————————-[/terminal]

start

  • Starts the pump with the currently set parameters. The parameters that will run depend upon which mode (Basic Mode or Multi-Step Mode) the pump touchscreen is showing

[terminal command=”start” desktop=”125″ mobile=”125″]Pump start running…[/terminal]

  • Started with a delay

[terminal command=”start” desktop=”125″ mobile=”125″]Pump delay…[/terminal]

pause

  • Pauses the current pump run. The run can be resumed from this point using the start command.

[terminal command=”pause” desktop=”125″ mobile=”125″]Pump pause![/terminal]

stop

  • Ends the current run. The run cannot be resumed and can only be restarted from the beginning.

[terminal command=”stop” desktop=”125″ mobile=”125″]Pump stop![/terminal]

set diameter value

  • Sets the inner diameter (ID) of the syringe in millimeters. This setting simultaneously affects the syringe ID used in both Basic Mode and Multi-Step Mode settings, which will also affect the volume and rate parameters in both modes. value can be an integer or decimal (up to three decimal places) within the parameter limits for the specific pump (e.g., 0.103 mm to 40.000 mm for the Fusion series). This returns the set diameter. If the diameter in the response is not the same as the diameter in the command, then the command diameter was not set. This is probably due to the value being beyond the limit of the specific pump.

[terminal command=”set diameter 4.5″ desktop=”125″ mobile=”125″]diameter = 4.5[/terminal]

set units value

  • Sets the units used for the rate of infusion/withdrawal. This parameter also sets the units for the transfer volume, where the transfer volume unit will be the same as the unit of volume used in the rate. For example if you set the units to mL/hr then the transfer volume is set to mL. If you set the units to μL/min then the transfer volume is set to μL. This setting simultaneously changes the units used in both Basic Mode and Multi-Step Mode settings. value is a number between 0 to 3 that take the values shown below.

    • 0: mL/min

    • 1: mL/hr

    • 2: μL/min

    • 3: μL/hr

  • This command returns the set unit. If the unit in the response is not the same as the units in the command, then the command unit was not set. This is probably because the value was a non-integer or out of the 0 to 3 range.

[terminal command=”set units 1″ desktop=”125″ mobile=”125″]units = 1[/terminal]

  • Unit set value is higher than 3. Notice the unit was not set to 5.

[terminal command=”set units 5″ desktop=”125″ mobile=”125″]units = 1[/terminal]

set volume value1, value2, …

  • Set the transfer volume. The pump will run until the volume infused or withdrawn equals this volume(s). This command also sets whether the pump will infuse or withdraw (Supported models only) and the number of steps used in Multi-Step Mode. valueN must be an integer or decimal (up to five decimal places) within the volume limits for the syringe (See read limit parameter command).

  • A negative sign can be added in front of any volume value to indicate a switch to withdrawal mode (Supported models only). For Basic Mode, only one value is required. Entering only one value will automatically switch the pump to Basic Mode.

    • The units of valueN are set through the units command (see above). The units will be the volume portion of the units. For example, if you set the units to μL/min then the volume units will be μL. If you set the volume to mL/hr then the volume units will be mL.

  • The response to this command is the set volume. So if you set the volume correctly then the response volume should be the same as the volume in the command. If these two values are  not the same then volume , you wanted to set was not set. This is probably due to the command volume being outside the volume limits of the syringe. To check the limits of the syringe send the read limit parameter (see below).

Basic Mode

[terminal command=”set volume 1″ desktop=”145″ mobile=”145″]volume = 1[/terminal]

Multi-Step Mode

[terminal command=”set volume .1, -.1, .2″ desktop=”125″ mobile=”125″]volume = 0.1, -0.1, 0.2[/terminal]

Basic Mode – Out of Range

  • The max volume is less than 1. So it could not set the volume that high.

[terminal command=”set volume 1″ desktop=”145″ mobile=”145″] volume = 0.00047
rate = 0.00047
time = 1.00
[/terminal]

Multi-Step Mode – Out of Range

[terminal command=”set volume 500, -500″ desktop=”125″ mobile=”125″]volume = 1,-1[/terminal]

set time value1, value2, …

  • Sets the target time for a pump run. This will adjust the transfer rate so that the run will last for the input time. The target volume will remain the same.

  • This command also sets the number of steps used in Multi-Step Mode. valueN must be an integer or decimal (up to five decimal places). The resulting transfer rate must be within the rate limits for the syringe (See read limit parameter command). For Basic Mode, only one value is required. Entering only one value will automatically switch the pump to Basic Mode.

  • The response to this command is the time that was set. If the time leads to a rate that is out of the range for the syringe pump than the pump returns the set time and the rate as seen in the example below.

Basic Mode

[terminal command=”set time 1.1″ desktop=”125″ mobile=”125″]time = 1.1
rate = 0.90909
[/terminal]

Multi-Step Mode

[terminal command=”set time 21.0, 12.20, 6.351″ desktop=”125″ mobile=”125″]time = 21
rate = 0.04762, 0.08197, 0.4918
[/terminal]

Multi-Step Mode – Out of Range

[terminal command=”set time 1000″ desktop=”145″ mobile=”145″]time = 1.1
rate = 0.00043
[/terminal]

set rate value1, value2, …

  • Sets the transfer rate for infusion/withdrawal. valueN must be an integer or decimal (up to five decimal places) within the rate limits for the syringe (see read limit parameter command). For Basic Mode, only one value is required.

  • The response returns the set flow rate and time to complete infusing or withdrawing the volume. If the rate is beyond the limits then the rate given in the response will be different than the set rate as seen in the second example below. In multi-step mode the time is not returned.

Basic Mode

[terminal command=”set rate 1.5″ desktop=”145″ mobile=”145″]rate = 1.5[/terminal]

Set value higher than max limit. Notice rate was not adjusted.

[terminal command=”set rate 10″ desktop=”145″ mobile=”145″]rate = 1.5[/terminal]

Set value is negative. The absolute value of the rate is taken and set on older Chemyx units.

[terminal command=”set rate -1.0″ desktop=”145″ mobile=”145″]rate = -1[/terminal]

Multi-Step Mode

[terminal command=”set rate 1.2, 0.5″ desktop=”125″ mobile=”125″]rate = 1.2, 0.5[/terminal]

set delay value1, value2, …

  • Sets the start time delay (in minutes) prior to each step of a pump run. Upon starting a step with a delay, the pump will wait until the delay time elapses before starting to transfer volume. valueN must be an integer or decimal (up to five decimal places) within the rate limits for the syringe (see read limit parameter command). For Basic Mode, only one value is required. Entering only one value will automatically switch the pump to Basic Mode.

  • The response contains the delay time for each step.

Basic Mode

[terminal command=”set delay 2″ desktop=”140″ mobile=”140″]delay = 2[/terminal]

Multi-Step Mode

[terminal command=”set delay 2.5, 1.25″ desktop=”125″ mobile=”125″]delay = 2.5, 1.25[/terminal]

read limit parameter

  • Returns the min/max values that can be set for transfer volume and transfer rate. The returned values are dependent on the syringe inner diameter (ID). The transfer volume limits are typically greater than the maximum volume of the syringe being used. Returns: max rate, min rate, max volume, min volume. The volume units returned will be set by the set units command.

[terminal command=”read limit parameter” desktop=”125″ mobile=”125″]1.71307 0.00010 1.72474 0.00015[/terminal]

dispensed volume

  • Returns the transferred volume for the current run/step. If no run has started, returns the transferred volume for the last run/step.

[terminal command=”dispensed volume” desktop=”125″ mobile=”125″]dispensed volume = 0.00049[/terminal]

elapsed time

  • Returns the elapsed time (in minutes) for the current run/step. If no run has started, returns the elapsed time for the last run/step. Elapsed time does not include any delay time.

[terminal command=”elapsed time” desktop=”125″ mobile=”125″]elapsed time = 0.51667[/terminal]

view parameter

  • Returns the currently set parameters (Basic Mode only). Returns: rate units, syringe inner diameter, transfer rate, priming rate, time (in whole number minutes), transfer volume, time delay (in whole number minutes).

[terminal command=”view parameter” desktop=”260″ mobile=”260″]unit = 0
dia = 4.64
rate = 0.500000
primerate = 2.345000
time = 3
volume = 1.700000
delay = 0
[/terminal]

status

  • Returns the current status of the pump. The returned integer correlates to the status of the pump. Returns the integer that corresponds to the current status of the pump.

    • 0: Pump stopped

    • 1: Pump running

    • 2: Pump paused

    • 3: Pump delayed

    • 4: Pump stalled

[terminal command=”pump status” desktop=”125″ mobile=”125″]1[/terminal]

hexw2

  • Sets multiple parameters in one command (Basic Mode only).X variables in order:units: see set units command transfer mode: 0-infusion, 1-withdrawal syringe ID: see set diameter command transfer volume: see set volume command (no negative values)transfer rate: see set rate command start time delay: see set delay command The following example shows the command using these parameters: units = mL/min; transfer mode = withdrawal; diameter = 23.05 mm; volume = 1.2 mL; rate = 3.0 mL/in; delay = 30 sec (0.5 min).

  • A start command can be added after the six parameters to immediately start the run with the new parameters.

  • All six parameters do not need to be entered; however, all parameters up to the parameter(s) of interest must be also be included. The other parameters not entered will remain as they are currently set.

[terminal command=”hexw2 0,1,23.05,1.2,3.0,0.5″ desktop=”125″ mobile=”125″]hexw2 0,1,23.05,1.2,3.0,0.5[/terminal]

[terminal command=”hexw2 0,1,23.05,1.2,3.0,0.5,start” desktop=”125″ mobile=”125″]hexw2 0,1,23.05,1.2,3.0,0.5,start[/terminal]

[terminal command=”hexw2 0,1,23.05″ desktop=”125″ mobile=”125″]hexw2 0,1,23.05[/terminal]

set primerate value

  • Sets the priming/bolus rate (Basic Mode only). value must be an integer or decimal (up to five decimal places) within the rate limits for the syringe (see read limit parameter command). Only one value is entered.

  • The response is the priming/bolus rate

[terminal command=”set primerate 1.0″ desktop=”125″ mobile=”125″]prime rate = 1[/terminal]

restart

  • Powers off and then automatically powers on the pump

[terminal command=”restart” desktop=”125″ mobile=”125″]restart[/terminal]

Bad Syntax

When the pump does not recognize a command, it will return text similar to the following. Note that if the command is expecting a value for example set unit or set diameter and a value is not present it will return this response.

[terminal command=”Bad command” desktop=”145″ mobile=”145″]Bad command
Command not recognized-type in “help”
and press enter to see a command list.
[/terminal]

Contact Chemyx

Contact our support team about Chemyx Syringe Pump products & services. We have experienced engineers to help you choose the right syringe pump product for your application!

CONTACT