PTW MULTIDOS User Manual

Download

User Manual

MULTIDOS

RS232 Interface

D177.131.2/0 2003-07 Di/Se

MULTIDOS

RS232 Interface

For your notes

2 D177.131.2/0

MULTIDOS

RS232 Interface

Contents

1 FOR YOUR SAFETY 4

2 GENERAL 5

3 INTERFACE CONFIGURATION 5

4 PRINCIPLES OF COMPUTER COMMUNICATION 5

5 GENERAL TELEGRAMS 6

5.1 Device Identification 6

5.2 Keyboard 6

5.3 Basic Device Settings 6

5.4 Controlling a Measurement 6

5.5 Error Codes 6

5.6 Status telegrams 7

6 BRIEF DESCRIPTION 8

7 APPLICATION DUAL CHANNEL DOSEMETER 9

7.1 Basic Settings 9

7.2 Data telegrams 10

7.3 Correction Telegrams 11

7.4 Calibration Factors 11

8 APPLICATION MULTI CHANNEL DOSEMETER 12

8.1 Basic Settings 12

8.2 Data telegrams 12

8.3 Correction Telegrams 13

8.4 Calibration Factors 13

9 APPLICATION CONSTANCY CHECK 14

9.1 Basic Settings 14

9.2 Data telegrams 15

9.3 Correction Telegrams 16

9.4 Calibration Factors 16

9.5 Errors 16

10 APPLICATION LINEAR ARRAY LA 48 17

10.1 Basic Settings 17

10.2 Data telegrams 17

11 APPLICATION AFTERLOADING 20

11.1 Basic Settings 20

11.2 Control Telegrams 20

11.3 Data telegrams 21

11.4 Calibration Factors 22

D177.131.2/0 3

1 For your Safety

− This document is a supplement to the PTWMULTIDOS User Manual and is valid only in conjunction with that manual.

− The safety statements given in both user manuals are applicable and must be observed.

− In addition to these safety statements, please note that devices connected to the interface described in this manual must fulfill the requirements of the IEC standard 60950 or IEC 61010-1 (EN 61010-1).

MULTIDOS

RS232 Interface

For your Safety

PTW-FREIBURG Physikalisch-Technische Werkstätten Dr. Pychlau GmbH Lörracher Str. 7 79115 Freiburg GERMANY Phone: +49 761 49055-0 Fax: +49 761 49055-70 info@ptw.de www.ptw.de

4 D177.131.2/0

MULTIDOS

RS232 Interface

General

2 General

To get used to the MULTIDOS serial communication, we recommend to use a terminal program like the Microsoft-Windows HyperTerminal.

3 Interface Configuration

MULTIDOS RS232 interface:

Baud rates: 4800, 9600, 19200,

38400 (recommended)

Code: 8 data bits

Stop bit: 1 stop bit

Parity: none

If the COM port of your personal computer has a 9 pin D connector (standard IBM layout), use a PTW cable L178012 (2m), L178026 (5m) or T22373/K67-

30. If it has a 25 pin connector, use a gender changer additionally.

4 Principles of Computer Communication

Between MULTIDOS and the connected PC, data is exchanged by means of sequences of ASCII characters which are concluded by the characters CR (carriage return, hexadecimal 0D) and LF (line feed, hexadecimal 0A). This sequences are called telegrams. The CRLF end mark is omitted in all telegram descriptions. For all communication, a strict ping pong principle must be observed: after sending a telegram to the MULTIDOS, the PC program must wait for the answer from MULTIDOS, before it may send a new telegram.

NOTE

In this text, the character • is used to depict a space character contained in a telegram.

Pin assignment:

Pin MULTIDOS signal 2 TxD (out) 3RxD (in) 45SGND 67CTS (in) 8 RTS (out)

Pins 4 and 6 are internally connected. By this, an external DTR signal may be returned as DSR to the external device.

Either RTS/CTS hardware handshake or no handshake may be used.

D177.131.2/0 5

MULTIDOS

RS232 Interface

General Telegrams

5 General Telegrams

These telegrams are valid for all MULTIDOS applications.

5.1 Device Identification

Telegram Description Response

PTW Read device information. x.xx is the firmware version, u describes the ra-

diological unit

SER Read MULTIDOS serial number SERxxxxxx

5.2 Keyboard

Telegram Description Response

Kx Disable or reenable the MULTIDOS keyboard. Parameter x: 0 = disabled, 1

= enabled

MULTIDOS•x. xxu

5.3 Basic Device Settings

Telegram Description Response

Lx Set/Read language setting. Parameter x: E = Englisch, D = German Idddd Set/Read interval time. Parameter dddd: 0006 up to 9999 Aa Set/Read the MULTIDOS application. Parameter a: A = Afterloading, C =

Constancy Check, D = Dual Dosemeter, M = Multi Channel, L = Linear Array.

Wait 5 seconds after sending Aa Aquit Restart the current application. Wait 5 seconds after sending Aquit Aquit BRbbbbb Set/Read baud rate. Parameter bbbbb: 04800, 09600, 19200, 38400

