PatriotRelay (community library)


Name Value
Name PatriotRelay
Version 3.0.0
Installs 625
License BSD
Author Ron Lisle
Download .tar.gz
All Versions 3.0.0, 2.1.1, 2.0.0

Extend Patriot IoT to support a relay connected to a GPIO. Patriot provides support for controlling IoT devices using Alexa and iOS devices. This plugin adds support

Example Build Testing

Device OS Version:

This table is generated from an automated build. Success only indicates that the code compiled successfully.

Library Read Me

This content is provided by the library maintainer and has not been validated or approved.


A Patriot plugin to support simple relays.


Include this library in a Photon sketch to control simple on/off devices such as relays.

Note that many relay type devices require more current than can be safely provided by a GPIO pin. In these cases you will need to provide some sort of driver circuit (eg. transistor, MOSFET, etc) to provide ample current to the device.

This example creates a single device connected to a relay attached to GPIO D0. The device is named "relay".

Since Patriot supports automatic detection by the iOS app and Alexa, either of these can be used to control the relay once this sketch is loaded to a Photon. There may be a 15 minute delay before Alexa starts to work, since a "Discover Devices" cycle is needed. You can manually invoke a discovery using the Alexa app to eliminate the delay.

After Alexa discovery is performed, you can control this by saying "Alexa, turn on relay" or "Alexa, turn off relay".


Refer to the Patriot Github repository and documentation for more information.


Here's how you can make changes to this library and eventually contribute those changes back.

To get started, clone the library from GitHub to your local machine.

Change the name of the library in to something different. You can add your name at then end.

Modify the sources in and with the new behavior.

To compile an example, use particle compile examples/usage command in Particle CLI or use our Desktop IDE.

After your changes are done you can upload them with particle library upload or Upload command in the IDE. This will create a private (only visible by you) library that you can use in other projects. Do particle library add IoT_myname to add the library to a project on your machine or add the IoT_myname library to a project on the Web IDE or Desktop IDE.

At this point, you can create a GitHub pull request with your changes to the original library.

If you wish to make your library public, use particle library publish or Publish command.


Copyright 2017 Ron Lisle

Refer to the included LICENSE file.

Browse Library Files