Skip to content

Latest commit

 

History

History
1031 lines (827 loc) · 44.2 KB

DevelopmentGuide.md

File metadata and controls

1031 lines (827 loc) · 44.2 KB

impt Development Guide

This additional guide is intended for developers who use impt to develop Electric Imp application and/or factory firmware.

Please read the main Read Me file first as it covers all the basic impt usage and its common components.

The full impt commands specification is described in the impt Commands Manual.

Contents

Projects

A Project is an impt entity intended to help developers manage their work. It:

  • Simplifies the calling of many impt commands.
  • Uploads device and agent source code files to a Device Group.
  • Allows you to easily share and/or move your project between users and/or computers.

Note Using Projects is not mandatory; you can perform the same actions without using Projects.

A Project is encapsulated in one directory. A directory represents a Project if it contains a Project file. There can be only one Project file in a directory. All Projects are independent. A sub-directory may contain a totally different Project.

Each Project references a single Device Group which is specified during Project creation and cannot be changed (you must re-create the Project instead). Only two types of Device Group are supported by a Project:

  • development — for application firmware.
  • pre-factory — for factory firmware.

Implicitly a Project references other impCentral API entities, for example the Product to which the Project’s Device Group belongs; the latest Deployment to the Device Group; Devices assigned to the Device Group.

Each Project always references two files, one containing the device source code, the other with the agent source code. It is assumed that the files are located in the same directory as the Project file. At any time, the Project may be updated to reference other files. Any one or both files may not exist, eg. if you are working on device code but not agent code. Most Project-related operations still work in this case, but device and agent files are always required if you want to deploy a new build — either of these files may be empty but should exist.

When you call impt commands from a directory with a Project file, all of the related entities (Device Group, Product, Deployment, Devices, files) are specified by default, ie. you need not specify them explicitly in the corresponding commands.

Note: impt, like the impCentral API, does not provide any source code version control or software configuration management functionality. That may be done by other appropriate tools. The Project simply links the source files to impCentral API entities.

For Project management, impt includes Project Manipulation Commands.

Development Tasks

The following documentation assumes that all commands are called from the directory where your Project is located.

Project Creation

Project creation centers on the creation of Project file in the directory from where the project creation command is called. If the directory already contains a Project file, this is overwritten after confirmation from the user. However, we recommend that you explicitly delete the previous Project file.

There are two ways to create a Project: base it on an existing Device Group or create a new one from scratch.

Link a Device Group

Use the impt project link command. This creates a Project which references the existing Device Group; it just links it to the local source files. The source files can be specified directly using the --device-file <device_file> and --agent-file <agent_file> options. Or the default names can be used. If a specified file does not exist, the command creates it as an empty file.

Example

> impt project link --dg MyDG
Device source file "device.nut" is created successfully.
Agent source file "agent.nut" is created successfully.
Project is linked successfully.
Project info:
Device file:  device.nut
Agent file:   agent.nut
Device Group:
  id:          27f8ee81-59cd-a9ad-d2a4-e430e4e19ae9
  type:        development
  name:        MyDG
  description: New description of my DG
  region:
  created_at:  2018-01-22T18:20:28.399Z
  updated_at:  2018-01-22T18:21:10.057Z
  Product:
    id:   da0800ab-ad5f-c54e-949e-ec986efb0bf1
    name: MyProduct
IMPT COMMAND SUCCEEDS

Create a New Device Group

Use the impt project create command. This creates a new Device Group and a Project which references that Device Group. The Device Group should belong to a Product:

  • If you already have the Product, specify its ID or name as a value of the --product <PRODUCT_IDENTIFIER> option.
  • If you want to create a new Product, specify its name as a value of the --product <PRODUCT_IDENTIFIER> option and add the --create-product option.

By default, it is assumed that the new Project is going to be used for application firmware development, so the new Device Group will be a Development Device Group. If you create the Project for factory firmware development, specify the --pre-factory option to create a Pre-factory Device Group. In this case, you also need to specify a production target Device Group which should be of the pre-production type and belong to the same Product:

  • If you already have the production target Device Group, specify its ID or name as a value of the --target <DEVICE_GROUP_IDENTIFIER> option.
  • If you need to create a new production target Device Group, specify its name as a value of the --target <DEVICE_GROUP_IDENTIFIER> option and add the --create-target option.

Alternatively, you can create the required impCentral API entities in advance using other impt commands. For example, use impt product create to create the Product, and impt dg create to create the production target Device Group and/or the Project's Device Group itself.

The source code files can be specified directly using the --device-file <device_file> and --agent-file <agent_file> options. Or the default names can be used. If a specified file does not exist, the command creates it as an empty file.

Example

> impt project create --product MyProduct --name MyDG
Device Group "MyDG" is created successfully.
Device source file "device.nut" is created successfully.
Agent source file "agent.nut" is created successfully.
Project is created successfully.
Project info:
Device file:  device.nut
Agent file:   agent.nut
Device Group:
  id:          27f8ee81-59cd-a9ad-d2a4-e430e4e19ae9
  type:        development
  name:        MyDG
  description:
  region:
  created_at:  2018-01-22T18:20:28.399Z
  updated_at:  2018-01-22T18:20:28.399Z
  Product:
    id:   da0800ab-ad5f-c54e-949e-ec986efb0bf1
    name: MyProduct
