neqto: Docs
  • Languages iconEnglish
    • 日本語
  • Docs
  • Region API
  • Global API
  • FAQ

›neqto: Console

Getting Started

  • neqto: Hello World!
  • Step 1. Cloud Setting
  • Step 2. Device Setting & Start Service

    • When using neqto: Bridge
    • When using Spresense
  • Step 3. Using Sensors

neqto:

  • neqto: Account Registration
  • API Usage
  • Batch Registration
  • Support Guidelines

neqto: Console

  • Introduction
  • Fundamentals
  • Administrative Actions
  • Device Management
  • Scripts
  • Actions and Contacts
  • neqto: Apps
  • Machine Driver
  • Recommended Browsers
  • Billing Information

SPRESENSE

    Hardware Specifications

    • 01. About Spresense

    Software Specifications

    • 01. Operational Flow
    • 02. Initial Installation
    • 03. Spresense Wi-Fi Initial Setup
    • 05. Debug Log Acquisition
    • 06. System LED Indications
    • 07. Event Messages
    • 08. Updating Firmware

    neqto.js

    • 01. About neqto.js
    • 02. Log
    • 03. Timers
    • 04. HTTP
    • 05. HTTPS
    • 06. MQTT
    • 07. Secure
    • 08. Storage
    • 10. RTC
    • 12. GPIO
    • 13. UART
    • 15. I2C
    • 17. Camera
    • 18. nqSpresense
    • 19. nqService
    • 20. nqMqtt
    • 21. nqFOTA
    • 22. nqWiFi

neqto: Bridge Series

    Hardware Specifications

    • 01. neqto: Bridge Module
    • 02. neqto: Bridge Wi-Fi Module
    • 03. neqto: Bridge LTE-1 Module
    • 04. neqto: Bridge LTE-M/NB Module
    • 05. neqto: Bridge IO Board
    • 06. neqto: Bridge IO Board Short Plug
    • 07. neqto: Bridge Digital IO Board
    • 08. neqto: Bridge Digital IO Board Short Plug

    Software Specifications

    • 01. Operational Flow
    • 02. neqto: Bridge Wi-Fi Module Initial Setup
    • 03. neqto: Bridge LTE Module Initial Setup
    • 04. Debug Log Acquisition
    • 05. System LED Indications
    • 06. Event Messages
    • 07. Updating Firmware

    neqto.js

    • 01. About neqto.js
    • 02. Log
    • 03. Timers
    • 04. HTTP
    • 05. HTTPS
    • 06. MQTT
    • 07. Secure
    • 08. Storage
    • 09. Sleep
    • 10. RTC
    • 11. UserSW
    • 12. GPIO
    • 13. UART
    • 14. SPI
    • 15. I2C
    • 16. ADC
    • 17. BLE
    • 18. nqBridge
    • 19. nqService
    • 20. nqMqtt
    • 21. nqFOTA
    • 22. nqWiFi
    • 23. nqLte
    • 24. nqLAN
    • 25. nqEx

neqto.js Libraries

    I2C

    • LIS2DW12 v2 Accelerometer
    • HTS221 v2 Temperature and Humidity Sensor
    • [Archive] LIS2DW12 Accelerometer
    • [Archive] HTS221 Temperature and Humidity Sensor

    Integration

    • AWS IoT Core v2 Library
    • AWS S3 v2 Library
    • Azure IoT v2 Library
    • GCP IoT Core Library
    • [Archive] AWS S3 Library
    • [Archive] AWS IoT Core Library

neqto.js Snippets

  • DataDog Snippet
  • Dropbox Snippet
  • Google Sheets Snippet
  • InfluxDB Snippet
  • Oracle Cloud Object Storage Snippet
  • Salesforce Snippet
  • SAP Cloud Platform Internet of Things Snippet
  • Splunk Snippet
  • Niagara Snippet

Release Notes

  • neqto: Cloud Updates
  • neqto: Firmware (Bridge Wi-Fi/LTE Module) Releases
  • neqto: Firmware (Spresense Wi-Fi) Releases

Device Management

Controlling & Managing Devices

neqto: Cloud allows customers to remotely control and manage IoT devices and deployments. Through neqto: Console's streamlined UI, from any computer, tablet, or smartphone's browsers users can access these cloud features and do things like see real-time data or send commands to their devices.

Managing Devices & Licenses

From the Console, you can control and manage what devices are linked to a license and usable in neqto:.

Licenses

All devices connected to neqto: Cloud require an appropriate license. To manage licenses, click on the user icon and select "Manage Licenses" in the drop-down menu.