Lx Idddd Aa

BRbbbbb

5.4 Controlling a Measurement

Telegram Description Response

STA Equivalent to <STA> key STA INT Equivalent to <INT> key INT RES Equivalent to <RES> key RES HLD Equivalent to <HLD> key HLD NUL Equivalent to <NUL> key. Response NUL or E06 is send after 28 seconds NUL Mx Set/Read measuring mode. Parameter x: 0 = Dose, 1 = Doserate S Read measurement status.

Valid values of parameter sss: RES, STA, HLD, INT, RUN, NUL, ERR

Mx Ssss

5.5 Error Codes

Error code Description

E01 Unknown command or illegal parameter E02 Command in wrong context (STA for doserate measurement, etc.) E03 Command not allowed at the moment (MULTIDOS is in a menu) E06 Error during zeroing E07 Answer could not be sent (transmission buffer full) E09 Error during write to EEPROM E10 Parameter out of limits

6 D177.131.2/0

MULTIDOS

RS232 Interface

General Telegrams

5.6 Status telegrams

Telegram Description Response

SC Calibration status of the actual unit of measurement, involving all components

contributing to data acquisition, as there might be a reference or monitor chamber. Parameter x: 0 = any of the components involved is uncalibrated, 1 = all used components are calibrated. x = 0 conforms to a „uncalibrated“ message on the display

Note: An electrical measurement will have the calibration status 1, even if the radiological calibration factors stored in MULTIDOS are marked „uncalibrated“ (= set to default), as long as the electrical calibration is marked to be „calibrated“.

Telegram Description Response

SD Device status. iiiii is a five digit decimal number, whose bits, when converted

to binary representation, signal the following condition when the bit is set: .0 Þ MULTIDOS display is not accessible (command timeout) .1 Þ MULTIDOS display is not accessible (automode timeout) .2 Þ electrical calibration possible .3 Þ Set1 of application dual channel is write protected .4 Þ radiological unit is Roentgen .5 Þ reference temperature for air density correction is 22°C .6 Þ HV error .7 Þ ME 48 is connected to MULTIDOS .0 is the least significant bit

SCx

SDiiiii

Note: If bit .0 or .1 is set, the display is not operational. The firmware still continues to execute and to measure, but all display operations are omitted, the display will no longer be refreshed. The measured values, available by the D telegrams, are still correct.

Telegram Description Response

Note: There will never be more than one bit set at once, since MULTIDOS checks all error sequentially. Because of that, each error condition corresponds to a discrete value of ddddd.

ddddd is always equal to 00000, as long as the response to the S telegram is not SERR. SE is designed to give a more detailed information of the error type.

Reads the error number. ddddd is a five digit decimal number, whose bits, when converted to binary representation, signal the following error condition, if the bit is set: .0 Þ error at calculation of measurement multipliers .2 Þ error during data acquisition .4 Þ EEPROM corrected (non critical) .6 Þ EEPROM error (critical) .0 is the least significant bit

SEddddd

D177.131.2/0 7

MULTIDOS

RS232 Interface

Brief Description

6 Brief Description

Perform steps 1 to 5 in the given sequence to set up the MULTIDOS and read out measured data.

Step 1: physical setup

Connect the RS232 cable to the desired COM port of your personal computer. Switch the MULTIDOS on and set it manually to the desired application. Set up the following items: unit, absolute or relative readings, measuring mode, interval time, baudrate. Note that MULTIDOS will reawake in this configuration, when it is switched on again.

Step 2: open communication

Start the communication program on your PC. The program must be set up correctly! Telegram Response Description PTW MULTIDOS Correct response signals proper communication setup and that MULTIDOS

is ready for communication. See note 1

SER SERxxxxxx Correct response signals the MULTIDOS is ready to measure

Set/Read the MULTIDOS application. Parameter a: A = Afterloading, C = Constancy Check, D = Dual Dosemeter, M = Multi Channel, L = Linear Array. Sending A reads the current application, sending A with parameter changes the application.

Notes:

1. The answer must return within 3 seconds. The first seven characters of the response telegram must be

MULTIDOS (the response itself contains more characters). Repeat this telegram three times maximum, if you do not receive the expected response or no response at all.

2. For all telegrams: if the expected response is not received, MULTIDOS is set up in a wrong way.

Step 3: zero adjustment

Telegram Description Response NUL The response is sent at the end of the procedure after approx. 35 seconds max.

If zeroing fails, E06 is responded instead of NUL. Obey the warm up time and the guidelines for zeroing.

Step 4: set up and start measurement

Telegram Description Response Ixxxx Set the interval time between 6 und 9999 seconds (replace Parameter xxxx by

0006 to 9999). Only necessary to alter a previous setting.

STA Same effect as the <STA> key STA INT Same effect as the <INT> key INT

Note: During a running measurement a new measurement may be immediately started by STA or INT.

Set/Read MULTIDOS measuring mode. Parameter x: 0 = Dose/Charge, 1 = Doserate/Current Sending M reads the current mode, sending M with parameter changes the mode.

