twins/README.md

Digital twin PoC demo

# TWINS #

[![GitHub forks](https://img.shields.io/github/forks/rzr/twins.svg?style=social&label=Fork&maxAge=2592000)](https://GitHub.com/rzr/twins/network/)
[![license](https://img.shields.io/badge/license-MPL--2.0-blue.svg)](LICENSE)
[![NPM](https://img.shields.io/npm/v/twins.svg)](https://www.npmjs.com/package/twins)
[![IRC Channel](https://img.shields.io/badge/chat-on%20freenode-brightgreen.svg)](https://kiwiirc.com/client/irc.freenode.net/#tizen)

[![NPM](https://nodei.co/npm/twins.png)](https://npmjs.org/package/twins)


## INTRODUCTION: ##

Web Of Twins proof of concept

[![Concept](https://image.slidesharecdn.com/web-of-twins-20190604rzr-190604205255/95/weboftwins20190604rzr-1-638.jpg)](http://www.slideshare.net/slideshow/embed_code/key/16GRRsNuiRCfa6#weboftwins20190604rzr# "weboftwins20190604rzr")


## USAGE: ##

### USING IOT.JS: ###

```sh
make start
#| iotjs index.js 
#| Listening:
#| http://localhost:8888/

url=http://localhost:8888
curl $url/properties
#| {"torso":0,"shoulder":0,"arm":0,"hand":0}

curl -X PUT  -H "Content-type: application/json" -d '{ "hand": 10 }' $url/properties/hand
#| {"hand":10}

make demo
```

Then twin can be visualized using:

* [A-frame (./aframe/index.html) ](./aframe/index.html) rendering page
* <http://rzr.github.io/twins/aframe/?url=http://localhost:8888>


### USING NODE.JS: ###

Usage is straightforward:

```sh
npm install
npm start 8042
#| > node index
#| Listening:
#| http://localhost:8842/
```

### USING GLITCH: ###

* <http://rzr.github.io/twins/aframe>
* <http://rzr.github.io/twins/aframe/?url=https://twins.glitch.me>

### USING MOZILLA WEBTHING GATEWAY: ###

* Issue token

```sh
cd aframe
npm install && PORT=42088 npm start

url='http://localhost:42088/?'
httpUrl='https://rzr.mozilla-iot.org/things/http---192.100.0.13-888'
useWs="false"
bearer='eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IjI0YWZiMGI4LTdlMDktNDgzYy1iMTc4LTkyNDBjMjQxMWMxNiJ9.eyJjbGllbnRfaWQiOiJsb2NhbC10b2tlbiIsInJvbGUiOiJhY2Nlc3NfdG9rZW4iLCJzY29wZSI6Ii90aGluZ3M6cmVhZHdyaXRlIiwiaWF0IjoxNTgwNDA1NDkyLCJpc3MiOiJodHRwczovL3J6ci5tb3ppbGxhLWlvdC5vcmcifQ.9OoC503xdppFBEKMKQoXBnK5RbamLuWo0hZg2evdImRUXwVEovfbhAqHFCwCFGyADYKpT8mTWOzlMKZ_ahddoA'
url="$url&url=$httpUrl"
url="$url&useWs=$useWs"
url="$url&bearer=$bearer"
www-browser "$url"
```


## GUIDE: ##

Demo Howto and more insights at:

* <https://github.com/rzr/webthing-iotjs/wiki/DigitalTwins>


## DEMO: ##

[![PoC](https://i.giphy.com/media/XCsnIn6WlWNOeT2etZ/giphy.gif)](https://purl.org/rzr/digitaltwins-webthings-iotjs-20190512rzr#digitaltwins-webthings-iotjs-20190512rzr# "digitaltwins-webthings-iotjs-20190512rzr")


## RESOURCES: ##

* <http://purl.org/rzr/presentations#>
* <https://fosdem.org/2020/schedule/event/iotnuttx/#>
* <https://fosdem.org/2020/schedule/event/web_of_twins/>
* <https://purl.org/rzr/digitaltwins-webthings-iotjs-20190512rzr#>
* <https://purl.org/aframe-webthing#>
* <https://github.com/rzr/aframe-webthing#>
* <https://github.com/sponsors/rzr/#>
* <https://hacks.mozilla.org/2019/03/connecting-real-things-to-virtual-worlds-using-web/>
* <https://github.com/jerryscript-project/iotjs-modules/pull/5>