Difference between revisions of "Lascar Electronics EL-USB-2"

From sigrok
Jump to navigation Jump to search
(quote example sigrok-cli use (by confuc via IRC))
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[File:EL-USB-2.png|thumb|right|EL-USB-2]]
[[File:EL-USB-2.png|thumb|right|Lascar Electronics EL-USB-2]]


The [http://www.lascarelectronics.com/ Lascar Electronics] [http://www.lascarelectronics.com/temperaturedatalogger.php?datalogger=102 EL-USB-2] is a USB-based temperature and humidity logger.
The [http://www.lascarelectronics.com/temperaturedatalogger.php?datalogger=102 Lascar Electronics EL-USB-2] is a USB-based temperature and humidity logger.


See [[Lascar Electronics EL-USB-2/Info]] for more details (such as '''lsusb -vvv''' output) about the device.
See [[Lascar Electronics EL-USB-2/Info]] for more details (such as '''lsusb -vvv''' output) about the device.
The sigrok driver for this device also supports the EL-USB-2+, EL-USB-LCD, and EL-USB-LCD+. Note that only downloading logged data is supported by sigrok; configuring the device is not currently supported.


== Hardware ==
== Hardware ==
Line 12: Line 14:


== Photos ==
== Photos ==
<gallery>
<gallery>
File:EL-USB-2 side.jpg
File:EL-USB-2.png|<small>Device, top</small>
File:EL-USB-2 uncapped.jpg
File:EL-USB-2 side.jpg|<small>Device, side</small>
File:EL-USB-2 battery.jpg
File:EL-USB-2 uncapped.jpg|<small>Device, uncapped</small>
File:EL-USB-2 sensor.jpg
File:EL-USB-2 battery.jpg|<small>Device, battery</small>
File:EL-USB-2 PCB top.jpg
File:EL-USB-2 sensor.jpg|<small>Sensirion SHT11</small>
File:EL-USB-2 PCB bottom.jpg
File:EL-USB-2 PCB top.jpg|<small>PCB, top</small>
File:EL-USB-2 F321.jpg
File:EL-USB-2 PCB bottom.jpg|<small>PCB, bottom</small>
File:EL-USB-2 24LC256.jpg
File:EL-USB-2 F321.jpg|<small>SiLabs C8051F321</small>
File:EL-USB-2 24LC256.jpg|<small>Microchip 24LC256</small>
</gallery>
</gallery>


== Protocol ==
== Protocol ==


=== Commands ===
See [[Lascar Electronics EL-USB protocol]].
 
{| border="0" width="95%" style="font-size: smaller;" class="alternategrey sigroktable"
|-
! style="width: 10em;" | Bytes
!Command
 
|-
| valign="top" style="white-space=nowrap;" | '''0x00 0xff 0xff'''
| Load device configuration structure.
 
A 3-byte header is returned first in which the first byte is 0x02, and the second and third bytes are the length of the configuration structure to follow, as a little-endian integer representing the number of bytes. Different devices in the EL-USB series have differently-sized configuration structures.
 
|-
| valign="top" style="white-space=nowrap;" | '''0x01''' ''0xnn 0xnn''
| Save device configuration structure.
 
The second and third bytes are the length of the configuration structure to follow, as a little-endian integer representing the number of bytes.
 
The device responds with a single byte with value 0xff when the configuration has been saved.
 
|-
| valign="top" style="white-space=nowrap;" | '''0x03 0xff 0xff'''
| Transfer logged data.
 
A 3-byte header is returned first in which the first byte is 0x02, and the second and third bytes are the length of the logged data to follow, as a little-endian integer representing the number of bytes. The logged data then follows.
 
|}
 
=== Device configuration structure ===
 
{| border="0" width="95%" style="font-size: smaller" class="alternategrey sigroktable"
|-
! style="width: 3em;" | Offset
! style="width: 3em;" | Size
! Value
 
|-
| valign="top" | 0x00
| valign="top" | 1
| '''Device type'''
{| border="0" width="100%" style="margin: 0;" class="alternategrey"
|-
| style="width: 3em;" | 1,2
| EL-USB-1
|-
| 3
| EL-USB-2
|-
| 4,6
| EL-USB-3
|-
| 5,7
| EL-USB-4
|-
| 8
| EL-USB-LITE
|-
| 9
| EL-USB-CO
|-
| 10
| EL-USB-TC
|-
| 11
| EL-USB-CO300
|-
| 12
| EL-USB-2-LCD
|-
| 13
| EL-USB-2+
|-
| 14
| EL-USB-1-PRO
|-
| 15
| EL-USB-TC-LCD
|-
| 16
| EL-USB-2-LCD+
|-
| 17
| EL-USB-5
|-
| 18
| EL-USB-1-RCG
|-
| 19
| EL-USB-1-LCD
|-
| 20
| EL-OEM-3
|-
| 21
| EL-USB-1-LCD
|}
 
|-
| 0x01
| 1
| Unused
 
|-
| 0x02
| 16
| NULL-terminated device name, 15 chars max
 
|-
| 0x12
| 1
| Start time, hour (0-23)
 
|-
| 0x13
| 1
| Start time, minute (0-59)
 
|-
| 0x14
| 1
| Start time, second (0-59)
 
|-
| 0x15
| 1
| Start date, day (1-31)
 
|-
| 0x16
| 1
| Start date, month (1-12)
 
|-
| 0x17
| 1
| Start date, year (year - 2000)
 
|-
| 0x18
| 4
| Unsigned little-endian, seconds remaining until logging starts
 
|-
| 0x1c
| 2
| Unsigned little-endian, samplerate (seconds between samples)
 
|-
| 0x1e
| 2
| Unsigned little-endian, number of stored samples
 
|-
| valign="top" | 0x20
| valign="top" | 1
| style="padding: 0;" |
{| border="0" width="100%" style="margin: 0;" class="alternategrey"
|-
! align="left" style="width: 3em;" | Bit
! align="left" | Alarm conditions bitfield (1=enable)
|-
| 0
| temperature high
|-
| 1
| temperature low
|-
| 2
| temperature high hold
|-
| 3
| temperature low hold
|-
| 4
| relative humidity high
|-
| 5
| relative humidity low
|-
| 6
| relative humidity high hold
|-
| 7
| relative humidity low hold
|}
 
|-
| valign="top" | 0x21
| valign="top" | 1
| style="padding: 0;" |
{| border="0" width="100%" style="margin: 0;" class="alternategrey"
|-
! align="left" style="width: 3em;" | Bit
! align="left" | bitfield
|-
| 0
|
|-
| 1
|
|-
| 2
|
|-
| 3
|
|-
| 4
|
|-
| 5
|
|-
| 6
|
|-
| 7
|
|}
 
|-
| 0x22
| 1
| Temperature alarm high (value + 40) * 2
 
|-
| 0x23
| 1
| Temperature alarm low (value + 40) * 2
 
|-
| 0x24
| 4
| unknown (00 00 00 3f, 00 00 80 3f)
 
|-
| 0x28
| 4
| unknown (00 00 20 c2)
 
|-
| 0x2c
| 2
| unknown (00 00)
 
|-
| 0x2e
| 2
| Device-specific configuration
 
|-
| 0x30
| 4
| Firmware version (ASCII, not NULL-terminated
 
|-
| 0x34
| 2
| Unsigned little-endian, serial number
 
|-
| 0x36
| 2
| unknown (00 00)
 
|-
| 0x38
| 1
| Relative humidity alarm high (value * 2)
 
|-
| 0x39
| 1
| Relative humidity alarm low (value * 2)
 
|-
| 0x3a
| 2
| unknown (00 00)
 
|-
| 0x3c
| 4
| unknown (00 00 00 00)
 
|}


=== Device-specific information ===
== Example use ==
The 16-bit field at offset 0x2e in the configuration structure has different meanings depending on the type of device. It can be either a 16-bit little-endian integer or a bitfield.


{| border="0" width="100%" style="margin: 0; font-size: smaller" class="alternategrey sigroktable"
(This use case was reported by user confuc via IRC.)
|-
! colspan="2" align="left" | EL-USB-2
|-
{| border="0" width="100%" style="margin: 0;" class="alternategrey"
|-
| style="width: 5em;" | 0x0000
| Celcius
|-
| 0x0001
| Fahrenheit
|}


|}
  $ sigrok-cli -d lascar-el-usb:conn=10c4.0002 --samples 16382 -o file.sr


== Resources ==
== Resources ==


TODO.
* [http://www.lascarelectronics.com/pdf-usb-datalogging/data-logger0765755001349354469.pdf Manual]
* [http://www.lascarelectronics.com/data-logger/easylogger-software.php Vendor software]
* [http://sourceforge.net/apps/mediawiki/eltuxusb/index.php?title=Main_Page eltuxusb project]


[[Category:Device]]
[[Category:Device]]
[[Category:Thermometer]]
[[Category:Thermometer]]
[[Category:In progress]]
[[Category:Hygrometer]]
[[Category:Supported]]

Latest revision as of 18:16, 24 February 2020

Lascar Electronics EL-USB-2

The Lascar Electronics EL-USB-2 is a USB-based temperature and humidity logger.

See Lascar Electronics EL-USB-2/Info for more details (such as lsusb -vvv output) about the device.

The sigrok driver for this device also supports the EL-USB-2+, EL-USB-LCD, and EL-USB-LCD+. Note that only downloading logged data is supported by sigrok; configuring the device is not currently supported.

Hardware

Photos

  • Device, top

  • Device, side

  • Device, uncapped

  • Device, battery

  • Sensirion SHT11

  • PCB, top

  • PCB, bottom

  • SiLabs C8051F321

  • Microchip 24LC256

Protocol

See Lascar Electronics EL-USB protocol.

Example use

(This use case was reported by user confuc via IRC.) 

 $ sigrok-cli -d lascar-el-usb:conn=10c4.0002 --samples 16382 -o file.sr

Resources

Retrieved from "https://sigrok.org/w/index.php?title=Lascar_Electronics_EL-USB-2&oldid=14907"