Connect your first device

You can get going quickly with EdgeIQ by performing a few simple tasks:

• Get your first device online
• Issue your first software update
• How to transfer a device or escrow
• Configure device logging and pull logs
• Configure your first sensor data ingestor and policies
• Configure an alert policy

Learn how to do these tasks in the sections below.

First, you’ll need to add a device type. Then, you add a device that corresponds to this type. In our example here, we will enter a Raspberry Pi as a gateway device type.

Add a device type

Follow these steps to enter a device type:

Step 1 — In the menu, navigate to Devices > Device Profiles.
Step 2 — Click the small + Create New Profile button at the top of the page.

<block:image>
{
"images": [
{
"image": [
"https://files.readme.io/c2deeb6-Screenshot_2024-08-02_at_18.48.27.png",
"",
""
],
"align": "center",
"sizing": "75%"
"border": true
}
]
}
</block:image>

Step 3 — In the popup window, enter a Name, Manufacturer, and Model.
Step 4 — From the Type drop-down, choose a Type. The default, Gateway is suitable for all devices using the EdgeIQ Coda local agent, choose Gateway for this example.

<block:image>
{
"images": [
{
"image": [
"https://files.readme.io/e4a363e-Screenshot_2024-08-02_at_18.57.00.png",
"",
""
],
"align": "center",
"sizing": "75%"
"border": true
}
]
}
</block:image>

Step 5 — Use the toggle buttons to enable or disable support for firmware upgrades and/or IP tables network configuration.
Step 6 — Click the Create button to add a device profile. If you wish to assign the Type to a different company, select it from the dropdown by clicking the preselected company name. You can type to search for companies. The company selection defaults to your user's company.

<block:image>
{
"images": [
{
"image": [
"https://files.readme.io/8360cfc-Screenshot_2024-08-02_at_18.49.30.png",
"",
""
],
"align": "center",
"sizing": "75%"
"border": true
}
]
}
</block:image>

Step 7 — The new device profile will appear on the Device Profile page.

<block:image>
{
"images": [
{
"image": [
"https://files.readme.io/af6d1c0-Screenshot_2024-08-02_at_18.59.28.png",
"",
""
],
"align": "center",
"sizing": "75%"
"border": true
}
]
}
</block:image>

Add a device

Follow the steps below to add a device of the Raspberry Pi 5 type:

Step 1 — In the menu, navigate to Devices > All Devices.
Step 2 — To add a new device, click the small + button.

<block:image>
{
"images": [
{
"image": [
"https://files.readme.io/bf639d6-Screenshot_2024-08-02_at_19.26.41.png",
"",
""
],
"align": "center",
"sizing": "75%"
"border": true
}
]
}
</block:image>

Step 3 — Enter a device Name.
Step 4 — Enter a Unique ID.

Step 5 — Optionally, enter a serial number.
Step 6 — Select the previously created device profile (Raspberry Pi 5) from the dropdown menu.
Step 7 — Optional: EdgeIQ Coda clients have a default password set that is used for the first connection. For additional security, you can choose to set a password. The recommended and highest level of security is offered through certificate-based authentication.
We will use username-password authentication with the default password in this guide.
Step 8 — Optional: Under the Configuration section, additional parameters can be set, for example, the heartbeat frequency and the reported data, or additional integrations and policies associated with this device.

<block:image>
{
"images": [
{
"image": [
"https://files.readme.io/b32ba9e-Screenshot_2024-08-02_at_19.43.38.png",
"",
""
],
"align": "center",
"sizing": "75%"
"border": true
}
]
}
</block:image>

📘

Heartbeat Frequency

By default, the heartbeat frequency is set to 0, so the device is not sending heartbeats to reduce data consumption.

A good default for heartbeat frequency is 1 hour, but it is configurable in any interval (seconds, minutes, hours, days).

Step 9 — Keep the default company or select a company in the Publish sidebar. Click Create to create the device.

You should be redirected to the All Devices page where you will see your newly created device.

<block:image>
{
"images": [
{
"image": [
"https://files.readme.io/20dbcb9-Screenshot_2024-08-02_at_19.44.14.png",
"",
""
],
"align": "center",
"sizing": "75%"
"border": true
}
]
}
</block:image>

Now that you've seen an overview of how to create a gateway device, you can see the complete process in Onboard your first device.

If you prefer, you can learn how to Install the Edge Local Service.