IMPT COMMAND SUCCEEDS

Updating Projects

You can update your Project at any time with the impt project update command. The following can be updated:

  • The project’s Device Group name and description, and the production target. The same can be done with impt dg update.
  • Change the source files which are linked to the Project.

Note You can update other impCentral API entities related to your Project by using other impt commands. For example, use impt product update to change the name and/or description of the related Product.

Example

Update the description of the Project’s Device Group, change the linked device source file to device1.nut

> impt project update --descr "New description of my DG" --device-file device1.nut
Device Group "27f8ee81-59cd-a9ad-d2a4-e430e4e19ae9" is updated successfully.
Device source file "device1.nut" is created successfully.
Project is updated successfully.
Project info:
Device file:  device1.nut
Agent file:   agent.nut
Device Group:
  id:          27f8ee81-59cd-a9ad-d2a4-e430e4e19ae9
  type:        development
  name:        MyDG
  description: New description of my DG
  region:
  created_at:  2018-01-22T18:20:28.399Z
  updated_at:  2018-01-22T18:21:10.057Z
  Product:
    id:   da0800ab-ad5f-c54e-949e-ec986efb0bf1
    name: MyProduct
IMPT COMMAND SUCCEEDS

Device Manipulation

You can add or remove devices to or from your Project at any time. That means assigning/unassigning devices to/from the Project’s Device Group. You just need to know an identifier of the required device: device ID, name, MAC address, or its agent ID.

You can use impt device list to find an identifier for the required device.

Examples

> impt device assign --device myDevice1
Device "myDevice1" is assigned successfully to Device Group "27f8ee81-59cd-a9ad-d2a4-e430e4e19ae9".
IMPT COMMAND SUCCEEDS

> impt dg reassign --from TestDG
The following Devices assigned to Device Group "TestDG" are reassigned successfully to Device Group
"27f8ee81-59cd-a9ad-d2a4-e430e4e19ae9":
Device:
  id:            23522f6938a609ee
  name:          myDevice2
  mac_address:   0c:2a:69:03:ea:f0
  agent_id:      5t0B6z6c4nHF
  device_online: true
IMPT COMMAND SUCCEEDS

Creating and Running Builds

To create a new build (a Deployment) without running it immediately, use impt build deploy. By default, the Deployment will be created from the source files referenced by your Project. When you want to run the newly created Deployment:

Alternatively, you can use impt build run. This behaves exactly like the impt build deploy command followed by impt dg restart.

Example

Create a new flagged Deployment with description and tag

> impt build deploy --descr "my new build" --tag TAG1 --flagged
Deployment "b3cd81d0-0be3-b7a3-f15c-df2ded28a154" is created successfully.
IMPT COMMAND SUCCEEDS

Run the new Deployment

> impt dg restart
Restart request for Devices assigned to Device Group "27f8ee81-59cd-a9ad-d2a4-e430e4e19ae9" is successful:
Device:
  id:            234776801163a9ee
  name:          myDevice1
  mac_address:   0c:2a:69:05:0d:62
  agent_id:      T1oUmIZ3At_N
  device_online: true
IMPT COMMAND SUCCEEDS

Logging

The impCentral API provides two types of logs: historical and real-time streams.

Historical Logs

To display historical logs for a device, use impt log get. You do not need to specify a device identifier if there is only one device in your Project (ie. assigned to the Project’s Device Group).

The log entries are displayed in pages. The page size may be specified in the command. By default, all pages are displayed one by one, starting from the most recent log entry and pausing after every page. To display the next page, press Enter. To stop displaying, press Ctrl-C. Alternatively, the command allows you to specify a page number to display. In this case, only the specified page is displayed and the command finishes.

Note A limited number of log entries are kept by impCentral API for a limited period of time.

Example

> impt log get --page-size 5
2018-01-22T18:33:59.537Z [agent.log] { "measureTime": "1516646039", "data": 8 }
2018-01-22T18:33:59.536Z [agent.log] Data published successfully:
2018-01-22T18:33:49.321Z [agent.log] { "measureTime": "1516646028", "data": 7 }
2018-01-22T18:33:49.321Z [agent.log] Data published successfully:
2018-01-22T18:33:39.128Z [agent.log] { "measureTime": "1516646018", "data": 6 }
IMPT COMMAND SUCCEEDS

Press <Enter> to see more logs or <Ctrl-C> to exit.

2018-01-22T18:33:49.321Z [agent.log] Data published successfully:
2018-01-22T18:33:39.128Z [agent.log] { "measureTime": "1516646018", "data": 6 }
2018-01-22T18:33:39.128Z [agent.log] Data published successfully:
2018-01-22T18:33:28.790Z [agent.log] { "measureTime": "1516646008", "data": 5 }
2018-01-22T18:33:28.790Z [agent.log] Data published successfully:
IMPT COMMAND SUCCEEDS

Press <Enter> to see more logs or <Ctrl-C> to exit.
IMPT COMMAND SUCCEEDS

Real-time Logs

The impCentral API can stream log entries from device(s) in real time.

Devices may be added to a limited number of log streams per account and there is a limit on the number of devices per stream. The both limits are controlled by the impCentral API, not by impt.

