CEBO-STICK (Revision 1.0) Reference Manual Cesys GmbH Zeppelinstraße 6a 91074 Herzogenaurach November, 2013 CEBO-STICK Reference Manual [ v1.
Copyright information Copyright © 2013 CESYS GmbH. All Rights Reserved. The information in this document is proprietary to CESYS GmbH. No part of this document may be reproduced in any form or by any means or used to make derivative work (such as translation, transformation or adaptation) without written permission from CESYS GmbH.
Overview The pocket-sized CEBO-STICK is ideally suited for mobile applications. Four calibrated 12bit analog inputs (input range: 0 - 3,3V), two general purpose digital inputs/outputs, one multi-function digital input/output and one 5V power supply output are all available at a well-known 9pin D-Sub connector of female type. The multi-function digital I/O either serves as general purpose I/O, 32bit counter input or trigger input/output.
Features Analog inputs • • • • • Four single-ended 12bit resolution Analog input range: 0 - 3,3V Operational amplifier inputs Up to 188.
Hardware description DB9 connector All CEBO-STICK input / output signals are available on a standard 9pin D-SUB jack of female type: • • • • • Four single-ended analog inputs Two general purpose digital IO signals One multi-function IO: configurable as digital IO, trigger IO or counter input 5 Volt power output GND signal Figure 1: DB9 connector - pin assignment Pin Signal 1 5V 2 IO-2 Digital input / output 2 3 IO-1 Digital input / output 1 4 IO-0 Multifunction IO: Default: Digital input / ou
USB interface CEBO-STICK connects to host devices through a USB2.0 full-speed compatible interface. As a bus-powered device CEBO-STICK uses USB2.0 not only for the purpose of communication with a host system but also as power supply, so no external power supply is necessary. CEBO-STICK USB features • • • USB 1.1 and USB2.0 compatible Full speed (12Mbit) Standard USB-A connector CEBO-STICK Reference Manual [ v1.
Analog inputs • • • • • • Four single-ended analog inputs 12bit resolution Analog input measurement range: 0 - 3,3V Maximum allowed input voltage: 5V Operational amplifier inputs Up to 188 kSamples/s (total sampling rate) Floating inputs To keep input resistance at a maximum, all analog inputs are left floating. The analog inputs are not pulled to GND internally. Readings from floating inputs have undefined results.
Analog inputs Min.3 Parameter Typical input range Maximum input voltage range 4 Max.3 Unit 0,0 3,3 Volts -0,2 5,0 Volts 500,0 nAmperes Typ.
Digital IO • • • • • • Two general purpose IO Individually configurable as input or output One multi-function IO: configurable as digital IO, trigger IO or counter input 3,3 Volt TTL compliant signaling levels 5 Volt tolerant inputs Short-circuit proof Figure 3: Digital IO pin assignment Pin Signal Description 4 IO-0 Multifunction IO: Default: Digital input / output 0 Alternate: Trigger input / output or counter input 3 IO-1 Digital input / output 1 2 IO-2 Digital input / output 2 5 GND GND
Trigger After startup of CEBO-STICK, the multifunction IO-0 is configured as digital input signal. To use the trigger functionalities, output or input, the corresponding peripheral needs to be enabled first. This is done by software calls (API). While IO-0 is used as trigger input / output, digital IO functionalities or counter input are not available. With the help of the trigger output signal you can, for example, synchronize multiple CEBO-STICK devices.
Alternating mode In alternating mode, both edges on terminal IO-0 are considered as trigger events. Trigger input Min.3 Parameter Typ. Max.3 Unit Low level input voltage 0,0 0,8 Volts High level input voltage 2,0 5,0 Volts -1,0 6,5 Volts Maximum input voltage range 4,5 Input total edge rate tbd Edges/s 6,7 tbd us 6,8 tbd us Latency Latency Trigger output In trigger output mode, terminal IO-0 becomes an actively driven digital output.
Counter After startup of CEBO-STICK, the multifunction IO-0 is configured as digital input signal. To use the counter functionalities, the corresponding peripheral needs to be enabled first. This is done by software calls (API). While IO-0 is used as counter input, digital IO functionalities or trigger input / output are not available. Counter input In counter input mode, each counter event on IO-0 causes the firmware to jump to a small interrupt routine and increment an internal 32bit register.
5 Volt power supply output CEBO-STICK features a 5V power output on terminal one of the DB9 connector. This voltage output is sourced by USB power. The absolute maximum current is 100mA. Important: Keep current below 5mA for accurate measurements on analog inputs. The 5 Volt power output can be used to source external switches connected to the digital inputs or to provide constant current for PT1000 sensors. It should not be used to draw extensive power when accurate measurements are required.
Data acquisition The process of measuring data is called "Data acquisition". It is abbreviated DAQ. There are several ways to collect data with the CEBO-STICK. We call them "DAQ modes". This section gives you guidance on how to acquire analog and digital data with CEBOSTICK. DAQ modes Some measurement problems require more effort than reading one single input. Depending on the circumstances, a fixed number of measurements with well defined timing or an endless stream of measurements is desired.
Software timed - one single frame Capture and return one frame, which may consist of several input or output signals. Exact frame timing is not predictable, as it strongly depends on host system processing of requests targeting the USB interface. Therefore frame to frame timing might vary. With a typical system minimum time frames are between one and four microseconds, hence the maximum sample rate will be about 250 up to 1.000 frames per second.
Digital port The three digital IO signals of CEBO-STICK are grouped as one digital port. Therefore you not only can read/modify the value of one signal line at a time, but also can read/modify the whole port at once. You can individually define the direction of every digital IO. As default, all digital IO are set to input mode, with a small pull-down resistor enabled on each line. Frames With CEBO-STICK various sources and sinks of data are available.
Single value IO Single value IO is the most basic form to sample an input or modify an output. The call is synchronous, so invoking a method processes the request always immediately, which means: • • In case of sampling: The result of the called method is the sampled value, the method call lasts as long as sampling and data transmission from device to host is active. In case of modify: The method call sends the value to the peripheral directly and returns.
Read single InputFrame Use single frame reading if you want to read more than one input at once. Specify a list of all inputs to read and call the method setupInputFrame of the device in use. Note, that list type varies between different programming languages. Please refer to the specific language documentation for more detail. All subsequent calls to readFrame() will sample the specified inputs and return an instance of type InputFrame, which contains the sampled values.
Multi frame data acquisition While single frame accesses are a convenient way to read multiple input signals all at once, maximum achievable sample rate is limited due to timing limits of USB. With a typical host system minimum time frames are between 1ms and 4ms, hence the maximum sample rate will be about 250 up to 1.000 frames per second. Besides, latency of most host systems cannot be guaranteed and therefore frame to frame timing might vary.
onboard memory for a given frame setup. With only one analog input enabled, you can sample up to 4.095 frames. See the table at the end of this section for further details. Frame setup Maximum number of frames for buffered modes 1x analog input 4.095 4x analog input 1.023 Digital port 4.095 4x analog input + digital port + counter 585 Maximum sample rate - continuous DAQ Frame setup Typ. 1 analog input Max.3,16 Unit 100.000 Frames/s 2 analog inputs 50.000 76.
Calibration data CEBO-STICK devices are tested and calibrated before delivery. All corrections to measurement data based upon the calibration data are done automatically within API. Firmware and software update For latest information on firmware and software releases, please visit the download section at www.cesys.com. There you will find release notes, drivers and newest software and firmware available for CEBO compatible devices.
Specifications General Parameter Min. Dimensions (L x Wx H) Typ. Max. Unit 85 x 21 x 12,4 mm Cable Length 75 mm Weigth 65 g Operating temperature range 0 25 70 C Analog inputs Min.3 Parameter Typ. Max.
Output Min.3 Parameter Low level input voltage High level input voltage Maximum input voltage range 4,,5 Max.3 Unit 0,0 0,8 Volts 2,0 5,0 Volts 6,5 Volts 0,8 Volts Typ. -1,0 Low level output voltage 0,0 High level output voltage 2,0 3,3 Volts Sinking 1mA 0,2 Volts Sourcing 1mA 3,1 Volts Short-circuit current 18 mAmperes 180 Ohms Output impedance Trigger input/output Input Min.
5 Volt power output Parameter Typical output voltage 12,13 Voltage drop due to cable impedance Min. Typ. Max. Unit 4,75 5,0 5,25 Volts 14 0,150 Volts Command and response times Single value Analog input Digital input Min.3,16 Typ.3,16 Max.3,16 Unit 0,80 0,93 6,00 ms 0,70 0,86 4,00 ms 0,32 0,38 2,00 ms 17 17 Digital output 18 Single frame Analog inputs only Digital inputs only 17,19 17,20 Analog and digital inputs 21 Min.3,16 Typ.3,16 Max.
Ordering information Order Number Device Comment C028210 CEBO-STICK 4-channel 12-bit ADC Stick with USB interface. CEBO-STICK Reference Manual [ v1.
Revision history v1.0 Initial online release. v1.1 Provided as offline document. Minor updates and corrections. CEBO-STICK Reference Manual [ v1.
Table of contents Copyright information.............................................................................2 Overview...............................................................................................3 Applications............................................................................................................................3 Features................................................................................................4 Analog inputs...............................
Firmware and software update......................................................................................21 Specifications.......................................................................................22 General.....................................................................................................................22 Analog inputs.............................................................................................................22 Digital inputs/outputs................