NUL

Ixxxx

Step 5: read measured values

Telegram Description Response D Reads the measured values see application chapters in this manual

During serial communication, it is recommended to disable the MULTIDOS keyboard by the K0 telegram. All MULTIDOS setup (used unit and measuring mode, reference used or not, etc.) can also be done by telegrams. If MULTIDOS is running in menu mode, all telegrams with the exception of PTW will be responded by E03.

8 D177.131.2/0

MULTIDOS

RS232 Interface

Application Dual Channel Dosemeter

7 Application Dual Channel Dosemeter

Telegrams containing parameters alter a setting. If the parameter is omitted in the telegram, the actual setting is returned. For clarification parameters are printed in Example:

I0044 sets the interval time, I reads the actual interval time and is answered by I0044.

7.1 Basic Settings

Telegram Description Response

PWxP Set/Read the password protection. Parameter x: 0 = clear protection, 1 =

Set protection. P is the password string as described in the MULTIDOS User Manual

Qx Set/Read the type of data readings on the display. Parameter x: 0 = abso-

lute values, 1 = relative values (channel 2 divided by channel 1)

Rxy Set/Read range settings. Parameter x: setting of channel 1. Parameter y:

setting of channel 2. Valid values of x and y: L = Low, H = High, - = keep current setting. Valid values of the response o and t: L or H. o is the setting of channel 1, t the setting of channel 2

Rxy Set/Read range settings. Parameter x: setting of channel 1. Parameter y:

setting of channel 2. Valid values of x and y: L = Low, H = High, - = keep current setting. Valid values of the response o and t: L or H. o is the setting of channel 1, t

the setting of channel 2 SETs Set/Read the calibration set to be applied. Parameter s: 1 up to 5 SP Read the protection setting of the calibration data. Parameter p is a one

digit number, whose bits show the protection status: bit .0 is set = pass-

word protection is set, bit .1 is set = hardware protection is active Ux Set/Read unit of measurement. Parameter x: A = Ampere, S = Gy/s, M =

Gy/min, H = Gy/h

italic.

PWx

Rot

SETs SPp

D177.131.2/0 9

MULTIDOS

RS232 Interface

Application Dual Channel Dosemeter

7.2 Data telegrams

7.2.1 Read measured values

The response to a data telegram consists of various fields, separated by semicolons. The fields contain parameters and text. The response to the D telegram is: Dm;ttttt.ns;sss;FL;O;L;M;±m.mmmE±ee;a;±m.mmmE±ee;a;·####.#;bbbbb The measured values and resolution indicators are that of the actual measuring mode and are transmitted channel 1 first, followed by channel 2. The ratio is always transmitted, even if absolute values are displayed (see below).

7.2.2 Description of parameters

ttttt.n

sss

±m.mmm

E±ee

Actual measuring mode. Valid values: 0 Þ Dose or Charge, 1 Þ Doserate or Current Elapsed measurement time. Consists of seven characters. Small numbers are right justified,

with leading spaces. Parameter n can have the values of 0 or 5. If the maximum measurement time of 64800 seconds is exceeded, OL••••• will be transmitted.

Measurement status. Valid values: RES, STA, HLD, INT, RUN, NUL, ERR. Global flags. A two digit number, whose set bits, when converted to binary representation,

signal the following error: .0 Þ any of both channels is overloaded at the moment .1 Þ math error in any channel .2 Þ MULTIDOS data acquisition error .3 Þ MULTIDOS HVerror at the moment .4 Þ overload in any of both channels since the start of a dose measurement .5 Þ MULTIDOS HV error since the start of a dose measurement .0 is the least significant bit

Overload flags of the doserate / current measurement. One digit, whose set bits, when converted to binary representation, signal the following errors: .0 Þ overload in channel 1 .1 Þ overload in channel 2

Latched overload flags of the dose / charge measurement. One digit, whose set bits, when converted to binary representation, signal the following errors: .0 Þ overload in channel 1 since the start of a dose measurement .1 Þ overload in channel 2 since the start of a dose measurement

Math error flags of the actual measurement mode. One digit, whose set bits, when converted to binary representation, signal the following errors: .0 Þ math error in channel 1 .1 Þ math error in channel 2

Mantissa of the measured value. This field consists of six characters. Smaller numbers are right justified, with leading spaces. Positive numbers use a space character instead of the minus sign. If the limits of representation (±999.9E+20) are exceeded, +0L••• or -0L••• will be transmitted, depending on the sign.

Exponent of the measured value. Two digit number, with leading zeroes if necessary. The sign is always transmitted, either as + or -. If the limits of representation are exceeded, •••• will be transmitted.

Resolution of the measured value. One digit. Valid values: 2 Þ resolution below 1% (conforming to ** on the measuring screen) 1 Þ resolution below 0.5% (conforming to *) 0 Þ resolution is 0.5% or better

10 D177.131.2/0

MULTIDOS

RS232 Interface

Application Dual Channel Dosemeter

•####.#

bbbbb