impt provides several commands which start displaying real-time logs:

  • The most universal command is impt log stream. You can specify several devices and/or Device Groups, and all of the devices are added to the new log stream, which is then started. If you do not specify any devices or Device Groups, all devices assigned to your Project’s Device Group are added to the log stream.
  • impt build run with the option --log adds all the devices of the Device Group, for which the new Deployment is created, to a new log stream, which is then started.
  • impt dg restart with the option --log adds all the devices of the rebooted Device Group to a new log stream, which is then started.
  • impt device restart --device <DEVICE_IDENTIFIER> with the option --log adds the specified device to a new log stream, which is then started.

If the total number of devices to be added to a log stream exceeds the per-stream limit, not all of them will be added. Check the command’s output to see which devices were added and which were not.

While the logs are being streamed, no other command can be called. To stop displaying the logs, press Ctrl-C.

Note, the log stream may be closed by the impCentral API: for example, when a new log stream is requested by the same account and that exceeds the per-account limit of opened streams.

If the logs streaming is stopped by an error (eg. due to a disconnection), impt tries to automatically reconnect and reestablish the stream. Note, even if the stream is restored, some log entries could be lost and not displayed.

Example

Logging is started for a device from the Project’s Device Group

> impt log stream
Log stream for Device(s) 234776801163a9ee is opened.
IMPT COMMAND SUCCEEDS

Press <Ctrl-C> to exit.
[234776801163a9ee] 2018-01-22T18:36:05.603Z [agent.log] Data published successfully:
[234776801163a9ee] 2018-01-22T18:36:05.603Z [agent.log] { "measureTime": "1516646165", "data": 3 }
[234776801163a9ee] 2018-01-22T18:36:15.683Z [agent.log] Data published successfully:
[234776801163a9ee] 2018-01-22T18:36:15.683Z [agent.log] { "measureTime": "1516646175", "data": 4 }
[234776801163a9ee] 2018-01-22T18:36:26.308Z [agent.log] Data published successfully:
[234776801163a9ee] 2018-01-22T18:36:26.308Z [agent.log] { "measureTime": "1516646185", "data": 5 }
IMPT COMMAND SUCCEEDS

Project Information

You can get the status of your Project configuration — the referenced Device Group, its Product, the linked source files, etc. — with impt project info. The option --full provides you even more details: for example, information about devices added to your Project, the login status of the Project directory (as per impt auth info).

Use impt product info with the option --full to review the full structure of the Product related by your Project.

Example

> impt project info --full
Project info:
Device file:  device.nut
Agent file:   agent.nut
Device Group:
  id:                       27f8ee81-59cd-a9ad-d2a4-e430e4e19ae9
  type:                     development
  name:                     MyDG
  description:              New description of my DG
  region:
  created_at:               2018-01-22T18:20:28.399Z
  updated_at:               2018-01-22T18:35:42.521Z
  Product:
    id:   da0800ab-ad5f-c54e-949e-ec986efb0bf1
    name: MyProduct
  Current Deployment:
    id:      8b59afb0-32c6-1221-fdf8-fc5bf38ed155
    sha:     f4756c7578aa69910a8857d8ec08ff15bc2d7e1a8fc8007caf98e3ea9fca07a3
    tags:    TAG1
    flagged: true
  Min supported Deployment:
    id:  e3461b2c-75ae-a3b7-7164-f31ec495030b
    sha: 4e7f3395e86658ab39a178f9fe4b8cd8244a8ade92cb5ae1bb2d758434174c05
  Devices:
    Device:
      id:            234776801163a9ee
      name:          myDevice1
      mac_address:   0c:2a:69:05:0d:62
      agent_id:      T1oUmIZ3At_N
      device_online: true
Auth info:
impCentral API endpoint:   https://api.electricimp.com/v5
Auth file:                 Global
Access token auto refresh: true
Login method:              User/Password
Username:                  username
Email:                     [email protected]
Account id:                c1d61eef-d544-4d09-c8dc-d43e6742cae3
IMPT COMMAND SUCCEEDS

Sharing Projects

Your Project can be easily shared, copied or moved: just copy the whole directory containing the Project file and the linked source files, and continue using impt from the directory at its new location.

Note: the Project directory may also include a local auth file, which you may not wish to share.

On the contrary, if you do want to share or copy the authentication information along with your Project but the directory does not include a local auth file (ie. you use global login), call impt auth login with the option --local and with the same credentials and endpoint as you used for global login. A local auth file will be created and you will be able to copy it alongside the other Project files.

Deleting a Project

There are several levels of Project deletion:

  • impt project delete without additional options deletes the Project file only, ie. it simply removes the link between the Device Group and the source files. The same effect occurs when you create a new Project in the same directory to overwrite the previous Project file.
  • impt project delete with the option --files will also delete the linked source files. This is equivalent to manually deleting the Project directory.
  • impt project delete with the option --entities will also delete the related impCentral API entities. See the command’s spec for more details. Use this option when, for example, you want to clean all the entities after working on a temporary test project.

Note: impt project delete never deletes the local auth file, if it exists in the Project directory. Use impt auth logout --local to delete the local auth file, or remove it manually.

Example

Delete everything

> impt project delete --all
The following entities will be deleted:
Device Group:
  id:   27f8ee81-59cd-a9ad-d2a4-e430e4e19ae9
  type: development
  name: MyDG
Deployment:
  id:      8b59afb0-32c6-1221-fdf8-fc5bf38ed155
  sha:     f4756c7578aa69910a8857d8ec08ff15bc2d7e1a8fc8007caf98e3ea9fca07a3
  tags:    TAG1
  flagged: true
