Recharge IoT Agent

Product vision

Instalation

sudo npm install @recharge/iot-agent -g

# If you encounter permission error
# sudo npm install @recharge/iot-agent -g --unsafe-perm

Provisioning

Device belum punya certificate dan belum terdaftar di IoT Core:

# Get temporary claim
iot-agent get-claim

# Create thing and save its cert+key
iot-agent register-thing --thingType xxxx --serialNumber 8888

Device sudah terdaftar dan sudah punya thingName:

# Login as field engineer
iot-agent login

# Replace existing certificate with a new one
iot-agent renew-cert --thingType xxxx --serialNumber 8888

Run as daemon

# Run this on boot from systemd
iot-agent daemon

Snippets

Successful getcred

Then you will see the following output. Restart the device agent so it will use the new credentials.

pi@raspberrypi:~ $ sudo iot-agent getcred --type nagomi --serial 812161207
✔ loading claim
Device connected
Claim removed
clientId and credentials saved into /root/.config/@recharge/iot-agent-nodejs/config.json
Success
thingName: 812161207
clientId: a3c775dc-1e82-431b-9e3c-ee17d0924f37
message: {
  "deviceConfiguration": {},
  "thingName": "812161207"
}

If Temporary Claim Expired or Invalid

Then you will see the following output. Just do another getclaim and then getcred.

pi@raspberrypi:~ $ sudo iot-agent getcred --type nagomi --serial 812161207
✔ loading claim
error: Error: write EPROTO 1995594192:error:14094416:SSL routines:ssl3_read_bytes:sslv3 alert certificate unknown:../deps/openssl/openssl/ssl/record/rec_layer_s3.c:1544:SSL alert number 46

offline
error: Error: write EPROTO 1995594192:error:14094416:SSL routines:ssl3_read_bytes:sslv3 alert certificate unknown:../deps/openssl/openssl/ssl/record/rec_layer_s3.c:1544:SSL alert number 46

close
reconnect
error: Error: write EPROTO 1995594192:error:14094416:SSL routines:ssl3_read_bytes:sslv3 alert certificate unknown:../deps/openssl/openssl/ssl/record/rec_layer_s3.c:1544:SSL alert number 46

error: Error: write EPROTO 1995594192:error:14094416:SSL routines:ssl3_read_bytes:sslv3 alert certificate unknown:../deps/openssl/openssl/ssl/record/rec_layer_s3.c:1544:SSL alert number 46

close
reconnect
error: Error: write EPROTO 1995594192:error:14094416:SSL routines:ssl3_read_bytes:sslv3 alert certificate unknown:../deps/openssl/openssl/ssl/record/rec_layer_s3.c:1544:SSL alert number 46

error: Error: write EPROTO 1995594192:error:14094416:SSL routines:ssl3_read_bytes:sslv3 alert certificate unknown:../deps/openssl/openssl/ssl/record/rec_layer_s3.c:1544:SSL alert number 46

close
^C

CONTRIBUTING

Publish to npm: yarn publish