7.2.3 Read maximum value

The response to the DMc telegram is DMc•m.mmE±ee where c is the channel number (valid values are 1 or 2). The transmitted value is the maximum value of the doserate / current measurement for the active unit (radiological or electrical) and actual measuring range of that channel. The value is formatted in scientific notation.

7.2.4 Read Resolution

The response to the DRc telegram is DRc•0.mmmE±ee where c is the channel number (valid values are 1 or 2). The transmitted value is the resolution of the actual measuring mode for the active unit (radiological or electrical) and actual measuring range of that channel. The number of digits following the decimal point may vary from 1 to 3.

Ratio of measured value of channel 2 divided by the measured value of channel 1, given in percent. The decimal point position is fixed. Smaller numbers are right justified, with leading spaces. Positive numbers use a space character instead of the minus sign. If the maximum representable ratio of ±9999.9 is exceeded, •####.# will be transmitted. If one of the measured values exceeds it limits of representation, •----.- will be transmitted.

Block check sequence of the response. This is a five digit number, representing a 16 bit unsigned integer, with leading zeroes if necessary. The block check sequence is calculated starting from the first character of the response up to the character preceding bbbbb and must be equal to the value of bbbbb.

7.2.5 Measuring unit

Telegram Response

Reads the absolute unit of measurement of the active measuring mode. Possible values of u: when MULTIDOS is set to radiological units: Gy Gy/s Gy/min Gy/h when MULTIDOS is set to electrical units: C A

DUu

7.3 Correction Telegrams

Telegram Description Response

KSx Set/Read the correction setting. Parameter x: 0 = correction off, 1 = on KPp Set/Read the value of the atmospheric pressure p. p = 0500.0 … 1300.0 KTt Set/Read the value of the ambient temperature t. t = 10.0 … 40.0 KTR

KD KKck Set/Read the overall correction factor k of channel c. k = 0.500 … 2.000

Read the setting of the reference temperature. Parameter x: 0 = 20°C, 1 =

22°C

Read the calculated air density correction factor kD

KSx KPnnnn.n KTnn.n KTRx

KDn.nnn KKcn.nnn

7.4 Calibration Factors

Telegram Description Response

CRsFcf Set/Read the calibration factor f of channel c of set s CRsNname Set/Read the name of set s. name is a string of 19 characters max. CRsTcid Set/Read the ID of channel c of set s. id is a string of 15 characters max. CRsQq

CRsUx Update (x = 1)/Read (no x) the result of the check sum protection of set s CRsBbbbbb Set/Read the block check value bbbbb of set s

Set/Read the measuring quantity of set s. Parameter q: W = Dw, A = Ka, S

= Js

CRsFccf CRsNname CRsTccid CRsQq

CRsUx CRsBbbbbb

D177.131.2/0 11

MULTIDOS

RS232 Interface

Application Multi Channel Dosemeter

8 Application Multi Channel Dosemeter

Telegrams containing parameters alter a setting. If the parameter is omitted in the telegram, the actual setting is returned. For clarification parameters are printed in Example:

I0044 sets the interval time, I reads the actual interval time and is answered by I0044.

8.1 Basic Settings

Telegram Description Response

Ux Set/Read unit of measurement. Parameter x: A = Ampere, S = Gy/s, M =

Gy/min, H = Gy/h Rx Set/Read measuring range. Parameter x: L = range Low, H = range High SETs Set/Read the calibration set to be applied. Parameter s: 1 up to 5

8.2 Data telegrams

8.2.1 Read measured values

italic.

Rx SETs

The response to the Dmima;m;ttttt.ns;sss;FL;lm;um;am;OOOO;LLLL;MMMM;Kbbbbb

The various fields contain the following information:

mi ma m ttttt.n sss FL lm um am OOOO LLLL MMMM K bbbbb

The field

8.2.2 Read Resolution

The response to the DRc telegram is DRcc0.mmmE±ee where cc is the channel number (valid values are 01 to 12). The transmitted value is the resolution of the actual measuring mode. The number of digits following the decimal point may vary from 1 to 3.

number of first channel to be read (01 … 12) number of last channel to be read (01 … 12) actual measuring mode (0 = Dose, 1 = Doserate) elapsed measuring time actual measurement status. String of 3 characters global measurement flags as Overload in any channel, HVerror, etc. Two digit number number of maximum channel of group 1-6 (marked on display by ‘<‘). Two digit number number of maximum channel of group 7-12 (marked on display by ‘<‘). Two digit number number of absolute maximum channel (marked on display by ‘<<‘). Two digit number overload flags of the doserate measurement of all 12 channels. Four digit number overload flags of the dose measurement of all 12 channels. Four digit number MathError flags of the actual measuring mode. Four digit number measured values of all requested channels. See below block check value of the data telegram. Five digit number

K consists of (ma-mi+1) values of the following format: ±m.mmmE±ee;

Dmima telegram is:

8.2.3 Measuring unit

Telegram Response

12 D177.131.2/0

DUu

MULTIDOS

RS232 Interface