Deployment:
  id:  020c6bdf-54fb-9927-8113-b1a5d0b959fc
  sha: f4756c7578aa69910a8857d8ec08ff15bc2d7e1a8fc8007caf98e3ea9fca07a3
Deployment:
  id:  19c28f78-9ab1-6ba5-25c1-5330f181c24a
  sha: 4e7f3395e86658ab39a178f9fe4b8cd8244a8ade92cb5ae1bb2d758434174c05

The following Devices will be unassigned from Device Groups:
Device:
  id:            234776801163a9ee
  name:          myDevice1
  mac_address:   0c:2a:69:05:0d:62
  agent_id:      T1oUmIZ3At_N
  device_online: true

The following Deployments are marked "flagged" to prevent deleting. They will be modified
by setting "flagged" attribute to false:
Deployment:
  id:      8b59afb0-32c6-1221-fdf8-fc5bf38ed155
  sha:     f4756c7578aa69910a8857d8ec08ff15bc2d7e1a8fc8007caf98e3ea9fca07a3
  tags:    TAG1
  flagged: true

The following files will be deleted:
Device/agent source files: device.nut, agent.nut

Project File in the current directory will be deleted.
Are you sure you want to continue?
Enter 'y' (yes) or 'n' (no): y

Device "234776801163a9ee" is unassigned successfully.
Deployment "8b59afb0-32c6-1221-fdf8-fc5bf38ed155" is updated successfully.
Device Group "27f8ee81-59cd-a9ad-d2a4-e430e4e19ae9" is deleted successfully.
Deployment "19c28f78-9ab1-6ba5-25c1-5330f181c24a" is deleted successfully.
Deployment "8b59afb0-32c6-1221-fdf8-fc5bf38ed155" is deleted successfully.
Deployment "020c6bdf-54fb-9927-8113-b1a5d0b959fc" is deleted successfully.
Device/agent source files "device.nut", "agent.nut" are deleted successfully.
Project is deleted successfully.
IMPT COMMAND SUCCEEDS

Typical Use-cases

Develop Application Firmware

  1. Log in to the impCentral API using global login (ie. the global auth file)
> impt auth login --user username --pwd password
Global login is successful.
IMPT COMMAND SUCCEEDS
  1. Create a new directory called, for example, dev.
> mkdir dev
  1. Go to the new directory.
> cd dev
  1. Create a Project based on a new Product “MyProduct”, a new Device Group “MyDevDG”, empty files myapp.device.nut and myapp.agent.nut, and a Project file.
> impt project create --product MyProduct --create-product --name MyDevDG
    --descr "imp Application Firmware" --device-file myapp.device.nut --agent-file myapp.agent.nut
Product "MyProduct" is created successfully.
Device Group "MyDevDG" is created successfully.
Device source file "myapp.device.nut" is created successfully.
Agent source file "myapp.agent.nut" is created successfully.
Project is created successfully.
Project info:
Device file:  myapp.device.nut
Agent file:   myapp.agent.nut
Device Group:
  id:          c675ad8a-9d88-1d0f-e017-4a8c71bb0fd5
  type:        development
  name:        MyDevDG
  description: imp Application Firmware
  region:
  created_at:  2018-01-22T17:56:27.973Z
  updated_at:  2018-01-22T17:56:27.973Z
  Product:
    id:   da0800ab-ad5f-c54e-949e-ec986efb0bf1
    name: MyProduct
IMPT COMMAND SUCCEEDS

  1. Add your Squirrel code to your two source files.

  2. Add a development device to your Electric Imp account using the Electric Imp mobile app.

  3. List your unassigned devices to find the new device.

> impt device list --unassigned
Device list (2 items):
Device:
  id:            234776801163a9ee
  name:          myDevice1
  mac_address:   0c:2a:69:05:0d:62
  device_online: true
Device:
  id:            23522f6938a609ee
  name:          myDevice2
  mac_address:   0c:2a:69:03:ea:f0
  device_online: true
IMPT COMMAND SUCCEEDS
  1. Add the device to your Project. You can specify the device by its ID, name, MAC or agent ID.
> impt device assign --device myDevice1
Device "myDevice1" is assigned successfully to Device Group "c675ad8a-9d88-1d0f-e017-4a8c71bb0fd5".
IMPT COMMAND SUCCEEDS
  1. Create a new build, run it and start logging.
> impt build run --log
Deployment "e0059ee6-2483-4ab1-50eb-e693e62155b7" is created successfully.
Restart request for Devices assigned to Device Group "c675ad8a-9d88-1d0f-e017-4a8c71bb0fd5" is successful:
Device:
  id:            234776801163a9ee
  name:          myDevice1
  mac_address:   0c:2a:69:05:0d:62
  agent_id:      T1oUmIZ3At_N
  device_online: true
Deployment "e0059ee6-2483-4ab1-50eb-e693e62155b7" is run successfully.
Log stream for Device(s) 234776801163a9ee is opened.
IMPT COMMAND SUCCEEDS

