pimatic-gpio

Provides Actuators and Sensors for the Raspberry Pi GPIO Pins.

Usage no npm install needed!

<script type="module">
  import pimaticGpio from 'https://cdn.skypack.dev/pimatic-gpio';
</script>

README

pimatic-gpio

Actuators and sensors for the Raspberry Pi GPIO pins. This plugin uses the node.js module onoff.

Plugin Configuration

You can load the plugin by editing your config.json to include:

{ 
   "plugin": "gpio"
}

in the plugins Array.

Device Configuration

Devices can be added by adding them to the devices Array in the config file. Set the class property to GpioSwitch, GpioPresence, or GpioContact, respectively. By default, the device state will be true , i.e. on, opened, or present, when the GPIO pin is HIGH. If you need the device to be active on LOW, set the property inverted to true.

The GpioSwitch device additionally provides the optional defaultState property which can be used to set the initial switch state to the given value. If the property is not present the last state will be recovered from database or it will be set to false if the last state cannot be obtained.

For device configuration options see the device-config-schema file.

GPIO Pin Numbering

Use the GPIO numbers from the RPi Low-level peripherals wiki page.

Internal Pull-up and Pull-down Resistors

On Raspberry Pi, most GPIOs have either their pull-up or pull-down resistor activated by default. For further details, see Configuring pull-up and pull-down resistors.

Device examples

GpioSwitch Device ("active LOW" and "defaultState")

{ 
  "id": "led-light",
  "class": "GpioSwitch", 
  "name": "led light",
  "gpio": 17,
  "inverted": true,
  "defaultState": false
}

GpioPresence Sensor

{ 
  "id": "presence-sensor",
  "class": "GpioPresence", 
  "name": "motion detector",
  "gpio": 18 
}

GpioContact Sensor

{ 
  "id": "contact-sensor",
  "class": "GpioContact", 
  "name": "contact detector",
  "debounceTimeout": 50,
  "gpio": 18 
}