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))
 
(13 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
| Get 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.
 
|}
 
=== 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
| unknown (possible temp unit, 00 00=C, 01 00=F)
 
|-
| 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)


|-
== Example use ==
| 0x3a
| 2
| unknown (00 00)


|-
(This use case was reported by user confuc via IRC.)
| 0x3c
| 4
| unknown (00 00 00 00)


|}
  $ sigrok-cli -d lascar-el-usb:conn=10c4.0002 --samples 16382 -o file.sr
The rest of the 128-byte payload is padded with 0xff.


== 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:Planned]]
[[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"