Press <Ctrl-C> to exit.
[234776801163a9ee] 2018-01-22T18:11:33.975Z [agent.log] Data published successfully:
[234776801163a9ee] 2018-01-22T18:11:33.976Z [agent.log] { "measureTime": "1516644693", "data": 1 }
[234776801163a9ee] 2018-01-22T18:11:43.971Z [agent.log] Data published successfully:
[234776801163a9ee] 2018-01-22T18:11:43.971Z [agent.log] { "measureTime": "1516644703", "data": 2 }
[234776801163a9ee] 2018-01-22T18:11:54.329Z [agent.log] Data published successfully:
[234776801163a9ee] 2018-01-22T18:11:54.329Z [agent.log] { "measureTime": "1516644713", "data": 3 }

  1. Review how your application is working.

  2. Stop the logging by pressing Ctrl-C.

  3. If needed, update your code, create and run a new build by using the command listed in Step 9.

  4. When you are satisfied with your code, mark the latest build by a tag — for example, "MyRC1" — and set the flagged attribute to true (this protects it from accidental deletion).

> impt build update --descr "My Release Candidate 1" --tag MyRC1 --flagged
Deployment "e0059ee6-2483-4ab1-50eb-e693e62155b7" is updated successfully.
IMPT COMMAND SUCCEEDS

Develop Factory Firmware

Note: you need to have appropriate permission to make use of the impCentral API entities related to pre-production processes.

The following assumes you are making use of the Product created in the use-case above.

  1. Create a new directory called, for example, factory.

  2. Go to the new directory.

  3. Create a Project for factory firmware which is linked to the existing Product "MyProduct"; create new Device Groups "MyPreFactoryDG" and "MyPreProductionDG" in that Product, and empty files factory.device.nut and factory.agent.nut, and a Project file.

> impt project create --pre-factory --product MyProduct --name MyPreFactoryDG 
    --descr "Factory Firmware" --target MyPreProductionDG --create-target 
    --device-file factory.device.nut --agent-file factory.agent.nut
Device Group "MyPreProductionDG" is created successfully.
Device Group "MyPreFactoryDG" is created successfully.
Device source file "factory.device.nut" is created successfully.
Agent source file "factory.agent.nut" is created successfully.
Project is created successfully.
Project info:
Device file:  factory.device.nut
Agent file:   factory.agent.nut
Device Group:
  id:                71c3be05-a7d2-a326-8906-8af3b205bd13
  type:              pre-factory
  name:              MyPreFactoryDG
  description:       Factory Firmware
  region:
  created_at:        2018-01-22T18:17:19.537Z
  updated_at:        2018-01-22T18:17:19.537Z
  Product:
    id:   da0800ab-ad5f-c54e-949e-ec986efb0bf1
    name: MyProduct
  Production Target:
    id:   53ca29f4-937d-e684-729b-7e6b6a192c19
    type: pre-production
    name: MyPreProductionDG
IMPT COMMAND SUCCEEDS
  1. Copy your application’s build tagged as “MyRC1” to the “MyPreProductionDG” Device Group. “MyRC1” contains the code for devices blessed by your factory firmware. Build attributes are not copied.
> impt build copy --build MyRC1 --dg MyPreProductionDG
Deployment "a0e8e599-c6c5-62c0-2a88-a8d4ac3e07d8" is created successfully.
Deployment "MyRC1" is copied successfully to Deployment "a0e8e599-c6c5-62c0-2a88-a8d4ac3e07d8".
IMPT COMMAND SUCCEEDS

  1. Write your factory firmware using the Project’s source code files.

  2. Add your test factory BlinkUp fixture to your Electric Imp account as if it were a development device.

  3. List all of your unassigned devices and find the test fixture.

> impt device list --unassigned
Device list (2 items):
Device:
  id:            23522f6938a609ee
  name:          myDevice2
  mac_address:   0c:2a:69:03:ea:f0
  device_online: true
Device:
  id:            5000d8c46a56cfca
  name:          fieldbus
  mac_address:   d8:c4:6a:56:cf:ca
  device_online: true
IMPT COMMAND SUCCEEDS
  1. Add the test fixture to your project. You can specify the device by its ID, Name, MAC or agent ID.
> impt device assign --device 5000d8c46a56cfca
Device "5000d8c46a56cfca" is assigned successfully to Device Group "71c3be05-a7d2-a326-8906-8af3b205bd13".
IMPT COMMAND SUCCEEDS
  1. Create a new factory firmware build, run it and start logging.
> impt build run --log
Deployment "4a7339e4-1f7c-3caa-2ce5-15c367df9a3f" is created successfully.
Restart request for Devices assigned to Device Group "71c3be05-a7d2-a326-8906-8af3b205bd13" is successful:
Device:
  id:            5000d8c46a56cfca
  name:          fieldbus
  mac_address:   d8:c4:6a:56:cf:ca
  agent_id:      mRu9cePbSCJY
  device_online: true
Deployment "4a7339e4-1f7c-3caa-2ce5-15c367df9a3f" is run successfully.
Log stream for Device(s) 5000d8c46a56cfca is opened.
IMPT COMMAND SUCCEEDS

Press <Ctrl-C> to exit.

  1. Use the fixture to configure test DUTs. They will connect, and download and run the factory firmware which will test and bless them.

  2. Stop the logging by pressing Ctrl-C.

  3. If needed, update your factory firmware code, and create and run a new build by using the command listed in Step 9.

  4. When you are satisfied with your factory firmware, mark the latest build by a tag, eg. “MyFactoryRC1”, and set its flagged attribute to true (this protects it from accidental deletion).

