Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Patriot is an open source, Arduino hobby IoT project using devices, Alexa, and iOS apps.

Patriot IoT Diagram

It is intended to help other hobbyists quickly create Internet-of-Things projects that can be controlled using Voice (Alexa) and iOS devices without having to recreate new Alexa skills or iOS apps.

This is a work in progress. Your Photon based IoT projects can be created using any of the standard development tools (Web IDE, Particle IDE, or Particle CLI).

The main objective is to allow the creation of networks of IoT devices that can communicate with each other, and is:

  1. Easily extensible: new devices can be added without having to modify existing devices.
  2. Super simple to program
  3. Reuses existing code, including the Alexa skills, iOS apps, and Photon library code.

I've posted a short video showing it on YouTube.

Refer to Patriot iOS App and Alexa Controlled Photon Project without Alexa Coding on, or my blog at for more information.

iOS Apps

This repository contains the iOS control panel app that allows you to interact with Patriot devices using your 4s or newer iPhone. A separate Patriot-iOS6 reposity is used for code supporting older iPhones (3GS and 4)

Patriot IoT Diagram

This app can be used to control devices from your iPhone or iPad. For example, you can use your old iOS devices as control panels to turn on and off devices that you implement using Photons.

In addition, I've created a separate iOS app that can run on older iOS devices. I use this to provide control panels by mounting unused, older iPhones directly to the wall in various places around my RV.

Currently the apps must be compiled in Xcode with your credentials and downloaded to your iPhone or iPad manually, but I intend to allow the use of a single, published app using OAuth in the future. It remains to be seen whether Apple will allow certifying a hobbyist app such as this, but I'm going to try.

Build Instructions

  1. Download the source
  2. Rename the file secret-template.swift to secret.swift
  3. Edit the file to include your credentials
  4. Build in Xcode and download to an iPhone 4s or later.

You will need to have at least one Photon installed on your account using one of the Patriot demo sketches. This will expose several variables that will be read by the iOS app during startup.


This code is very preliminary and could use improvement. If you encounter errors, here are some things to try:

  1. Run the code in Xcode and note the messages displayed in the console.
  2. Open the Console, log in to your account, and watch messages produced by both the iOS app and any attached Photons you have running the Patriot code.
  3. If you have an Alexa installed running Patriot, issue commands using it and compare the messages displayed in the console with those generated by the iOS app.

Release History

Refer to the (Releases page)[] for release history.


iOS control panel to display and control Patriot Photon devices







No packages published