Application Multi Channel Dosemeter

8.3 Correction Telegrams

Telegram Description Response

KD KKk Set/Read the overall correction factor k. k = 0.500 … 2.000

Read the setting of the reference temperature. Parameter x: 0 = 20°C, 1 = 22°C Read the air density correction factor kD

KSx KPnnnn.n KTnn.n KTRx

KDn.nnn KKn.nnn

8.4 Calibration Factors

Telegram Description Response

CRsFccf Set/Read the calibration factor f of channel cc of set s CRsIx Set/Read the ‘Is calibrated’ flag of set s.

Parameter x: 0 = uncalibrated, 1 = calibrated

CRsNname Set/Read the name of set s.

Parameter name: string of 19 characters max. (spacers allowed)

CRsTccid Set/Read the ID id of channel cc of set s.

Parameter id: string of 15 characters max. (spacers allowed)

CRsDdd.mm.

yyyy

CRsUx Update (x = 1)/Read (no x) the result of the check sum protection of set s CRsBbbbbb Set/Read the block check value bbbbb of set s

Set/Read the calibration date of set s

CRsFccf CRsIx

CRsNname

CRsTccid

CRsDdd.mm. yyyy CRsUx CRsBbbbbb

D177.131.2/0 13

MULTIDOS

RS232 Interface

Application Constancy Check

9 Application Constancy Check

Telegrams containing parameters alter a setting. If the parameter is omitted in the telegram, the actual setting is returned. For clarification parameters are printed in Example:

− If the unit is changed, the measurement is continued and the measuring values are re-calculated to the

− All telegrams that begin with X are only valid in XMODE. The XMODE is activated with XM1. If it is not ac-

It is only possible to select a set if the set is calibrated or if it is possible to calibrate the MULTIDOS or if the MULTIDOS is in XMODE or if there is no calibrated set at all.

I0044 sets the interval time, I reads the actual interval time and is answered by I0044.

new measuring unit.

tivated, you get E01 back as the telegram response.

9.1 Basic Settings

italic.

Telegram Description Response

Ux Set/Read unit of measurement. Parameter x: 1 = Ampere, 2 = Gy/s, 3 =

Gy/min, 4 = Gy/h Rx SETs Set/Read the calibration set to be applied. Parameter s: 1 up to 5 V Checking whether Gray or Röntgen, 0 : Gray

XMx

XDx

Set/Read range settings. 1: Range Low, 2: Range High Rx

1 : Röntgen x = 0: Switching of the extension mode x = 1: Switching on the extension mode Read/Set the display mode 0: normal, 1: omit the renewing of the display

SETs Vx

XMx

XDx

14 D177.131.2/0

MULTIDOS

RS232 Interface

Application Constancy Check

9.2 Data telegrams

The response to a data telegram consists of various fields, separated by semicolons. The fields contain parameters and text.

9.2.1 Description of parameters

m u unit of measurement. Parameter x: 1 = Ampere, 2 = Gy/s, 3 = Gy/min, 4 = Gy/h

ttttt.n

sss

±m.mmm mmm

E±ee

bbbbb

Channel number, consisting of two characters. Valid values: 01 to 12or the channels 1 to 12

Actual measuring mode. Valid values: 0 Þ Dose or Charge, 1 Þ Doserate or Current

Elapsed measurement time. Consists of 7 characters. Small numbers are right justified, with leading spaces. n can take the values 0 or 5. If the maximum measurement time of 64800s is exceeded, OL••• will be transmitted.

Measurement status. Valid values: RES, STA, HLD, INT, RUN, NUL, ERR. Global flags. A two digit number, whose bits, when set to one, signal the following:

.0 Þ any of all channels is overloaded .1 Þ math error in any channel

.2 Þ MULTIDOS data acquisition error .3 Þ MULTIDOS HVerror .4 Þ MULTIDOS electrically uncalibrated .5 Þ MULTIDOS electrically uncalibrated

Mantissa of the measured value. This field consists of 9 characters. Smaller numbers are right justified, with leading spaces. Positive numbers use a space character instead of the minus sign. If the limits of representation (±999.9E+20) are exceeded, +0L••• or -0L••• will be transmitted, depending on the sign.

Exponent of the measured value. Two digit number, with leading zeroes if necessary. The sign is always transmitted, either as + or -.

highest channel number for data transmission with DA telegram Valid values: 01 to 12.

9.2.2 Data telegrams

Telegram Response

DA;ma DA;ma;ttttt.ns;m;u;Kbbbbb

Reads the measured values of channels 1 to ma

K contains the measurement data and consists of ma parts: FL;±m.mmmmmmE±ee; K contains no channel numbers, the data is transmitted in the order from channel 1 to channel ma.

Telegram Response

D;cc D;cc;ttttt.ns;m;u;FL;±m.mmmmmmE±ee;bbbbb

Reads the measured value of a single channel.

D177.131.2/0 15

MULTIDOS

RS232 Interface

Application Constancy Check

9.3 Correction Telegrams

Telegram Description Response