> impt build update --descr "My Factory Firmware Release Candidate 1" --tag MyFactoryRC1 --flagged
Deployment "4a7339e4-1f7c-3caa-2ce5-15c367df9a3f" is updated successfully.
IMPT COMMAND SUCCEEDS

Clean-up

Go To Production

If you are developing production firmware, whether application, factory or both, you may want to keep the impCentral API entities your created, especially the final builds, but still do some minimal clean-up after your development activities are complete.

  1. Go to the factory directory.

  2. Delete all unnecessary builds of your factory firmware code (flagged builds will not be deleted).

> impt dg builds --remove
The following entities will be deleted:
Deployment:
  id:  a704f4c4-c14b-16ac-ad62-15ef304e37c1
  sha: 610c70b664914e84c539fad3c715e63e93bc2323c4c4b51ae39dc9e0513e7099
Deployment:
  id:  280618fc-9cf1-898f-dfec-a574f60c31df
  sha: 610c70b664914e84c539fad3c715e63e93bc2323c4c4b51ae39dc9e0513e7099

Are you sure you want to continue?
Enter 'y' (yes) or 'n' (no): y

Deployment "280618fc-9cf1-898f-dfec-a574f60c31df" is deleted successfully.
Deployment "a704f4c4-c14b-16ac-ad62-15ef304e37c1" is deleted successfully.
Deployment list (2 items):
Deployment:
  id:           4a7339e4-1f7c-3caa-2ce5-15c367df9a3f
  sha:          f6f710ce359d1e1bee10b17f62184a8f2a9884d17dd44292b0e9dc640c52daf6
  tags:         MyFactoryRC1
  flagged:      true
  Device Group:
    id:   71c3be05-a7d2-a326-8906-8af3b205bd13
    type: pre-factory
    name: MyPreFactoryDG
Deployment:
  id:           5dbfc968-5c94-fc4c-dd37-424f779b7e40
  sha:          a6d7bd78d62d74b6da74f538dc6c56f8d0f2fcfb7f80383bb6fe4640a1bb7a11
  Device Group:
    id:   71c3be05-a7d2-a326-8906-8af3b205bd13
    type: pre-factory
    name: MyPreFactoryDG
IMPT COMMAND SUCCEEDS
  1. Unassign your pre-factory fixture device in order to reuse it in other Projects.
> impt dg unassign
The following Devices are unassigned successfully from Device Group "71c3be05-a7d2-a326-8906-8af3b205bd13":
Device:
  id:            5000d8c46a56cfca
  name:          fieldbus
  mac_address:   d8:c4:6a:56:cf:ca
  agent_id:      mRu9cePbSCJY
  device_online: true
IMPT COMMAND SUCCEEDS
  1. Unassign your test-blessed devices in order to reuse them in other Projects.
> impt dg unassign --dg MyPreProductionDG
The following Devices are unassigned successfully from Device Group "MyPreProductionDG":
Device:
  id:          235d9e7838a609ee
  mac_address: 0c:2a:69:04:ff:85
  agent_id:    fo4Aq4po7wZa
IMPT COMMAND SUCCEEDS
  1. If you want, delete your factory firmware Project and the source files in this directory. The impCentral API entities will not be deleted; you may keep the source files in your version control or software configuration management tool.
> impt project delete --files
The following files will be deleted:
Device/agent source files: factory.device.nut, factory.agent.nut

Project File in the current directory will be deleted.
Are you sure you want to continue?
Enter 'y' (yes) or 'n' (no): y

Device/agent source files "factory.device.nut", "factory.agent.nut" are deleted successfully.
Project is deleted successfully.
IMPT COMMAND SUCCEEDS

  1. Go to the dev directory.

  2. Delete all unnecessary builds of your application firmware (flagged builds will not be deleted).

> impt dg builds --remove
The following entities will be deleted:
Deployment:
  id:  4c8a43e9-d3c4-3019-1219-456e30d972ac
  sha: a25ad53b9016dc301265d40685a3b52e756a36a51d5980f7ed2feb218876781d
Deployment:
  id:  3612cbab-8d69-4b2b-65da-6a65e40ebf4e
  sha: 0f379c6dd02bc29b3247bfad8a75bb20726769761c833210e747c7f782135d42
Deployment:
  id:  00e7645f-138f-f0d0-45bd-b7e9b79f0d3f
  sha: 1a65471e9ede213d5548677229ef594598451db83a5c2bccfd434da498e8e6f2
Deployment:
  id:  495c7420-e004-b29e-bb67-a4c1bea66f5b
  sha: 1a65471e9ede213d5548677229ef594598451db83a5c2bccfd434da498e8e6f2

Are you sure you want to continue?
Enter 'y' (yes) or 'n' (no): y

Deployment "00e7645f-138f-f0d0-45bd-b7e9b79f0d3f" is deleted successfully.
Deployment "4c8a43e9-d3c4-3019-1219-456e30d972ac" is deleted successfully.
Deployment "3612cbab-8d69-4b2b-65da-6a65e40ebf4e" is deleted successfully.
Deployment "495c7420-e004-b29e-bb67-a4c1bea66f5b" is deleted successfully.
Deployment list (4 items):
Deployment:
  id:           e0059ee6-2483-4ab1-50eb-e693e62155b7
  sha:          f4756c7578aa69910a8857d8ec08ff15bc2d7e1a8fc8007caf98e3ea9fca07a3
  tags:         MyRC1
  flagged:      true
  Device Group:
    id:   c675ad8a-9d88-1d0f-e017-4a8c71bb0fd5
    type: development
    name: MyDevDG
