homestar-persist v3.0.4
homestar-persist
IOTDB module to persist Thing data to disk
About
- This will persist (write to disk) all the data belonging to your Things.
- It will also allow modification of that data, which will be written back to the Things, e.g. to modify metadata or the state.
- It provides CLI tools to modify state
Files
Files are persisted in .iotdb/things
. After you've played with this
it's worth looking at what it's actually storing.
Installation and Configuration
If you want to use the CLI tools (you probably do), also install Home☆Star:
Then:
$ npm install homestar-persist
Use
Tracking IOTDB installation
const iotdb = require("iotdb")
// e.g. connect to stuff
iotdb.use("homestar-wemo");
iotdb.connect("WeMoSocket");
// this is the magic
iotdb.use("homestar-persist");
That's it! If you look in .iotdb/things
you'll see
all the Things that IOTDB discovers listed here, one
folder per id
and then one JSON file per band.
In Home☆Star
Just add the following to boot/index.js
after you've
set up Home☆Star:
iotdb.use("homestar-persist");
Command Line
things
This will list everything this module knows about your Things:
$ homestar things
Note that
put
To get all the options, try
$ homestar put --help
The naming convention for keys, e.g. meta/schema:name
will make more
sense if you try homestar things
first
Turn on Thing named 'WeMo Switch' (--boolean
is optional here because
IOTDB's type coercion system will Do The Right Thing)
$ homestar put --boolean --name 'WeMo Switch' :on true
Rename the Thing with id 'urn:iotdb:t:sArvozfc:092qoWwd'
$ homestar put --id 'urn:iotdb:t:sArvozfc:092qoWwd' meta/schema:name 'New Name'
Turn off everything
$ homestar put --all :on 0
Turn on Things that are made by Belkin.
$ homestar put --select meta/schema:manufacturer=http://www.belkin.com/ :on 1