n8n-nodes-evolviot

Community node for n8n that triggers EvolvIOT device control actions through the EvolvIOT REST API.

Installation

1. Build the package:

   npm install
   npm run build

2. In your n8n instance, install the generated .tgz or point to the folder:

   npm install /path/to/n8n-nodes-evolviot

3. Restart n8n so the node and credential types are registered.

Credentials

Add an EvolvIOT API credential with:

• API Key: Key provided by EvolvIOT.
• Base URL (optional): Override if you use a regional or on-prem endpoint.

Node Usage

EvolvIOT (Action Node)

1. Drag the EvolvIOT node into your workflow.
2. Select your EvolvIOT API credential.
3. Configure the properties:
   • Base URL: Defaults to https://api.evolviot.com.
   • Device ID: Target device identifier.
   • Control Key: Loaded dynamically from /api/n8nDeviceControl/{deviceId}/controlKeys.
   • Action Type: For binary keys, choose On or Off (mapped to the key's onVal/offVal).
   • Value: For PWM keys, provide the numeric value to send.
4. Execute the workflow. The node sends a control request with { "controlKey": "...", "value": ... }.

EvolvIOT Trigger (Polling Trigger)

Use this node when you want workflow start events based on status conditions.

1. Drag the EvolvIOT Trigger node into your workflow.
2. Select your EvolvIOT API credential.
3. Configure:
   • Trigger On = Device Status: choose Device, then choose Device State (Online or Offline).
   • Trigger On = Device Key Status: choose Device, then Control Key, then Action Type (On or Off).
4. Activate the workflow. The trigger polls status endpoints and emits when the selected condition transitions to a matching state.

Development

• Build: npm run build
• Output artifacts land in dist/ and are referenced by package.json via the n8n block.

Publishing to npm

To publish this node so others can install it with Settings → Community nodes → Install from npm in n8n:

1. Prerequisites

   • npm account (create one at npmjs.com if needed).
   • Repository URL in package.json set to your real repo (e.g. "url": "git+https://github.com/your-org/n8n-evolviot.git").

2. Build

   npm install
   npm run build

3. Test the package locally (optional)

   npm pack

   This creates n8n-nodes-evolviot-0.1.0.tgz. In another folder with n8n (or a test app), run:

   npm install /path/to/n8n-evolviot/n8n-nodes-evolviot-0.1.0.tgz

   Restart n8n and confirm the EvolvIOT nodes appear and work.

4. Log in to npm (once per machine)

   npm login

   Enter your npm username, password, and email (or use a token).

5. Publish

   npm publish

   For scoped packages (e.g. @your-org/n8n-nodes-evolviot), use:

   npm publish --access public

6. After publishing

   • Users can install in n8n: Settings → Community nodes → Install from npm and enter n8n-nodes-evolviot.
   • To list the node in the n8n integrations directory, follow the instructions on the n8n site for submitting community nodes.

Version updates: Bump version in package.json, then run npm run build and npm publish again.

Notes

• The node uses bearer authentication with the supplied API key.
• Errors are surfaced with the item index so you can identify failing rows in a batch.