Deployment:
  id:           429c3a4c-947b-3d84-77f8-fa15cf3038b5
  sha:          f4756c7578aa69910a8857d8ec08ff15bc2d7e1a8fc8007caf98e3ea9fca07a3
  Device Group:
    id:   c675ad8a-9d88-1d0f-e017-4a8c71bb0fd5
    type: development
    name: MyDevDG
IMPT COMMAND SUCCEEDS
  1. Unassign the development device which you used for application testing.
> impt dg unassign
The following Devices are unassigned successfully from Device Group "c675ad8a-9d88-1d0f-e017-4a8c71bb0fd5":
Device:
  id:            234776801163a9ee
  name:          myDevice1
  mac_address:   0c:2a:69:05:0d:62
  agent_id:      T1oUmIZ3At_N
  device_online: true
IMPT COMMAND SUCCEEDS
  1. Display and review the full structure of your Product.
> impt product info --full
Product:
  id:            da0800ab-ad5f-c54e-949e-ec986efb0bf1
  name:          MyProduct
  description:
  created_at:    2018-01-22T17:56:27.298Z
  updated_at:    2018-01-22T17:56:27.298Z
  Device Groups:
    Device Group:
      id:                       c675ad8a-9d88-1d0f-e017-4a8c71bb0fd5
      type:                     development
      name:                     MyDevDG
      Current Deployment:
        id:      e0059ee6-2483-4ab1-50eb-e693e62155b7
        sha:     f4756c7578aa69910a8857d8ec08ff15bc2d7e1a8fc8007caf98e3ea9fca07a3
        tags:    MyRC1
        flagged: true
      Min supported Deployment:
        id:  429c3a4c-947b-3d84-77f8-fa15cf3038b5
        sha: f4756c7578aa69910a8857d8ec08ff15bc2d7e1a8fc8007caf98e3ea9fca07a3
    Device Group:
      id:                       71c3be05-a7d2-a326-8906-8af3b205bd13
      type:                     pre-factory
      name:                     MyPreFactoryDG
      Current Deployment:
        id:      4a7339e4-1f7c-3caa-2ce5-15c367df9a3f
        sha:     f6f710ce359d1e1bee10b17f62184a8f2a9884d17dd44292b0e9dc640c52daf6
        tags:    MyFactoryRC1
        flagged: true
      Min supported Deployment:
        id:  5dbfc968-5c94-fc4c-dd37-424f779b7e40
        sha: a6d7bd78d62d74b6da74f538dc6c56f8d0f2fcfb7f80383bb6fe4640a1bb7a11
      Production Target:
        id:   53ca29f4-937d-e684-729b-7e6b6a192c19
        type: pre-production
        name: MyPreProductionDG
    Device Group:
      id:                       53ca29f4-937d-e684-729b-7e6b6a192c19
      type:                     pre-production
      name:                     MyPreProductionDG
      Current Deployment:
        id:  a0e8e599-c6c5-62c0-2a88-a8d4ac3e07d8
        sha: f4756c7578aa69910a8857d8ec08ff15bc2d7e1a8fc8007caf98e3ea9fca07a3
      Min supported Deployment:
        id:  a0e8e599-c6c5-62c0-2a88-a8d4ac3e07d8
        sha: f4756c7578aa69910a8857d8ec08ff15bc2d7e1a8fc8007caf98e3ea9fca07a3
      Production Target for:
        Device Group:
          id:   71c3be05-a7d2-a326-8906-8af3b205bd13
          type: pre-factory
          name: MyPreFactoryDG
IMPT COMMAND SUCCEEDS
  1. If you want, delete your application Project and the source files in this directory. The impCentral API entities will not be deleted; you may keep the source files in your version control or software configuration management tool.
> impt project delete --files
The following files will be deleted:
Device/agent source files: myapp.device.nut, myapp.agent.nut

Project File in the current directory will be deleted.
Are you sure you want to continue?
Enter 'y' (yes) or 'n' (no): y

Device/agent source files "myapp.device.nut", "myapp.agent.nut" are deleted successfully.
Project is deleted successfully.
IMPT COMMAND SUCCEEDS

  1. If you want, delete the dev and factory directories.

  2. If you want, log out from the impCentral API.

> impt auth logout
Global logout is successful.
IMPT COMMAND SUCCEEDS

The impt usage for factory and production processes is described fully in the impt Production Guide.

Full Clean-up

If your development work was temporary, you may want to remove all of your development activities, including all of the impCentral API entities you created.

  1. Go to the factory directory.

  2. Delete your factory firmware Project, the source files and all impCentral API entities. The “MyPreFactoryDG” and “MyPreProductionDG” Device Groups and all their builds (including flagged ones) will be deleted, and the devices will be unassigned from them. The “MyProduct” Product will not be deleted as you still have another Project (ie. a Device Group) related to it.

> impt project delete --all
The following entities will be deleted:
Device Group:
  id:   53ca29f4-937d-e684-729b-7e6b6a192c19
  type: pre-production
  name: MyPreProductionDG