C;x CP;xxxx.x CT;xx.x CD Checking the correction factor temperture/air density without kQE CD;x.xxxx CK;x.xxxx

Set/Read Air Density Correction 0: Off 1: On C;x Set/Read nominal air pressure (500.0 <= p <= 1300.0), default: 1013.2hPa CP;xxxx.x Set/Read the temperature (10.0 <= T <= 40.0), default: 20/22°C CT;xx.x

Set/Read Beam Quality Factor. (0.0000 < kQE <= 2.0000), default: 1.0000 CK;x.xxxx

9.4 Calibration Factors

Telegram Description Response

XR;s;cc;f Set/Read the radiological calibration factor for channel cc in set s

XRF;s Set/Read the flag for set s for radiologically calibrated/uncalibrated

0: not calibrated, 1: calibrated

XRN;s;name Set/Read the name for set s with radiological calibration factors XRD;s;dd.mm

.yyyy

XRC;s Renew the check sum radiological calibration factor for set s

Set/Read the radiological calibration date for set s

XR;s;cc;±m.m mmmE+ee XRF;s;x

XRN;s;name XRD;s;dd.mm .yyyy XRC;s

9.5 Errors

Telegram Description Response

ERR Checking the error status flag of MULTIDOS

Bit0: MENU_ERROR Bit1: ELCAL_ERROR Bit2-7: not used Bit8: RADCAL_ERROR Set 1 Bit9: RADCAL_ERROR Set 2 Bit10: RADCAL_ERROR Set 3 Bit11: RADCAL_ERROR Set 4 Bit12: RADCAL_ERROR Set 5 Bit13-15: not used

ERR;xxxxx

16 D177.131.2/0

MULTIDOS

RS232 Interface

Application Linear Array LA 48

10 Application Linear Array LA 48

Telegrams containing parameters alter a setting. If the parameter is omitted in the telegram, the actual setting is returned. For clarification parameters are printed in italic. Example: I0044 sets the interval time, I reads the actual interval time and is answered by I0044.

10.1 Basic Settings

Telegram Description Response

Ux Set/Read unit of measurement. Parameter x: A = Ampere, S = Gy/s, M = Gy/min,

H = Gy/h

Rx Set/Read setting of reference channel. Parameter x: 0 = without reference, 1 =

refer to reference chamber, 2 = refer to monitor signal

10.2 Data telegrams

The response to a data telegram consists of various fields, separated by semicolons. The fields contain parameters and text. The format of the response to the Dcc and DA telegrams differs, depending if measuring against a reference signal is set up or not.

10.2.1 Description of parameters

ttttt

sss

Channel number, consisting of two characters. Valid values: 01 to 47 for the LA 48 channels 1 to 47 R• for the reference channel, M•for the monitor signal V1 addresses the channel which measures the 900 volts, V4 that to measure the 400 volts

Measuring mode. Valid values: 0 Þ Dose or Charge, 1 Þ Doserate or Current Elapsed measurement time. Consists of five characters. Small numbers are right justified, with

leading spaces. If the maximum measurement time of 64800s is exceeded, OL••• will be transmitted.

Measurement status. Valid values: RES, STA, HLD, INT, RUN, NUL, ERR. Flags for a single channel. One digit, whose bits, when converted to binary representation,

signal the following errors when the bit is set: .0 Þ overload in that channel .1 Þ math error in that channel .0 is the least significant bit.

Global flags. A two digit number, whose bits, when set to one, signal the following: .0 Þ any of all channels is overloaded (including reference or monitor, if used) .1 Þ math error in any channel (including reference or monitor, if used) .2 Þ MULTIDOS data acquisition error .3 Þ MULTIDOS HVerror .4 Þ 900 volts error in ME 48 .5 Þ 400 volts error for reference chamber

Resolution of the reference (chamber or monitor, whichever is used). One digit. Valid values: 2 Þ resolution below 1% (conforming to ** on the measuring screen) 1 Þ resolution below 0.5% (conforming to *) 0 Þ resolution is 0.5% or better

D177.131.2/0 17

MULTIDOS

RS232 Interface

Application Linear Array LA 48

±m.mmm

Mantissa of the measured value. This field consists of six characters. Smaller numbers are right justified, with leading spaces. Positive numbers use a space character instead of the minus sign. Notes: For channels 1 to 47 and if measurement against reference is used, this field may have the „values“ >=1000 and <•5E-4 If the limits of representation (±999.9E+20) are exceeded, +0L••• or -0L••• will be transmitted, depending on the sign.

E±ee

Exponent of the measured value. Two digit number, with leading zeroes if necessary. The sign is always transmitted, either as + or -. For channels 1 to 47 and if measurement against reference is used, the exponent field will be omitted. If the limits of representation are exceeded, •••• will be transmitted.

Setting of the reference selection. Valid values: 0 = no reference, 1 = referred to reference chamber, 2 = referred to monitor signal.

bbbbb

Number of that LA 48 channel having the smallest absolute value. Valid values: 01 to 47 Number of that LA 48 channel having the largest absolute value. Valid values: 01 to 47

