Class: Denko::Sensor::SHT3X

Inherits:
Object
  • Object
show all
Includes:
Behaviors::Lifecycle, Behaviors::Poller, I2C::Peripheral, HumidityHelper, TemperatureHelper
Defined in:
lib/denko/sensor/sht3x.rb

Constant Summary collapse

I2C_ADDRESS = 
0x44
RESET = 
0x30A2
RESET_TIME = 
0.002
HEATER_OFF = 
0x3066
HEATER_ON = 
0x306D
FETCH_DATA = 
0xE000
REPEATABILITY = 
{
  high:   { lsb: 0x00, measurement_time: 0.016 },
  medium: { lsb: 0x0B, measurement_time: 0.007 },
  low:    { lsb: 0x16, measurement_time: 0.005 },
}
READ_STATUS_REGISTER =

Unused

0xF32D
CLEAR_STATUS_REGISTER = 
0x3041
BREAK = 
0x3093
ART = 
0x2B32
CRC_INITIAL_VALUE =

CRC is same as AHT20 sensor. Copied from that file.

0xFF
CRC_POLYNOMIAL = 
0x31
MSBIT_MASK = 
0x80

Constants included from Behaviors::Lifecycle

Behaviors::Lifecycle::CALLBACK_METHODS

Constants included from Behaviors::Reader

Behaviors::Reader::READ_WAIT_TIME

Constants included from I2C::Peripheral

I2C::Peripheral::I2C_FREQUENCY, I2C::Peripheral::I2C_REPEATED_START

Instance Attribute Summary

Attributes included from Behaviors::Threaded

#interrupts_enabled, #thread

Attributes included from I2C::Peripheral

#i2c_frequency, #i2c_repeated_start

Attributes included from Behaviors::Component

#board, #params

Instance Method Summary collapse

Methods included from HumidityHelper

#humidity

Methods included from TemperatureHelper

#temperature, #temperature_f, #temperature_k

Methods included from Behaviors::Lifecycle

included

Methods included from Behaviors::Poller

#poll, #poll_using, #stop

Methods included from Behaviors::Threaded

#enable_interrupts, included, #mruby_thread_check, #stop, #stop_thread, #threaded, #threaded_loop

Methods included from Behaviors::Reader

#read, #read_busy?, #read_nb, #read_raw, #read_using, #update

Methods included from Behaviors::Callbacks

#add_callback, #callbacks, #remove_callback, #update

Methods included from I2C::Peripheral

#address, #i2c_default, #i2c_read, #i2c_read_raw, #i2c_write

Methods included from Behaviors::BusPeripheralAddressed

#address

Methods included from Behaviors::BusPeripheral

#atomically

Methods included from Behaviors::Component

#initialize, #micro_delay

Instance Method Details

#_read ⇒ Object 



48
49
50
51
52
 
# File 'lib/denko/sensor/sht3x.rb', line 48

def _read
  i2c_write [0x24, @measurement_lsb]
  sleep(@measurement_time)
  i2c_read(6, register: FETCH_DATA)
end

#calculate_crc(bytes) ⇒ Object 



111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
 
# File 'lib/denko/sensor/sht3x.rb', line 111

def calculate_crc(bytes)
  crc = CRC_INITIAL_VALUE

  # Ignore last byte. That's the CRC value to compare with.
  bytes.take(bytes.length - 1).each do |byte|
    crc = crc ^ byte
    8.times do
      if (crc & MSBIT_MASK) > 0
        crc = (crc << 1) ^ CRC_POLYNOMIAL
      else
        crc = crc << 1
      end
    end
  end

  # Limit CRC size to 8 bits.
  crc = crc & 0xFF
end

#heater_off ⇒ Object 



101
102
103
104
 
# File 'lib/denko/sensor/sht3x.rb', line 101

def heater_off
  i2c_write [HEATER_OFF]
  @heater_on = false
end

#heater_off? ⇒ Boolean

Returns:

  • (Boolean) 


92
93
94
 
# File 'lib/denko/sensor/sht3x.rb', line 92

def heater_off?
  !@heater_on
end

#heater_on ⇒ Object 



96
97
98
99
 
# File 'lib/denko/sensor/sht3x.rb', line 96

def heater_on
  i2c_write [HEATER_ON]
  @heater_on = true
end

#heater_on? ⇒ Boolean

Returns:

  • (Boolean) 


88
89
90
 
# File 'lib/denko/sensor/sht3x.rb', line 88

def heater_on?
  @heater_on
end

#pre_callback_filter(bytes) ⇒ Object 



54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
 
# File 'lib/denko/sensor/sht3x.rb', line 54

def pre_callback_filter(bytes)
  # Temperature is bytes 0 to 2: MSB, LSB, CRC
  if calculate_crc(bytes[0..2]) == bytes[2]
    t_raw = (bytes[0] << 8) | bytes[1]
    reading[:temperature] = (175 * t_raw / 65535.0) - 45
  else
    reading[:temperature] = nil
  end

  # Humidity is bytes 3 to 5: MSB, LSB, CRC
  if calculate_crc(bytes[3..5]) == bytes[5]
    h_raw = (bytes[3] << 8) | bytes[4]
    reading[:humidity] = 100 * h_raw / 65535.0
  else
    reading[:humidity] = nil
  end

  reading
end

#reading ⇒ Object 



38
39
40
 
# File 'lib/denko/sensor/sht3x.rb', line 38

def reading
  @reading ||= { temperature: nil, humidity: nil }
end

#repeatability=(key) ⇒ Object

Raises:

  • (ArgumentError) 


42
43
44
45
46
 
# File 'lib/denko/sensor/sht3x.rb', line 42

def repeatability=(key)
  raise ArgumentError, "invalid repeatability setting: #{key}" unless REPEATABILITY.keys.include? key
  @measurement_lsb = REPEATABILITY[key][:lsb]
  @measurement_time = REPEATABILITY[key][:measurement_time]
end

#reset ⇒ Object 



82
83
84
85
86
 
# File 'lib/denko/sensor/sht3x.rb', line 82

def reset
  i2c_write [RESET]
  sleep RESET_TIME
  @heater_on = false
end

#state ⇒ Object 



34
35
36
 
# File 'lib/denko/sensor/sht3x.rb', line 34

def state
  @state ||= { temperature: nil, humidity: nil }
end

#update_state(reading) ⇒ Object 



74
75
76
77
78
79
80
 
# File 'lib/denko/sensor/sht3x.rb', line 74

def update_state(reading)
  @state_mutex.lock
  @state[:temperature] = reading[:temperature]
  @state[:humidity]    = reading[:humidity]
  @state_mutex.unlock
  @state
end