Device Group:
  id:   71c3be05-a7d2-a326-8906-8af3b205bd13
  type: pre-factory
  name: MyPreFactoryDG
Deployment:
  id:  a0e8e599-c6c5-62c0-2a88-a8d4ac3e07d8
  sha: f4756c7578aa69910a8857d8ec08ff15bc2d7e1a8fc8007caf98e3ea9fca07a3
Deployment:
  id:      4a7339e4-1f7c-3caa-2ce5-15c367df9a3f
  sha:     f6f710ce359d1e1bee10b17f62184a8f2a9884d17dd44292b0e9dc640c52daf6
  tags:    MyFactoryRC1
  flagged: true
Deployment:
  id:  5dbfc968-5c94-fc4c-dd37-424f779b7e40
  sha: a6d7bd78d62d74b6da74f538dc6c56f8d0f2fcfb7f80383bb6fe4640a1bb7a11

The following Devices will be unassigned from Device Groups:
Device:
  id:            5000d8c46a56cfca
  name:          fieldbus
  mac_address:   d8:c4:6a:56:cf:ca
  agent_id:      mRu9cePbSCJY
  device_online: true

The following Deployments are marked "flagged" to prevent deleting. They will be modified
by setting "flagged" attribute to false:
Deployment:
  id:      4a7339e4-1f7c-3caa-2ce5-15c367df9a3f
  sha:     f6f710ce359d1e1bee10b17f62184a8f2a9884d17dd44292b0e9dc640c52daf6
  tags:    MyFactoryRC1
  flagged: true

The following files will be deleted:
Device/agent source files: factory.device.nut, factory.agent.nut

Project File in the current directory will be deleted.
Are you sure you want to continue?
Enter 'y' (yes) or 'n' (no): y

Device "5000d8c46a56cfca" is unassigned successfully.
Deployment "4a7339e4-1f7c-3caa-2ce5-15c367df9a3f" is updated successfully.
Device Group "71c3be05-a7d2-a326-8906-8af3b205bd13" is deleted successfully.
Device Group "53ca29f4-937d-e684-729b-7e6b6a192c19" is deleted successfully.
Deployment "5dbfc968-5c94-fc4c-dd37-424f779b7e40" is deleted successfully.
Deployment "4a7339e4-1f7c-3caa-2ce5-15c367df9a3f" is deleted successfully.
Deployment "a0e8e599-c6c5-62c0-2a88-a8d4ac3e07d8" is deleted successfully.
Device/agent source files "factory.device.nut", "factory.agent.nut" are deleted successfully.
Project is deleted successfully.
IMPT COMMAND SUCCEEDS

  1. Go to the dev directory.

  2. Delete your application Project, the source files and all impCentral API entities. The “MyDevDG” Device Group and all its builds (including flagged ones) will be deleted, and its devices will be unassigned from it. The “MyProduct” Product will be deleted.

> impt project delete --all
The following entities will be deleted:
Product:
  id:   da0800ab-ad5f-c54e-949e-ec986efb0bf1
  name: MyProduct
Device Group:
  id:   c675ad8a-9d88-1d0f-e017-4a8c71bb0fd5
  type: development
  name: MyDevDG
Deployment:
  id:      e0059ee6-2483-4ab1-50eb-e693e62155b7
  sha:     f4756c7578aa69910a8857d8ec08ff15bc2d7e1a8fc8007caf98e3ea9fca07a3
  tags:    MyRC1
  flagged: true
Deployment:
  id:  429c3a4c-947b-3d84-77f8-fa15cf3038b5
  sha: f4756c7578aa69910a8857d8ec08ff15bc2d7e1a8fc8007caf98e3ea9fca07a3

The following Devices will be unassigned from Device Groups:
Device:
  id:            234776801163a9ee
  name:          myDevice1
  mac_address:   0c:2a:69:05:0d:62
  agent_id:      T1oUmIZ3At_N
  device_online: true

The following Deployments are marked "flagged" to prevent deleting. They will be modified
by setting "flagged" attribute to false:
Deployment:
  id:      e0059ee6-2483-4ab1-50eb-e693e62155b7
  sha:     f4756c7578aa69910a8857d8ec08ff15bc2d7e1a8fc8007caf98e3ea9fca07a3
  tags:    MyRC1
  flagged: true

The following files will be deleted:
Device/agent source files: myapp.device.nut, myapp.agent.nut

Project File in the current directory will be deleted.
Are you sure you want to continue?
Enter 'y' (yes) or 'n' (no): y

Device "234776801163a9ee" is unassigned successfully.
Deployment "e0059ee6-2483-4ab1-50eb-e693e62155b7" is updated successfully.
Device Group "c675ad8a-9d88-1d0f-e017-4a8c71bb0fd5" is deleted successfully.
Product "da0800ab-ad5f-c54e-949e-ec986efb0bf1" is deleted successfully.
Deployment "e0059ee6-2483-4ab1-50eb-e693e62155b7" is deleted successfully.
Deployment "429c3a4c-947b-3d84-77f8-fa15cf3038b5" is deleted successfully.
Device/agent source files "myapp.device.nut", "myapp.agent.nut" are deleted successfully.
Project is deleted successfully.
IMPT COMMAND SUCCEEDS

  1. If you want, delete the dev and factory directories.

  2. If you want, log out from impCentral API.

> impt auth logout
Global logout is successful.
IMPT COMMAND SUCCEEDS