The main menu, with Manage Licenses selected

Licenses contain the following user-input information.

ItemDescription
Device TypeChoose the supported device you wish to use the license with.
License Type (Required)Select the license type you would like to use for the device.

Add a License

  1. In the upper-right hand corner click the "Add License" button.
  2. Choose the appropriate device type and which license you would like to apply.
  3. Hit 'save'.
  • Unused licenses still incur cost- be sure to remove unused licenses.

Delete a License

  1. Next to the license, click the "X" icon to open the deletion confirmation dialogue.
  2. Enter in the license id of the license to confirm, then click the delete button.
  • If a license is being used by a device, the device must be removed before a license can be deleted.

Devices

To manage devices, click on the user icon and select "Manage devices" in the drop-down menu.

The main menu, with Manage Devices selected

Devices contain the following user-input information.

ItemDescription
NoteSince devices use alphanumeric ID's, set a note to help your organization identify and search for your device.
Device Type (Required)Select the type of neqto: device you are using.
License*Search using License ID and select the license you wish to link to the device.
* This field is only required when using an existing license.
License Type*Select the license type you would like to use for the device.
* This field is only required for when registering a new license with the device.
Serial ID*The serial ID associated with your neqto: Bridge.
* This field is only required for neqto: Bridge Device Type.
Product Key*The Product Key for your neqto: Bridge.
* This field is only required for neqto: Bridge Device Type.

Add a Device

To perform batch registration of devices, refer to Batch registration of devices on the Batch registration method page of nodes/devices.

  1. In the upper-right hand corner click the "Add Device" button.
  2. Write a note to help identify your device within your organization.
  3. Choose the appropriate device type and which license you would like to apply or create a new license and choose the license type.
  4. Hit 'save'.
QR Code Scanner (neqto: Bridge)

The supplementary QR Scanner feature is provided to add a device through the neqto: Console by scanning the QR Code of the device. The Serial ID and Product Key will be registered automatically upon a successful scan of the neqto: Bridge device.

Put QR code on the device in front of the camera to scan.

  • On iOS 11, QR scanner is only supported on Safari.
  • If scanning the QR code is difficult through webcam, consider using a mobile phone camera or an additional clip-type macro lens.

View a device's details

  1. At the Devices page, locate the device you wish to confirm in the list.
  2. Click the "Details" button.

The Device Manager screen, with the Devices filtered on note for the text "tutorial", and the Details of the resulting Device shown

  • Spresense devices can see their current challenge code or regenerate a new challenge code.
  • Remember to keep details like serial IDs and challenge codes a secret!

Edit or Delete a Device

  1. Go to the device list and reference the above picture.
  2. Click the pencil icon in the row of the device you wish to edit.
To Edit
  1. Change as desired.
  2. Hit "Save" to commit the changes or "X" to cancel this operation.
To delete
  1. In the lower-left corner of the dialogue click the "delete" button.
  2. Enter in the serial id of the device to confirm, then click the delete button.

Groups

"Groups" are exactly as the name suggests. It defines an organizational unit and grouping of resources in neqto: Cloud. Devices are registered to groups as nodes, along with firmware and other resources.

The following information is needed to add a group.

ItemDescription
Name (Required)Enter the name for the Group.
NoteAny description that may help your organization identify this group.
InfinitypoolCheck to opt-in to this optional service.
InsightsCheck to opt-in to this optional service.
CustodiaCheck to opt-in to this optional service.

Add a Group

  1. At the Groups page, click the "Add Group" button in the upper-right hand corner.
  2. Enter the necessary information.
  3. Click the "save" button.

Edit or Delete a Group

  1. Go to the Groups page.
  2. Click the pencil icon in the row of the Group you wish to edit.

To Edit

  1. Change as desired.
  2. Hit "Save" to commit the changes or "X" to cancel this operation.

To delete

  1. In the lower-left corner of the dialogue click the "delete" button.
  2. Enter in the name of the group to confirm, then click the delete button.
  • When editing a group, you may notice the "optional services" category. Optional services all you to opt-in to neqto: Apps. They are opt-out by default. The Edit Group screen, on the Optional Services tab.

Templates

Templates are virtual "models" of devices. They define physical hardware configurations and allow nodes of the same type of device to be easily created, updated, and operated on.

A Template defines the following aspects of a device:

