Skip to content

Latest commit

 

History

History
54 lines (32 loc) · 2.12 KB

README.md

File metadata and controls

54 lines (32 loc) · 2.12 KB

iot-cloud-cli

iot-cloud-cli is a command line interface that allows to exploit the features of Arduino IoT Cloud. As of now, it is possible to provision a device.

Requirements

This is all you need to use iot-cloud-cli for device provisioning:

  • A client ID and a secret ID, retrievable from the cloud by creating a new API key
  • The folder containing the precompiled provisioning firmwares (binaries) needs to be in the same location you run the command from

Set a configuration

iot-cloud-cli needs to be configured before being used. In particular a client ID and the corresponding secret ID should be set. You can retrieve them from the cloud by creating a new API key.

Once you have the IDs, call this command with your parameters:

$ iot-cloud-cli config -c <clientID> -s <secretID>

A file named config.yaml will be created in the Current Working Directory containing the login credentials. Example

client: 00112233445566778899aabbccddeeff
secret: 00112233445566778899aabbccddeeffffeeddccbbaa99887766554433221100

Device provisioning

When provisioning a device, you can optionally specify the port to which the device is connected to and its fqbn. If they are not given, then the first device found will be provisioned.

Use this command to provision a device:

$ iot-cloud-cli device create --name <deviceName> --port <port> --fqbn <deviceFqbn>

Device commands

Once a device has been created thorugh the provisioning procedure, it can be deleted by using the following command: $ iot-cloud-cli device delete --id <deviceID>

Devices currently present on Arduino IoT Cloud can be retrieved by using this command: $ iot-cloud-cli device list

Thing commands

Things can be created starting from a template or by cloning another thing. Additionally, a thing name should be specified.

Create a thing from a template:

$ iot-cloud-cli thing create --name <thingName> --template <template.json>

Create a thing by cloning another thing:

$ iot-cloud-cli thing create --name <thingName> --clone-id <thingToCloneID>