10.2.2 Single channel data

Dcc

01 .. 47 01 .. 47 R• or M• V1 or V4

Response Notes

Without reference: Dcc;m;ttttts;sss;±m.mmmE±ee;f;FL;bbbbb With reference: Dcc;m;ttttts;sss;±m.mmm;f;FL;bbbbb Dcc;m;ttttts;sss;±m.mmmE±ee;f;FL;a;bbbbb Dcc;m;ttttts;sss;±m.mmmE±ee;f;FL;bbbbb

1 2, 3 4, 5

Reads the measured value of a single channel.

Notes:

1. For LA 48 channels, when using a reference, the exponent field is omitted (rational number, as displayed on the measuring screen)

2. DR• or DM• is only allowed if the corresponding reference is activated. Otherwise the response will be E02.

3. The response contains the resolution of the channel additionally

4. This values always have an exponent field, independent from the reference setting

5. In both measuring modes the value of the measured high voltage is responded

Examples:

1. The measuring mode may be doserate, the measuring status may be HLD, no reference used, the measured value of channel 14 at the HLD-time may have been 27.7mGy/s, MULTIDOS may show a HVError, the HLD state has been entered after 31 seconds. The response to the D14 telegram will be D14;1;•••31s;HLD;••27.7E-03;0;08;43712 (the block check sequence is fictitious)

2. The measuring mode may be dose, the reference chamber may be used as reference, whose measured value of -1.4µGy may have a resolution worse than 1%. An interval measurement may be started but the HLD state has not yet been reached, the actual measurement time may be 21 seconds. The 900 volts of the ME 48 may be out of limits. The response to the DR• telegram will be DR•;0;•••21s;INT;••-1.4E-06;0;16;2;00413 (the block check sequence is fictitious)

18 D177.131.2/0

10.2.3 Data of all channels

Telegram Response

MULTIDOS

RS232 Interface

Application Linear Array LA 48

DAm;ttttts;sss;r;mi;ma;FL;[R]Kbbbbb

Reads the measured values of all channels simultaneously. Notes:

1. R is an optional field, which is only transmitted when a reference is used. The [] are not transmitted, they

only depict the optional character of the field. It contains the measurement data of the activated reference and consists of the following fields: ±m.mmmE±ee;f;a;

2. K contains the measurement data of the 47 channels and consists of 47 parts looking like this:

±m.mmm[E±ee];f; If a reference is used, the exponent field is not transmitted. K contains no channel numbers, the data is transmitted in the order from channel 1 to channel 47.

Length of the response (including DA, without CR LF): with reference: (26 + 15 + 47 * 9 + 5) characters = 469 characters without reference: (26 + 0 + 47 * 13 + 5) characters = 642 characters

10.2.4 Measurement resolution

Telegram Response

DRcc DRcc0.mmmE±ee

Reads the absolute resolution of channel cc. Notes:

1. This is the resolution of the active (displayed) measuring mode (mode 0 or 1)

2. Depending on the actual resolution, mmm consists of 3, 2 or 1 digit

3. The resolution is always given as an absolute value, even if measurement against reference is selected.

4. Channel numbers R• and M• are only valid, if measurement against reference is selected. Otherwise the

response will be E02.

Example: For the unit of measurement Gy/min the resolution of channel 17 in mode 1 (= dose rate) may be 50µGy/min, displayed as 0.05 mGy/min. Therefore, in mode 1 the response to DR17 will be DR170.05E-03

10.2.5 Measurement unit

Telegram Response

DUu

If the radiological unit is Roentgen, replace Gy by R in the upper lines.

D177.131.2/0 19

MULTIDOS

RS232 Interface

Application Afterloading

11 Application Afterloading

11.1 Basic Settings

Telegram Description Response

Ux Set/Read unit of measurement. Parameter x: A = Ampere, S = Gy/s, M =

Gy/min, H = Gy/h Rx Set/Read measuring range. Parameter x: L = range Low, H = range High SETs Set/Read the calibration set to be applied. Parameter s: 1 up to 5 SETAaa

Set/Read the status of the channels of the applied set. aa is a 2 digit decimal

number, whose set bits, when converted to binary representation, signal the

following status:

.0 Þ channel 1 of the rectum probe is active

.1 Þ channel 2 of the rectum probe is active

.2 Þ channel 3 of the rectum probe is active

.3 Þ channel 4 of the rectum probe is active

.4 Þ channel 5 of the rectum probe is active

.5 Þ channel of the bladder probe is active

.0 is the least significant bit

aa can take values from 00 to 63.

Rx SETs SETAaa

11.2 Control Telegrams

Telegram Description Response

NEW Reinitialize measurement NEW NULE

NULLr

NULOr Read the offset current measured during last zeroing in measuring range r

Read the channels (only active channels are considered) with erroneous results

during last zeroing. ee is a 2 digit decimal number, whose set bits, when con-

verted to binary representation, signal the following status:

.0 Þ channel 1 of the rectum probe was out of offset limits

