1
0
mirror of https://github.com/node-red/node-red-nodes.git synced 2023-10-10 13:36:58 +02:00
node-red-nodes/hardware/pigpiod/README.md
Dave Conway-Jones fc249b6792
Add PiGPIOd node
alternative to Pi GPIO nodes with remote access
2017-04-14 21:37:44 +01:00

2.6 KiB

node-red-node-pi-gpiod

An alternative pair of Node-RED nodes to interact with Pi GPIO using the PiGPIOd daemon that is now part of Raspbian.

The advantage is that it also talk to GPIO on a Pi that is remote as long as it is running the daemon, and also sharing pins works more cleanly as contention is handled by the multiple connections.

The disadvantage is that you must setup and run the PiGPIO daemon first.

Requirements

PiGPIOd must be running on the pi. The easiest way to ensure this is to add the following line to your Pi /etc/rc.local file.

/usr/bin/pigpiod

Note: By default this will expose the daemon on TCP port 8888, which is obviously a security vulnerability. If you don't want or need remote access then you can start it in local mode only, (-l option), or restrict permissions to certain ip addresses, (-n {ipaddr} option). For example:

/usr/bin/pigpiod -l
/usr/bin/pigpiod -n 192.168.1.10

See the instructions for more details.

Install

Run the following command in your Node-RED user directory - typically ~/.node-red

    npm install node-red-node-pi-gpiod

Usage

Note: the pin numbers refer the physical pin numbers on connector P1 as they are easier to locate.

Input node

Generates a msg.payload with either a 0 or 1 depending on the state of the input pin.

Outputs
  • msg.payload - number - the level of the pin (0 or 1)
  • msg.topic - string - pi/{the pin number}
Details

You may also enable the input pullup resistor ↑ or the pulldown resistor ↓.

Output node

Can be used in Digital, PWM or Servo modes.

Input
  • msg.payload - number | string
  • Digital - 0, 1 - set pin low or high
  • PWM - 0 to 100 - level from 0 to 100%
  • Servo - 0 to 100, 50 is centred.

Hint: The range node can be used to scale inputs to the correct range.

Details

Digital mode expects a msg.payload with either a 0 or 1 (or true or false), and will set the selected physical pin high or low depending on the value passed in.

The initial value of the pin at deploy time can also be set to 0 or 1.

When using PWM and Servo modes, the input value should be a number 0 - 100, and can be floating point.

In servo mode you can also preset the minimum and maximum pulse times as required by your servo in order to reach its full range. Minimum of 5mS, maximum of 25 mS - defaults to 10 and 20 mS respectively.