FieldDetail
NameEnter a name.
Device TypeSelect device type.
Device FirmwareSelect device firmware. It is recommended to select the latest version.
Machine Driver PackageSet the Machine Driver Package. You can specify the firmware of instruments connected to the device.
ScriptSet the script and business logic to run on the device.
Environment VariablesEnter the Environment Variables for the template. See here for usage in scripts.
  • Components are instruments such as sensors or other MCUs that are connected to a neqto: Device. They are set on a per template basis.
  • Available device firmware changes based on the selected device type. Please confirm the correct device type before saving to prevent harm to devices.
  • The order of precedence for Environment Variables from highest to lowest is as follows: Nodes, Templates, Scripts.

Add a Template

  1. Go to the "Templates" resource page.
  2. In the upper right-hand corner, click the "Add Template" button.
  3. Enter in the details of your device.
  4. Click "save" at the bottom of the dialogue.

Edit or Delete a Template

  1. Go to the "Templates" resource page.
  2. Find the template you wish to edit or delete and click the gear icon.

To Edit

  1. Edit the necessary details.
  2. Click "save" at the bottom of the dialogue.

To Delete

  1. Click the "Delete" button in the left-hand bottom corner of the dialogue.
  2. Enter the templates name to confirm, then click the "Delete" button.

A single template card.

Trigger Commands on a Template

Via the "Control Center Menu" accessible from the list of Templates, you can quickly send commands to all nodes that belong to a template.

A single template card, with the menu for the commands visible.

The following commands are supported:

CommandDetail
Custom MessageSend a custom MQTT message to the device.
RebootReboot the device. Rebooting the device will also reload the script.
Reload ScriptDownload the newest version of the neqto.js script from the cloud and begin executing it.
neqto: Firmware UpdateExecutes FOTA on the actual neqto: device. The device firmware set in the template will be used. Only official neqto: Firmware can be used.
Machine Driver UpdateExecutes FOTA on connected sub-devices. Uses the Machine Driver set in the template. Customers can register their own firmwares to set as a Machine Driver. See Machine Driver for more information.
neqto: Firmware Update on BootOn the device's next boot, the firmware will be downloaded and FOTA will be triggered on the actual neqto: device. The device firmware set in the template will be used.
Machine Driver Update on BootOn the device's next boot, the firmware will be downloaded and FOTA will be triggered on the connected sub-devices. The Machine Driver set in the template will be used.

Components

Templates also contain components, which define the instruments connected to a device.

Components are defined using the LwM2M Standards.

When registering a component, the following options are available:

The following options apply to the Device Information tab:

FieldDetail
NameEnter a name.
NoteEnter a description.
ResourceSet a resource. (Type of data)
ObjectSet an object. (Type of sensor)
InstanceSet an instance number.(0-9999999999)
When a sensor (Object and Resource) are the same, change and set the instance number.
Privacy ModeUse this if sending personal information.

The below options apply to the Graph Settings tab (Infinitypool customers only):

FieldDetail
UnitSet the unit of data that will be sent.
MinimumSpecify lower limit to be displayed by graph.
MaximumSpecify upper limit to be displayed by graph.

To add a component

  1. Select the desired Template from the Templates list.
  2. On that template's dashboard, in the upper-right hand corner of the "Components" section, click "Add Component".
  3. Enter the correct settings.
  4. Click the "save" button at the bottom of the dialogue.

To edit or delete component

  1. From the list of components, click the pencil icon in the row of the component you wish to edit.
To Edit
  1. Edit the necessary details.
  2. Click "save" at the bottom of the dialogue.
To Delete
  1. Click the "Delete" button in the left-hand bottom corner of the dialogue.
  2. Enter the components name to confirm, then click the "Delete" button.

Event Notifications

Templates also contain Notifications that can be set when certain events related to a device occur.

To use notifications, you will need an Action.

Based on the event and the level, the action will be triggered.

When registering a notification the following options are available:

Event Type

TypeDetail
UserUser messages (From user script)
Engineneqto: Engine event messages
BatteryBattery status event messages
Custodianeqto: Custodia notification messages

Event Level

LevelDetail
infoDebug Information etc.
warnMinor error (Can continue operation)
errorMajor error (Cannot continue operation)
fatalFatal error

To add a Notification

  1. Select the desired Template from the Templates list.
  2. On that template's dashboard, in the upper-right hand corner of the "Notification" section, click "Add Notification".
  3. Enter the correct settings.
  4. Click the "save" button at the bottom of the dialogue.

To edit or delete a Notification

  1. From the list of Notifications, click the pencil icon in the row of the component you wish to edit.
To Edit
  1. Edit the necessary details.
  2. Click "save" at the bottom of the dialogue.
