Module: j5e/tmp36

Description

A module for measuring temperature using a TMP36 thermistor.

A thermistor is a type of resistor whose resistance is strongly dependent on temperature, more so than in standard resistors. The word thermistor is a portmanteau of thermal and resistor.Read more on Wikipedia

Requires


Class: TMP36

The TMP36 class allows for reading of TMP36 thermistors. Accuracy is within ~1°

Constructor

new TMP36(io)

Parameters

Name
Type
Description
io
(required)
number, string, or object

Description:
Pin identifier or IO Options (See instantiation)

Example

// Use a TMP36
import TMP36 from "j5e/tmp36";

const myTMP36 = await new TMP36(12);

myTMP36.on("change", function(data) {
  trace(data.C);
});

Properties

Name
Type
Description
celsius
(read only)
number
Get degrees in celsius
C
(read only)
number
Alias for celsius
fahrenheit
(read only)
number
Get degrees in fahrenheit
F
(read only)
number
Alias for fahrenheit
kelvin
(read only)
number
Get degrees in kelvin
K
(read only)
number
Alias for kelvin
limit
Array.<number>
Limits the output range
threshold
number
The minimum amount of change required to emit a "change" event
interval
number
The interval between readings (in ms)
smoothing
number
The number of samples to take before finding the median
aref
number
The reference voltage
samples
number
The number of samples to take before finding the median
range
(read only)
Array.<number>
The input range of the sensor
raw
(read only)
number
Get the most recent raw ADC reading
median
(read only)
number
Get the most recent median ADC reading
resolution
(read only)
number
The maximum possible ADC reading
scaled
(read only)
number
Get the most recent scaled raw reading
value
(read only)
number

Events

  • event:data
  • event:change

Methods

TMP36.configure

Configure a TMP36

tmp36.configure(options);

Returns: The instance on which the method was called

Parameters

Name
Type
Description
options
(required)
object

Description:
Device configuration options

options.aref
number

Description:
Analog reference voltage
Default: 3.3

options.enabled
boolean

Description:
Wether the device is currently performing reads every ms
Default: true

options.interval
number

Description:
Interval between readings in millseconds
Default: 100

options.limit
Array.<number>

Description:
Limit the output range

options.range
Array.<number>

Description:
The input range of the sensor
Default: [0, N]

options.scale
Array.<number>

Description:
The output range for the sensor's value
Default: [0, N]

options.threshold
number

Description:
The minimum amount of change required to emit a "change" event
Default: 1

options.toCelsius
callback

Description:
Function that converts raw value to Celsius

Example

// Passing in Cofiguration Options
   import Thermometer from "j5e/thermometer";

const thermometer = await new Thermometer({
  pin: 14
});

myThermometer.configure({
  toCelsius: function(raw) {
    return raw / 16;
  }
});

thermometer.on("change", data => {
  trace(thermometer.celsius);
});

TMP36.enable

Enable a disabled sensor.

tmp36.enable();

Returns: instance

Example

import Sensor from "j5e/sensor";

const sensor = await new Sensor(12);

sensor.disable();

// Wait 5 seconds and then take readings
timer.setTimeout(function() {
  sensor.enable();
});

TMP36.disable

Disable an enabled sensor.

tmp36.disable();

Returns: instance

Example

import Sensor from "j5e/sensor";

const sensor = await new Sensor(12);

// Take reading for 5 seconds and then stop
timer.setTimeout(function() {
  sensor.disable();
});

TMP36.read

Synchronous read of a sensor.

tmp36.read();

Returns: sensor value

Example

import Sensor from "j5e/sensor";

const sensor = await new Sensor(12);

let myValue = sensor.read();

TMP36.scale

scale/scaleTo Set a value scaling range

tmp36.scale(low, high, low, high);

Returns: instance

Parameters

Name
Type
Description
low
(required)
Number

Description:
Lowerbound

high
(required)
Number

Description:
Upperbound

low, high
Array

Description:
Lowerbound

Example

import Sensor from "j5e/sensor";

const sensor = await new Sensor(12);

// Scale all future values to 8-bit range
sensor.scale([0, 255]);

TMP36.scaleTo

scaleTo Scales value to integer representation

tmp36.scaleTo(low, low, high);

Returns: The scaled value

Parameters

Name
Type
Description
low
(required)
Number

Description:
An array containing a lower and upper bound

low
(required)
Number

Description:
A number to use as a lower bound

high
(required)
Number

Description:
A number to use as an upper bound

Example

import Sensor from "j5e/sensor";

const sensor = await new Sensor(12);

// Scale the returned value to 8-bit range
sensor.scaleTo([0, 255]);

TMP36.fscaleTo

fscaleTo Scales value to single precision float representation

tmp36.fscaleTo(low, low, high);

Returns: The scaled value

Parameters

Name
Type
Description
low
(required)
Number

Description:
An array containing a lower and upper bound

low
(required)
Number

Description:
A number to use as a lower bound

high
(required)
Number

Description:
A number to use as an upper bound

Example

import Sensor from "j5e/sensor";

const sensor = await new Sensor(12);

// Scale the returned value to float between 0 and 1
sensor.fscaleTo([0, 1]);

TMP36.within

Fire a callback when the value is within a certain range

tmp36.within(range, unit, callback);

Parameters

Name
Type
Description
range
(required)
Array.<number>

Description:
The upper and lower ends of the range to watch

unit
(required)
string

Description:
The property to test

callback
(required)
function

Description:
A callback to run when the event is fired.


TMP36.on

Create an event listener

tmp36.on(event, listener);

Parameters

Name
Type
Description
event
(required)
string

Description:
The name of the event to listen for

listener
(required)
function

Description:
A callback to run when the event is fired.


TMP36.removeListener

Remove an event listener

tmp36.removeListener(event, listener);

Parameters

Name
Type
Description
event
(required)
string

Description:
The name of the event that we are removing a listener from

listener
(required)
function

Description:
The callback that we are removing


TMP36.emit

Note: This method is not part of the public API, and is subject to change.

Emit an event

tmp36.emit(event);

Parameters

Name
Type
Description
event
(required)
string

Description:
The name of the event to emit


TMP36.once

Create an event listener that will only fire one time.

tmp36.once(event, listener);

Parameters

Name
Type
Description
event
(required)
string

Description:
The name of the event to listen for

listener
(required)
function

Description:
A callback to run when the event is fired.