thsq-simulator v1.0.1
Thingsquare device simulator
The thsq-simulator
is a simulator for Thingsquare devices. This simulator can run on any desktop machine, which makes it easier to work with than the actual hardware.
The purpose of the simulator is to make backend integration and algorithm development easier.
Requirements
NodeJS and npm.
Installation
npm install --save thsq-simulator
Create a first simulator
Here's a full implementation of a simple simulator. This implementation can be modified to alter the behavior of the simulated devices. Save this content to simulator.js
.
var thsqsim = require('thsq-simulator');
var getopts = require('getopts');
require('console-stamp')(console, { pattern : 'HH:MM:ss.l' });
function usage() {
console.info('usage: node simulator.js -u <token> -d <num devices> -n <num networks>');
console.info('<token> is an API token that can be retrieved from https://developer.thingsquare.com/web/, under the User tab, by checking the "Enable API access" checkbox');
console.info('<num devices> is the number of simulated devices to spin up');
console.info('optional: -f <frontend> -b <backend>');
process.exit(1);
}
var options = getopts(process.argv.slice(2), {
alias: {
user: 'u',
frontend: 'f',
backend: 'b',
networks: 'n',
devices: 'd',
platform: 'p',
applatform: 'a',
filename: 'F'
},
default: {
frontend: 'b72af87d-42d7-4f09-bf8c-b9f721a3e6ef',
backend: 'developer.thingsquare.com',
networks: 1,
devices: 10,
proptime: 100,
period: 3600 * 10,
}
});
if (!options.user || !options.devices) {
usage();
return;
}
thsqsim.on('boot', function (device) {
});
thsqsim.on('variable', function (device, key, val, oldval) {
});
thsqsim.on('command', function (device, command, data) {
});
thsqsim.init({
token: options.user,
frontend: options.frontend,
backend: options.backend,
platform: options.platform,
applatform: options.applatform,
devices: options.devices,
period: options.period,
proptime: options.proptime,
networks: options.networks,
deadleaf: options.deadleaf,
statefilename: options.filename }, function () {
console.log('started');
});
Running the simulator
First grab an API key.
Go to https://developer.thingsquare.com/web/ and log in.
The API key can be found under the User tab (make sure to enable API access
first).
Then run:
node thsq-simulator.js -u <API token from above> -n <number of simulated devices>
This will produce output similar to this:
$ node simulator.js -u <the API token> -n 10
[18:00:00.726] [LOG] Creating device 0 / 11
[18:00:01.760] [LOG] Creating device 1 / 11
[18:00:02.914] [LOG] Creating device 2 / 11
[18:00:04.078] [LOG] Creating device 3 / 11
[18:00:05.384] [LOG] Creating device 4 / 11
[18:00:06.397] [LOG] Creating device 5 / 11
[18:00:07.637] [LOG] Creating device 6 / 11
[18:00:08.197] [LOG] Creating device 7 / 11
[18:00:08.581] [LOG] Creating device 8 / 11
[18:00:08.948] [LOG] Creating device 9 / 11
[18:00:10.082] [LOG] Creating device 10 / 11
[18:00:10.901] [LOG] Creating device 11 / 11
[18:00:10.902] [LOG] All simulated devices started
The simulated devices will then show up in https://developer.thingsquare.com/web/.
Customizing the simulator
By default simulated devices post a randomized value to the server variable t
. To override what the device post, pass a periodiccallback
parameters to the thsqsim.init
function. Here's a full example of how to instead set and push a myvariable
server variable.
function pushmyvariable(device) {
device.pushVariable('s', 'myvariable', 'myvalue');
device.sendStats();
}
thsqsim.init({
...
periodiccallback: pushmyvariable,
...
});