operating manual steropes halogen light source

Transcription

1 operating manual steropes halogen light source

2 Contents 1 Introduction Steropes Halogen Steropes Halogen highlights Standards Interfaces USB interface RS232 interface Trigger in Power connections Communications protocol USB RS Device drivers USB RS Command set description Commands Commands structure System commands Configuration commands User EEPROM commands Operating modes & triggering

3 1 Introduction 1.1 Steropes Halogen Obtaining good measurement results requires good and stable lighting. With this in mind Admesy developed the Steropes Halogen light source, which is a stable, accurate light source controlled by a current stabilisation circuit. With the Steropes halogen the user is certain to have a light output at +/- 0,1% / 0 C accuracy. Combined with our colorimeters or spectrometers the stabilized light of the Steropes offers the best measurement results. The Steropes Halogen is currently with Admesy s M8 fixed position fibre connector for connecting with reflective probes, fibresss and other accessories and as calibration version. 1.2 Steropes Halogen highlights Ultra-stable light source with internal current regulation USB and RS232 communication interfaces controlled light output USBTMC standard device, works with NI-VISA or other USBTMC compliant drivers Stand-alone mode Mechanical shutter Optional blue enhanced light output Standard, long life or high power mode Standard in 20W 1.3 Standards The Steropes Halogen is compliant to the USBTMC standard and can be used in combination with external provided USBTMC compliant drivers. Currently it has been tested on Windows, Linux and Apple OSX using NI VISA ( and using the open source drivers on Linux (i686, x86_64 and ARM). Refer to the Admesy support site for a more detailed description and free source code or contact us. 3

4 2 Interfaces 2.1 USB interface The USB-B connector is used to connect the Steropes Halogen to a PC/Laptop. The Steropes Halogen uses the USBTMC class protocol and can therefore be used directly with third party provided VISA compliant libraries like NI-VISA. The Steropes Halogen cannot be used as a self USB powered device. So USB connection is only for communications only. 2.2 RS232 interface RS232 is provided to connect the Steropes Halogen light source to any host that doesn't provide USB or for which no USBTMC drivers exist. Using RS232 the high speed options of the light source are still, only transfer of data to the host is reduced in speed. It is recommended to use USB in case the high update rates are needed. Baud rate Data bits Parity Stop bits Flow control Termination character LF= \n Table 1 RS 232 port configuration. Fig 1 Steropes Halogen RS232 connection. Fig 2 Rear side mini-din-6 pin connector. Fig 1 Steropes Halogen connections. 4

5 2.3 Trigger in The Steropes Halogen light source can be triggered when it is operating in USB, RS232 or stand-alone mode. In all configuration modes the trigger in functionality is the same. The Steropes Halogen light source is equipped with two trigger inputs, the functionality of each input is described below: In-1: Open or Close the shutter. 1 = Shutter Opened, 0 = Shutter Closed. In-2: Turn light source On or Off. 1 = light source On, 0 = light source Off. Trigger signals are level triggered and should comply with the following diagram. ton / toff > 100ms t-on / toff > 8000ms Fig 3 Trigger-in timing shutter. Trigger-in timing light source Trigger pulses arriving faster than the Steropes Halogen can process will be ignored, but it may slowdown overall performance. Therefore trigger pulses should not arrive faster than the process takes to complete. Manufacturer Part number Description Type Tyco electronics Straight Solder cable plug Tyco electronics Right angle Solder cable plug Tyco electronics Straight Clamp cable plug Tyco electronics Right angle cable plug Clamp Table 4 Trigger connector manufacturer information. 5

6 2.4 Power connections The Steropes Halogen light source should be connected to a 24V DC power supply (centre +). Admesy can only guarantee stable measurement results and CE compliance when using the supplied adapter. The unit shall be powered by a 24Vdc voltage, reinforced separated from Mains, with a limited energy of < 150VA and < 8A. Connection Min. Voltage Typ. voltage Max. voltage Power consumption USB power * 4.75V 5.00V 5.25V 1mA 24V power 20V 24V 28V 1500mA Table 5 Power supply levels. Note 1: No power through USB, only communication Fig 4 Power connection. 6

7 3 Communications protocol 3.1 USB The Steropes Halogen light source can be connected to any USB host. The light source is a USBTMC compliant device which is a standard USB class device and device drivers for this class are for most popular operating systems (also embedded). This makes the Steropes Halogen light source directly usable in popular programming languages like NI's Labview and Labwindows but also in C++, Visual basic, C#, Java etc. The Steropes Halogen light source has two interfaces build in, which require a different device driver to be used. 3.2 RS232 Steropes Halogen light source commands are equal for all interfaces. Admesy Bootloader (USB RAW device driver, Vendor ID: 0x23CF, Product ID 0x0E92) Steropes Halogen light source (USBTMC device driver, Vendor ID: 0x23CF, Product ID 0x0F01) When the Steropes Halogen light source is connected to the host, it will start the Steropes Halogen light source. As soon as the firmware is idle to receive commands, the Power LED goes to the on state. The Admesy bootloader is a RAW USB device and in order to use this device in Windows, a driver must be installed which is supplied by Admesy. Besides upgrading to new firmware, it is also allowed to downgrade firmware in case this is required. Note that older firmware also may require the use of older software libraries and/or executable versions of software. The Steropes Halogen light source is USBTMC compliant and can be used with libraries that contain a USBTMC compliant driver like NI-VISA. The Steropes Halogen light source is a USB 2.0 full speed device. In case a USB host is detected, it is assumed that the Steropes Halogen light source operates only via USB. Triggering via USB is allowed, but needs to be enabled via software. 7

8 4 Device drivers 4.1 USB The following table shows an overview of USB support on various operating systems. OS NI-VISA Libusb Native kernel Windows XP 2 Not Windows Not VISTA Windows 7 Not Windows 8(.1) Not tested¹ Not Windows 10 Not tested¹ Not Windows CE Not tested¹ Not Apple OSX Not tested¹ Not PPC Apple OSX Not tested¹ Not Intel Linux i386 Agilent USBTMC Not tested¹ Not tested¹ Not tested¹ Not tested¹ Not tested¹ Not tested¹ Unknown Unknown (32bit) Linux i386 (64bit) Linux ARM Not Linux other Not Table 3 Supported operating systems. Admesy supports all tested platforms but does not provide standard applications on all platforms. The above matrix is provided to show the possible platforms for software development. 4.2 RS232 When no USB driver is or the host system does not provide USB, RS232 can be used as it does not require additional drivers for the Steropes Halogen light source. 1 Not tested: Available, but not tested by Admesy, 2 Native Kernel: Driver included with OS. 2 Windows XP SP3 is supported: Windows official support has ended as of April

9 5 Command set description 5.1 Commands The functions of the light source can be described via the following categories: System commands Configuration commands Measurement commands Trigger programming commands The Steropes Halogen light source uses SCPI like commands for control and measurement. These are ASCII based commands and follow specific rules regarding syntax. Although the Steropes Halogen light source uses SCPI like commands, they deviate from the SCPI standard. 5.2 Commands structure Every command starts with a semicolon :, which identifies the root of the command tree. Each further keyword is also separated a semicolon. In case parameters need to be specified, the last keyword and parameters are separated by a single space character. In case more than one parameter needs to be specified, the parameters need to be separated by a comma. The command tables show commands in long and short format. The short format is specified by upper case characters. It is allowed to use long and short format or a mixed form. Optional keywords are shown between brackets [...]. Commands are case insensitive, so it is allowed to use both or a mix of upper and lower case. Command table :MEASure:TEMPerature Table 7 Example commands. Valid command syntax examples :measure:temperature :measure:temperature :meas:temp :MEAS:TEMP 9

10 5.3 System commands The following command can be used to control the Steropes Halogen light source system or read information about the system. Command syntax Parameters Purpose :*CLS Clear status :*IDN? Identification Query :*RST Reset Command :*STB? Read Status Byte Query :*TST Self-Test Query :*FWD? Firmware date Query :*FWT? Firmware time Query :SYSTem:VERSion? Get system version information :SYSTem:ERRor? Retrieve the last occurred error :SYSTem:ERRor:NEXT? Retrieve previous errors. Table 8 System commands. Note, the Status byte can be used to retrieve information about the status of a command or the system. Code Description 0 System is idle 1 Data is 2 Command processed 4 Data in buffer (should not occur) 8 An error occurred. Use :SYSTem:ERRor? to get the exact error that occurred. Table 9 Return values of the status command. 5.4 Configuration commands Configuration commands are used to set parameters of the Steropes halogen light source that are used by the controlling functions. Command syntax parameters Range Purpose Enum MODE (0,1,2) MODE? BAUDRATE BAUDRATE? TRIG TRIG? SWITCH SWITCH? SHUTTER SHUTTER? LIGHTsource LIGHTsource? :MEASure: TEMPerature USB, RS232, STANDALONE Baud rate 0 5 ( ) Trigger, Mode Use Switch, Use Switch, Enum (0,1,2) = No 1 = Yes 0 = No 1 = Yes Normal, Long life, High Power Configure the Steropes operating mode. Retrieves the current operating mode Set RS232 baud rate Returns the current setting. Enable trigger mode Rising edge or Level Returns the current setting. Set if the Lamp switch is being used Retrieves if the Lamp Switch is being used Sets if the Shutter switch is being used Retrieves if the Shutter Switch is being used Set the light intensity. Retrieves the light intensity setting Measure temp of PCB & CPU 10

11 5.5 User EEPROM commands The following commands can be used to store values in the user EEPROM space. Note that they are not stored until a :EEPROM:WRITE command is given. It is advised to reboot the Steropes after writing new values to the EEPROM. Command syntax parameters Range Purpose :SENSe:SHUTter State 0,1 Set shutter open/close 0 = open, 1 = close :SENSe:SHUTter? Retrieves the shutter state :SENSE:LED State 0,1 Set the lamp 1=On or 0=Off :SENSE:LED? Retrieves the current state of the lamp :SET: LIGHTsource? Enum (0,1,2) Normal, Long life, High Power Temporarily set the light intensity. :READ:SWITCH Retrieves in what state the switch is :SET:LUMinance State 0 1 Set light On/Off at startup :READ: LUMinance Retrieves the light luminance settings Table 10 Sense and configuration commands Command syntax Parameters Range Purpose :EEPROM:STARTUP: Copies startup READ conditions from EEprom :EEPROM:STARTUP: WRITE Steropes mode to internal variables 0 2 Copies internal variables to EEprom and set sets Steropes mode :EEPROM:WRITE Write all settings to EEprom. This command fixes the EEprom values :EEPROM:READ:SN Reads the serial number :EEPROM: Read device ID READ:ID :EEPROM: WRITE:ID ID Writes the device ID Table 1: User EEPROM commands 11

12 6 Operating modes & triggering Operation is possible as slave device for a host PC or as stand-alone device. In slave mode the Steropes Halogen light source listens to commands send by the host PC as mentioned in the previous paragraphs. The modes of the Steropes Halogen light source are: USB mode RS232 mode Stand-alone mode In all modes, USB is still active but when only USB is used, it is recommended to set it to USB mode so that the Steropes Halogen light source responds in the fastest possible way to commands. The operating mode must be selected via the Steropes Halogen light source application, or through the Admesy Iliad application and select DeviceStart-up settingssteropes Halogen. All target values can be measured using the configuration utility or input manually. Once the USB cable is connected, the Steropes Halogen light source will automatically leave the stand alone mode and listen to USB communication. 12

13 Admesy B.V. Sleestraat CA Ittervoort The Netherlands T +31 (0) F +31 (0) The material in this document is subject to change. No rights can be derived from the content of this document. All rights reserved. No part of this document may be reproduced, stored in a database or retrieval system, or published in any form or way, electronically, mechanically, by print, photo print, microfilm or any other means without prior written permission from the publisher. info@admesy.com Version ss/