UNIDOS webline Interfaces Contents Contents Contents Safety Information Interface Configuration RS232 Interface Ethernet Interface and UDP Interface Commands Principles of Computer Communication Command Structure A Sample Session Command Categories Commands by Functions Notes on Command Overview General Commands Status Request and Diagnosis Measurement and Control Commands Data Base Commands for Detectors Data Base Commands for User Settings...
In addition to these safety statements, please note that devices connected to the interface de- scribed in this manual must fulfill the require- ments of the standard IEC 60950-1. PTW-FREIBURG Physikalisch Technische Werkstätten Dr. Pychlau GmbH Lörracher Str. 7 79115 FREIBURG...
2 Interface Configuration webline For connections from UNIDOS to the PC with 2.1 RS232 Interface a standard 9 pin connector, use PTW cable webline The serial interface of the UNIDOS is a RS232 L178012 (2 m), L178026 (5 m) or T22373/K67-30 interface with the following configuration: (30 m).
Ethernet interface, UDP protocols for send- • Install a UDP driver on your PC. For information ing commands via the Ethernet interface. For fur- on the UDP driver recommended by PTW- ther information about configuring the Ethernet in- Freiburg, refer to the PTW-Freiburg homepage. webline...
NOTE Commands are answered with error messages while the SETUP menu is displayed or while a setting is changed via the quickinfo window! Exception: PTW and SER command NOTE To avoid confusion due to user operation at the webline UNIDOS...
Read/Set date Start the communication program on your PC. Read/Set time Make sure that it is set up correctly. Send a PTW command. The response must be 3.4.2 Status Request and Diagnosis UNIDOS2;x.xx where x.xx is the firmware ver- sion. Repeat this for a maximum of 3 times. If there...
CRC check sum. The polynomial used for calculation is: The CRC check sum is transmitted in form of a 5-digit ASCII string. (On request PTW-Freiburg will provide details of the CRC calculation method.) D776.131.01/02...
UNIDOS Interfaces Commands by Functions 4.2 General Commands Function Read device ID and firmware version Command Answer PTW;UNIDOS2;x.xx;y Parameters device ID UNIDOS2 firmware version x.xx optional build number Timeout ≤ 0,5 s Function Read device serial number Command Answer SER;xxxxxx...
Page 10
webline UNIDOS Interfaces Commands by Functions Function Read handshake setting Command Function Set handshake setting Command HS;x Answer HS;x Parameter 0 : handshake switched off 1 : handshake switched on Timeout ≤ 0,5 s Remarks The answer will be sent with the old setting. Then the setting will be changed. Function Read date Command...
webline UNIDOS Interfaces Commands by Functions 4.3 Status Request and Diagnosis Function Read measurement status Command Answer S;xxx Parameter RES : Reset STA : dose/charge measurement in progress HLD : dose/charge or integration measurement in Hold status INT : integration measurement in progress NUL : zeroing in progress ERR : error status AUT : autostart mode...
Page 12
webline UNIDOS Interfaces Commands by Functions Function Recalculate the measured value multiplicators Command Answer Possible E;03 error messages Timeout Post delay 5 s Remarks This command initializes a recalculation of all parameters for measuring value determina- tion (e.g. resolution). It sets the Trip Output interface contacts to their power-on position. It is mainly intended to cancel error states.
webline UNIDOS Interfaces Commands by Functions 4.4 Measurement and Control Commands Function Start zeroing Command Answer Possible E;02, E;03, E;11 error messages Timeout Remarks Equivalent to pressing the ZERO device control key The answer is sent immediately. Read the end of zeroing and the result of zeroing by means of a NUS command.
Page 14
webline UNIDOS Interfaces Commands by Functions Function Read measuring mode (radiological or electrical) Command Function Set radiological or electrical measuring mode Command URE;x Answer URE;x Parameters 0 : electrical 1 : radiological Possible E;03 error messages Timeout Function Read high voltage Command Function Set high voltage...
Page 15
webline UNIDOS Interfaces Commands by Functions Function Start an integration measurement Command Answer Possible E;02, E;03 error messages Timeout Remarks Equivalent to pressing the INTEG device control key Function Set the measurement to Hold-mode Command Answer Possible E;02, E;03 error messages Timeout Remarks Equivalent to pressing the HOLD device control key...
Page 16
webline UNIDOS Interfaces Commands by Functions Function Read measured values Command Answer MV;a;bb;cc.c;±d.dddE±ee;f;g;±h.hhhE±ii;k;±llllE±mm;nnnnn Parameters measuring status: 0 : reset 1 : dose or charge measurement in progress 2 : dose or charge measurement in Hold mode 3 : integration measurement in progress 4 : integration measurement in Hold mode (integration time elapsed) 5 : zeroing in progress 6 : error status...
Page 17
webline UNIDOS Interfaces Commands by Functions Function Read upper limit of measuring range Command MVM or MVM;a Answer MVM;a;b.bbbE±cc Parameters 0 : Low 1 : Medium 2 : High If the measuring range is not prompted in command, upper limit of the adjusted measuring range in transferred in answer.
webline UNIDOS Interfaces Commands by Functions 4.5 Data Base Commands for Detectors NOTE All parameters of a detector are condensed in a list. To access a parameter a number is used. List of parameters see section 4.5.1. NOTE Changing parameters can either be done in the data record of the active detector or in a so- called data record work space.
Page 19
webline UNIDOS Interfaces Commands by Functions Function Read the value of a parameter of the active detector Command DAV;p Function Set the value of a parameter of the active detector Command DAV;p;y Answer DAV;p;y;zzzzz Parameter index of the parameter, refer to list in section 4.5.1 value of the parameter CRC check sum (refer to section 4.1.1) zzzzz...
Page 20
webline UNIDOS Interfaces Commands by Functions 4.5.1 List of Parameters for the Detector Data records Index Name of the Description of the Type of the Possible values parameter parameter parameter Record No number of data record integer value 0 … 51 read only Identifier identifier of the detector,...
Page 21
webline UNIDOS Interfaces Commands by Functions Index Name of the Description of the Type of the Possible values parameter parameter parameter CalLaboratory calibration laboratory text 20 characters max. Identifier identifier of the check de- text 20 characters max. vice Isotope Isotope selection 0 : no check device...
Page 22
webline UNIDOS Interfaces Commands by Functions Index Name of the Description of the Type of the Possible values parameter parameter parameter correction factor for radia- decimal value 0.1 … 10.0 tion quality k kPol correction factor for polarity decimal value 0.1 … 10.0 effect k correction factor for ion decimal value 0.1 …...
Only the parameters with the indices listed below may be changed. The parameters with the indices 7, 8, 30 - 32, 36, 43, 44, 50-53 and 55 are reserved for PTW. Changing any of these parameters may cause system malfunction and erroneous measure- ments.
Page 24
webline UNIDOS Interfaces Commands by Functions 4.6.1 List of Parameters of the User Settings Index Name of the Description of the Type of the Possible values parameter parameter parameter User user selection 0 : normal user 1 : expert read only 2 : administrator Detector ID Record number of selected...
Page 25
webline UNIDOS Interfaces Commands by Functions Index Name of the Description of the Type of the Possible values parameter parameter parameter Gateway IP address for the standard IP address format xxx.xxx.xxx.xxx gateway e.g.: 192.168.2.1 POP3 server IP address of POP3 server IP address format xxx.xxx.xxx.xxx SMTP server IP address of SMTP server IP address...
Page 26
webline UNIDOS Interfaces Commands by Functions Index Name of the Description of the Type of the Possible values parameter parameter parameter Brightness brightness for battery op- integer value 1 … 50 … 100 (battery operation) eration Brightness brightness for mains opera- integer value 1 …...
webline UNIDOS Interfaces Commands by Functions 4.7 Statistics Commands Function Read a statistics parameter Command SPA;x Function Set a statistics parameter Command SPA;x;y Answer SPA;x;y Parameter 0 : mode 1 : measuring time for time-controlled statistics 2 : time for measuring pause for time-controlled statistics 3 : number of statistics entries for signal- and time-controlled statistics x = 0 mode...
Page 28
webline UNIDOS Interfaces Commands by Functions Function Read the status of the statistics measurement Command Function Operate the statistics measurement Command SMC;x Answer SMC;x Parameter read: statistics measurement disabled operate: terminate series of measurements read: series of measurements in progress operate: start series of measurements Possible E;03, E;08...
Page 29
webline UNIDOS Interfaces Commands by Functions Function Read an entry of the statistics list Command SDR;a Answer SDR;0;b;-c.cccE+dd;e;-fff.ff% SDR;a;-g.gggE+hh;e;iiii;yyyy-mm-dd;hh:mm:ss;jjj;k;ll Parameter 0 : read the summing up data a : number of the entry (1 to number of entries) number of entries mean value of measured values -c.cccE+dd unit...
Page 30
webline UNIDOS Interfaces Commands by Functions Function Read the whole contents of the statistics list Command Answer SDR;x;y Parameter 0 : summing up data a : number of the entry (1 to number of entries) Refer to SDR;x command Timeout Remarks Several rows (each ending with CR LF) will be sent.
webline UNIDOS Interfaces Alphabetical Command List 5 Alphabetical Command List Com- Description Page Com- Description Page mand mand Read/Set baud rate Start zeroing Read/Set the value of a parameter Read zeroing status of the active detector Read device identification and Select a detector data record as firmware version active detector...
webline UNIDOS Interfaces Error Messages 6 Error Messages Error Cause Remarks Tele- gram Syntax error, unknown command or invalid Observe the tables indicated in section 4 E;01 parameter Command not allowed in this context e.g. starting a measurement while zeroing is in progress E;02 webline Command not allowed at the moment...
Need help?
Do you have a question about the UNIDOS webline and is the answer not in the manual?
Questions and answers
how to make PTW UNIDOS webline (serial number : 002746) take measures because when using the device it does not show any response