To Delete
  1. Click the "Delete" button in the left-hand bottom corner of the dialogue.
  2. Enter the Notification's name to confirm, then click the "Delete" button.
  • Actions triggered by an event also have access to the following dynamic information as variables.
VariableValue
{event_type}Event Type name
{event_level }Event Level
{event_message}Event Message

Nodes

Nodes represent your neqto: Engine device in the neqto: Cloud.

Nodes inherit many of their settings through Templates and other features.

Before registering a Node you will need 1 Template and at least 1 Device

FieldDetail
NameEnter a name.
NoteEnter a description.
TemplateSet a template.
Serial IDEnter the serial ID of the neqto: Bridge.
Environment VariablesEnter the Environment Variables for the node. See here for usage in scripts.
  • The order of precedence for Environment Variables from highest to lowest is as follows: Nodes, Templates, Scripts.

Add a Node

To perform batch registration of nodes, refer to Batch registration of nodes on the Batch registration method page of nodes/devices.

  1. Go to the "Nodes" resource page.
  2. In the upper right-hand corner, click the "Add Node" button.
  3. Enter in the details of your node.
  4. Click "save" at the bottom of the dialogue.

Edit or Delete a Node

  1. Go to the "Nodes" resource page.
  2. Find the node you wish to edit or delete and click the gear icon.

To edit

  1. Edit the necessary details.
  2. Click "save" at the bottom of the dialogue.

To Delete

  1. Click the "Delete" button in the left-hand bottom corner of the dialogue.
  2. Enter the Nodes name to confirm, then click the "Delete" button.

Trigger Commands on a Node

Via the "Control Center Menu" accessible from the list of Nodes, you can quickly trigger commands on a single node.

A single Node card, with the Commands menu visible.

The following commands are supported:

CommandDetail
Refresh Node StatusRequest device to update its current configuration information to the Node.
Reload ScriptDownload the newest version of the neqto.js script from the cloud and begin executing it.
Custom MessageSend a custom MQTT message to the device.
RebootReboot the device. Rebooting the device will also reload the script.
neqto: Firmware UpdateExecutes FOTA on the actual neqto: device. The device firmware set in the template will be used.
Machine Driver UpdateExecutes FOTA on the connected sub-devices. Uses the Machine Driver set in the template.
neqto: Firmware Update on BootOn the script's next boot (script download), execute FOTA on the neqto: device. The device firmware set in the template will be used.
Machine Driver Update on BootOn the script's next boot (script download), execute FOTA on the connected sub-devices. The Machine Driver set in the template will be used.
Get Debug LogUpload the logs stored on the device to the cloud. The uploaded logs will be displayed in the debug logs area of each node's page. Uploaded logs are stored for 30 days.
Renew Client CertificateReplace the device's client-side SSL certificate.
Factory ResetResets the device to its factory conditions. This will erase all changes made to the device, so remote operation will become impossible. The initial setup procedure must be repeated before it can be used again.

Check the MQTT status of a Node

Node MQTT Status

The MQTT Status icon can be found in the Node Status of a Node and on each Node in the Node list of a Group. The MQTT status of the Node can be determined by the color of the MQTT Status icon, or by hovering over the icon for more details.

IconStatusDetail
disconnectedThe device was disconnected normally from neqto: Cloud. Nodes with devices which have not yet connected to the neqto: Cloud also display this status.
connectedThe device is connected normally via MQTT to neqto: Cloud.
ungracefulThe device disconnected inadvertently from neqto: Cloud. For example, the power supply of the device may have depleted or a network malfunction occurred.

Updated: 2021-01-15
← Administrative ActionsScripts →
  • Managing Devices & Licenses
    • Licenses
    • Devices
  • Groups
    • Add a Group
    • Edit or Delete a Group
  • Templates
    • Add a Template
    • Edit or Delete a Template
    • Trigger Commands on a Template
    • Components
    • Event Notifications
  • Nodes
    • Add a Node
    • Edit or Delete a Node
    • Trigger Commands on a Node
    • Check the MQTT status of a Node
AboutNewsProductsFAQPrivacy Policy}
neqto: Cloud
IntroductionFundamentalsAdministrative ActionsDevice Management neqto: Apps
neqto: Bridge Series
neqto: Bridge Moduleneqto: Bridge Wi-Fi Moduleneqto: Bridge LTE-1 ModuleError Logging Event Messages
API Documentation
API UsageGlobal APIRegional APIAPI Terms of Service
Jigsaw, Inc.
© 2021 JIG-SAW INC.