https://github.com/microclimates/mc-device-full
Template for a secure Microclimates device, with all bells and whistles
https://github.com/microclimates/mc-device-full
Last synced: 5 months ago
JSON representation
Template for a secure Microclimates device, with all bells and whistles
- Host: GitHub
- URL: https://github.com/microclimates/mc-device-full
- Owner: microclimates
- Created: 2017-04-27T20:00:30.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2017-04-27T20:01:43.000Z (about 9 years ago)
- Last Synced: 2025-06-02T07:10:38.446Z (about 1 year ago)
- Homepage:
- Size: 1000 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Microclimates Device Module Template
====================================
This repository contains the minimum requirements for installing your device
into a secure [Microclimates](https://www.microclimates.com) network.
It's designed to be used as a template for your own device module.
While there is no requirement for this to install a device, it will allow
the device be installed without the security warning.
We recommend all devices running within the secure network have this minimum installation,
consting of the package.json file acknowledging your understanding and
acceptance of the [security agreement](https://www.microclimates.com/device-security-agreement)
and [privacy policy](https://www.microclimates.com/device-privacy-policy).
Device Requirements
-------------------
Any device following the [Homie convention](https://github.com/marvinroger/homie)
can be added to the secure Microclimates network. It has been tested using the [ESP8266](https://github.com/marvinroger/homie-esp8266) homie
library.
In order to find your device module it must be published to npm, and the following must be in the device settings section of the [JSON configuration file](https://homie-esp8266.readme.io/docs/json-configuration-file) on the device:
```
{
...
"settings": {
"npm-module": "this-repo@^2.12.0"
}
}
```
If the `npm-module` value contains a semver range as in the above example, automatic updates of your module are restrained to this range.
Installing
----------
The device must be in configuration mode as a WiFi hotspot, broadcasting an SSID. If the SSID begins with `homie-` or `microclimates-`, the Microclimates hub will find it without asking the user to view all available SSIDs.
Once the user confirms their intent to install the device, the `microclimates` section of the `package.json` for your module will be downloaded, validated, and presented to the user.
Upon installation, your device will be configured to connect to the secure Microclimates network, the shared MQTT message bus, and be controlled by [node-red](http://nodered.org/) flows and the external [Climate Control API](https://microclimates.com/api/v1/).
License
-------
Copyright 2017 Microclimates, Inc.
May be freely distributed under the [MIT license](https://opensource.org/licenses/MIT)