...

.4 Þ channel 5 of the rectum probe was out of offset limits

.5 Þ channel of the bladder probe was out of offset limits

.0 is the least significant bit

ee can take values from 00 to 63.

Read the offset current limits for measuring range r

Limits (Ampere) in the data format ±m.mmmE±ee;

Data output: rectum probe channels 1 to 5, bladder channel

Example for measuring range Low:

NULLL•41.70E-12;•42.25E-12;•41.40E-12;•42.10E-12;•41.80E-12;•42.05E-12;

Results (Ampere) in the data format ±m.mmmE±ee

Data output: rectum probe channels 1 to 5, bladder channel

Results for deactivated channels are 0.0

Example for measuring range Low with deactivated channel 1:

NULOL••0.00E-12;••0.60E-12;••0.50E-12;•-0.10E-12;••0.70E-12;••0.55E-12;

NULee

NULLrLimit s

NULLOrResults

20 D177.131.2/0

MULTIDOS

RS232 Interface

Application Afterloading

11.3 Data telegrams

11.3.1 Read measured values

The response to a data telegram consists of various fields, separated by semicolons. The fields contain parameters and text. The response to the D telegram is: Dm;ttttt.ns;sss;FL;OO;LL;MM;R;Kbbbbb.

11.3.2 Description of parameters

ttttt.n

sss

R Number of the rectum channel with the highest measured value. R can take values from 1 to 5

±m.mmm

E±ee

bbbbb

Actual measuring mode. Valid values: 0 Þ Dose or Charge, 1 Þ Doserate or Current Elapsed measurement time. Consists of seven characters. Small numbers are right justified,

with leading spaces. Parameter n can have the values of 0 or 5. If the maximum measurement time of 64800 seconds is exceeded, OL••••• will be transmitted.

Measurement status. Valid values: RES, STA, HLD, INT, RUN, NUL, ERR. Global flags. A two digit number, whose set bits, when converted to binary representation,

signal the following error: .0 Þ any channel is overloaded at the moment .1 Þ math error in any channel .2 Þ MULTIDOS data acquisition error .4 Þ overload in any channel since the start of a dose or charge measurement .0 is the least significant bit

Overload flags of the current status of the doserate or current measurement. 2 digit decimal number whose set bits, when converted to binary representation, signal the following errors: .0 Þ channel 1 .5 Þ channel 6

.0 is the least significant bit OO can take values from 00 to 63.

Latched overload flags of the dose or charge measurement. 2 digit, whose set bits, when converted to binary representation, signal the following errors: .0 Þ channel 1 .5 Þ channel 6

.0 is the least significant bit LL can take values from 00 to 63.

Math error flags of the actual measurement mode. 2 digit, whose set bits, when converted to binary representation, signal the following errors: .0 Þ channel 1 .5 Þ channel 6

.0 is the least significant bit MM can take values from 00 to 63.

D177.131.2/0 21

MULTIDOS

RS232 Interface

Application Afterloading

11.3.3 Read maximum value

The response to the DMc telegram is DMc•m.mmE±ee where c is the channel number. The transmitted value is the maximum measurable value of the doserate or current measurement. The value is formatted in scientific notation.

11.3.4 Read Resolution

The response to the DRc telegram is DRc•0.mmmE±ee where c is the channel number. The transmitted value is the resolution of the actual measuring mode for the channel. The number of digits following the decimal point may vary from 1 to 3.

11.3.5 Measuring unit

Telegram Response

DUu

11.4 Calibration Factors

CRsAaa

CRsFcf Set/Read the calibration factor f of channel c of set s CRsNname Set/Read the name of set s CRsTdtyp

CRsDdd.mm.yyyy Set/Read the calibration date of set s CRsUx Update (x = 1)/Read (no x) the result of the check sum pro-

CRsBbbbbb

Description

Set/Read the status of the channels of set s. aa is a 2 digit decimal number, whose set bits, when converted to binary representation, signal the following status: .0 Þ channel 1 of the rectum probe is active .1 Þ channel 2 of the rectum probe is active .2 Þ channel 3 of the rectum probe is active .3 Þ channel 4 of the rectum probe is active .4 Þ channel 5 of the rectum probe is active .5 Þ channel of the bladder probe is active .0 is the least significant bit aa can take values from 00 to 63. from 00 to 63.

Set/Read the ID of detector d of set s. typ: string with max.15 characters (ASCII; 20H to 7FH) Space characters are allowed. Ä, Ö, Ü, ä, ö, ü, ß, µ are supported. d: R (rectum probe), B (bladder probe)

tection of set s Set/Read the block check value bbbbb of set s

Response

CRsAaa

CRsFccf CRsNname CRsTcctyp

CRsDdd.mm.yyyy CRsUx

CRsBbbbbb

22 D177.131.2/0

PTW MULTIDOS User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

For your Safety

General

General Telegrams

Brief Description

Application Dual Channel Dosemeter

Application Multi Channel Dosemeter

Application Constancy Check

Application Linear Array LA 48

Application Afterloading