node-red-contrib-garmin-empirbus 1.0.0

package/.idea/codeStyles/codeStyleConfig.xml

@@ -0,0 +1,5 @@
+<component name="ProjectCodeStyleConfiguration">
+  <state>
+    <option name="PREFERRED_PROJECT_CODE_STYLE" value="xsigns" />
+  </state>
+</component>

package/.idea/deployment.xml

@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="PublishConfigData" remoteFilesAllowedToDisappearOnAutoupload="false">
+    <serverData>
+      <paths name="dac7">
+        <serverdata>
+          <mappings>
+            <mapping local="$PROJECT_DIR$" web="/" />
+          </mappings>
+        </serverdata>
+      </paths>
+      <paths name="fewomatic">
+        <serverdata>
+          <mappings>
+            <mapping local="$PROJECT_DIR$" web="/" />
+          </mappings>
+        </serverdata>
+      </paths>
+      <paths name="server05">
+        <serverdata>
+          <mappings>
+            <mapping local="$PROJECT_DIR$" web="/" />
+          </mappings>
+        </serverdata>
+      </paths>
+      <paths name="server05 organizer">
+        <serverdata>
+          <mappings>
+            <mapping local="$PROJECT_DIR$" web="/" />
+          </mappings>
+        </serverdata>
+      </paths>
+      <paths name="vac-test">
+        <serverdata>
+          <mappings>
+            <mapping local="$PROJECT_DIR$" web="/" />
+          </mappings>
+        </serverdata>
+      </paths>
+      <paths name="vacarema">
+        <serverdata>
+          <mappings>
+            <mapping local="$PROJECT_DIR$" web="/" />
+          </mappings>
+        </serverdata>
+      </paths>
+    </serverData>
+  </component>
+</project>

package/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,13 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="AiaStyle" enabled="false" level="TYPO" enabled_by_default="false" />
+    <inspection_tool class="GrazieInspection" enabled="false" level="GRAMMAR_ERROR" enabled_by_default="false" />
+    <inspection_tool class="LanguageDetectionInspection" enabled="false" level="WEAK WARNING" enabled_by_default="false" />
+    <inspection_tool class="SpellCheckingInspection" enabled="false" level="TYPO" enabled_by_default="false">
+      <option name="processCode" value="true" />
+      <option name="processLiterals" value="true" />
+      <option name="processComments" value="true" />
+    </inspection_tool>
+  </profile>
+</component>

package/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/node-red-contrib-garmin-empirbus.iml" filepath="$PROJECT_DIR$/.idea/node-red-contrib-garmin-empirbus.iml" />
+    </modules>
+  </component>
+</project>

package/.idea/node-red-contrib-garmin-empirbus.iml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/.tmp" />
+      <excludeFolder url="file://$MODULE_DIR$/temp" />
+      <excludeFolder url="file://$MODULE_DIR$/tmp" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "node-red-contrib-garmin-empirbus",
+  "license": "MIT",
+  "version": "1.0.0",
+  "description": "Connects to Garmin Empirbus MCU or Serv7 Display to enable status and switching",
+  "keywords": ["node-red"],
+  "node-red": {
+    "nodes": {
+      "empirbus-config": "dist/nodes/empirbus-config.js",
+      "empirbus-dim": "dist/nodes/empirbus-dim.js",
+      "empirbus-switch": "dist/nodes/empirbus-switch.js",
+      "empirbus-toggle": "dist/nodes/empirbus-toggle.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc && yarn copy:html",
+    "copy:html": "copyfiles -u 1 \"src/nodes/**/*.html\" dist ",
+    "publish:registry": "node scripts/publish.mjs"
+  },
+  "dependencies": {
+    "garmin-empirbus-ts": "..\\garmin-empirbus-ts\\garmin-empirbus-ts-v0.1.11.tgz"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.0",
+    "@types/node-red": "^1.3.5",
+    "@types/node-red__editor-api": "^1.3.5",
+    "copyfiles": "^2.4.1",
+    "typescript": "^5.9.3"
+  }
+}

package/scripts/publish.mjs

@@ -0,0 +1,36 @@
+import { mkdtemp, rm } from 'node:fs/promises'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { execFile } from 'node:child_process'
+import { promisify } from 'node:util'
+import { readFile, writeFile } from 'node:fs/promises'
+
+const exec = promisify(execFile)
+
+const registryVersion = '^0.1.11'
+const dependencyName = 'garmin-empirbus-ts'
+
+const temp = await mkdtemp(join(tmpdir(), 'npm-publish-'))
+
+await exec('npm', ['pack', '--pack-destination', temp], { shell: true })
+
+const files = await exec('node', ['-e', `console.log(require("fs").readdirSync(${JSON.stringify(temp)}).join("\\n"))`], { shell: true })
+const tgzName = files.stdout.trim().split('\n').find(name => name.endsWith('.tgz'))
+if (!tgzName) throw new Error('No tgz created by npm pack')
+
+const tgzPath = join(temp, tgzName)
+
+await exec('tar', ['-xf', tgzPath, '-C', temp], { shell: true })
+
+const pkgPath = join(temp, 'package', 'package.json')
+const raw = await readFile(pkgPath, 'utf8')
+const data = JSON.parse(raw)
+
+data.dependencies ??= {}
+data.dependencies[dependencyName] = registryVersion
+
+await writeFile(pkgPath, JSON.stringify(data, null, 2) + '\n', 'utf8')
+
+await exec('npm', ['publish', join(temp, 'package'), '--access', 'public'], { shell: true })
+
+await rm(temp, { recursive: true, force: true })

package/src/helpers/channelHandling.ts

@@ -0,0 +1,98 @@
+import { Channel, EmpirBusChannelRepository } from 'garmin-empirbus-ts'
+import type { NodeMessageInFlow } from 'node-red'
+import { EmpirbusToggleAndSwitchNode } from '../types/EmpirbusToggleAndSwitchNode'
+
+export const parseChannelIds = (value?: string): number[] => {
+    if (!value)
+        return []
+    return value
+        .split(',')
+        .map(s => Number(s.trim()))
+        .filter(n => Number.isFinite(n))
+}
+
+export const resolveChannelIds = async (node: EmpirbusToggleAndSwitchNode, msg: NodeMessageInFlow, repo: EmpirBusChannelRepository): Promise<number[]> => {
+    const fromCheckbox = node.selectedChannelIds ?? []
+    if (fromCheckbox.length > 0)
+        return fromCheckbox
+
+    const fromMsgIds = getChannelIdsFromMsg(msg)
+    if (fromMsgIds != null)
+        return fromMsgIds
+
+    const fromMsgPayload = getChannelIdsFromTopicOfMsg(msg)
+    if (fromMsgPayload != null)
+        return fromMsgPayload
+
+    const fromMsgId = getChannelIdFromMsg(msg)
+    if (fromMsgId != null)
+        return [fromMsgId]
+
+    if (typeof node.channelId === 'number' && Number.isFinite(node.channelId))
+        return [node.channelId]
+
+    const fromMsgName = getChannelNameFromMsg(msg)
+    const name = fromMsgName ?? node.channelName
+    if (!name) return []
+
+    const index = await ensureChannelIndex(node, repo)
+    const mapped = index.get(name)
+    if (typeof mapped === 'number' && Number.isFinite(mapped)) {
+        return [mapped]
+    }
+
+    return []
+}
+
+const getChannelIdFromMsg = (msg: NodeMessageInFlow): number | null => {
+    const raw = (msg as any).channelId
+    if (typeof raw === 'number' && Number.isFinite(raw))
+        return raw
+    if (typeof raw === 'string' && raw.trim().length > 0) {
+        const n = Number(raw)
+        if (Number.isFinite(n))
+            return n
+    }
+    return null
+}
+
+const getChannelIdsFromMsg = (msg: NodeMessageInFlow): number[] | null => {
+    const raw = (msg as any).channelIds
+    if (typeof raw === 'number' && Number.isFinite(raw))
+        return [raw]
+    if (typeof raw === 'string' && raw.trim().length > 0)
+        return parseChannelIds(raw)
+    return null
+}
+
+const getChannelIdsFromTopicOfMsg = (msg: NodeMessageInFlow): number[] | null => {
+    const raw = (msg as any).topic
+    if (typeof raw === 'number' && Number.isFinite(raw))
+        return [raw]
+    if (typeof raw === 'string' && raw.trim().length > 0)
+        return parseChannelIds(raw)
+    return null
+}
+
+const getChannelNameFromMsg = (msg: NodeMessageInFlow): string | null => {
+    const raw = (msg as any).channelName
+    if (typeof raw === 'string' && raw.trim().length > 0)
+        return raw.trim()
+    return null
+}
+
+const ensureChannelIndex = async (node: EmpirbusToggleAndSwitchNode, repo: EmpirBusChannelRepository): Promise<Map<string, number>> => {
+
+    if (node.channelIndexByName)
+        return node.channelIndexByName
+
+    const list = await repo.getChannelList()
+    const index = new Map<string, number>()
+    list.forEach((ch: Channel) => {
+        if (ch.name) {
+            index.set(ch.name, ch.id)
+        }
+    })
+    node.channelIndexByName = index
+    return index
+}

package/src/helpers/getRepository.ts

@@ -0,0 +1,8 @@
+import { EmpirBusChannelRepository } from 'garmin-empirbus-ts'
+import { EmpirbusToggleAndSwitchNode } from '../types/EmpirbusToggleAndSwitchNode'
+
+export const getRepository = async (node: EmpirbusToggleAndSwitchNode): Promise<EmpirBusChannelRepository | null> => {
+    if (!node.configNode)
+        return null
+    return node.configNode.getRepository()
+}

package/src/nodes/empirbus-config.html

@@ -0,0 +1,31 @@
+<script type="text/x-red" data-template-name="empirbus-config">
+    <div class="form-row">
+      <label for="node-config-input-name">
+        <i class="fa fa-tag"></i> Name
+      </label>
+      <input type="text" id="node-config-input-name">
+    </div>
+
+    <div class="form-row">
+      <label for="node-config-input-url">
+        <i class="fa fa-globe"></i> WebSocket URL
+      </label>
+      <input type="text" id="node-config-input-url" placeholder="ws://192.168.1.1:8888">
+    </div>
+</script>
+
+<script type="text/javascript">
+    /* global RED */
+    RED.nodes.registerType('empirbus-config', {
+        category: 'config',
+        defaults: {
+            name: { value: '' },
+            url: { value: '', required: true }
+        },
+        label() {
+            if (this.name) return this.name
+            if (this.url) return this.url
+            return 'empirbus-config'
+        }
+    })
+</script>

package/src/nodes/empirbus-config.ts

@@ -0,0 +1,122 @@
+import { Channel, EmpirBusChannelRepository, EmpirBusClientState } from 'garmin-empirbus-ts'
+import { NodeDef, NodeInitializer } from 'node-red'
+import { EmpirbusConfigNode, OnStateFn } from '../types/EmpirbusConfigNode'
+
+interface EmpirbusConfigNodeDef extends NodeDef {
+    name: string
+    url: string
+}
+
+const nodeInit: NodeInitializer = RED => {
+    function scheduleReconnect(node: EmpirbusConfigNode) {
+        if (node.timeout) {
+            node.log(`node.timeout not null, return`)
+            return
+        }
+        node.timeout = setTimeout(() => {
+            if (node.timeout)
+                clearTimeout(node.timeout)
+            node.repository = connect(node)
+        }, 1000)
+    }
+
+    function connect(node: EmpirbusConfigNode) {
+        const repo = new EmpirBusChannelRepository(node.url)
+        node.repository = repo
+
+        node.log(`Connecting to EmpirBus at ${node.url}`)
+
+        repo.onState(state => {
+            if (node.timeout) {
+                clearTimeout(node.timeout)
+                node.timeout = null
+            }
+            node.onStateFns.forEach(fn => fn(state))
+            switch (state) {
+                case EmpirBusClientState.Error:
+                    node.error(`ERROR connecting to EmpirBus at ${node.url}`)
+                    scheduleReconnect(node)
+                    break
+                default:
+                case EmpirBusClientState.Closed:
+                    node.log(`Connection to EmpirBus at ${node.url} closed. Trying to reconnect in 1 second.`)
+                    scheduleReconnect(node)
+                    break
+            }
+        })
+
+        repo
+            .connect()
+            .then(() => node.log(`Connected to EmpirBus at ${node.url}`))
+            .catch(error => {
+                node.error(error)
+                scheduleReconnect(node)
+            })
+
+        return repo
+    }
+
+    function EmpirbusConfigNodeConstructor(this: EmpirbusConfigNode, config: EmpirbusConfigNodeDef) {
+        RED.nodes.createNode(this, config)
+        this.name = config.name
+        this.url = config.url
+        this.repository = null
+        this.onStateFns = []
+        this.timeout = null
+
+        const context = this.context()
+        context.set('isClosing', false)
+        context.set('reconnectTimeout', null)
+
+        this.repository = connect(this)
+
+        this.getRepository = async () => {
+            if (this.repository)
+                return this.repository
+
+            this.repository = connect(this)
+            return this.repository
+        }
+
+        this.on('close', () => {
+            const ctx = this.context()
+            ctx.set('isClosing', true)
+
+            const timeout = ctx.get('reconnectTimeout') as NodeJS.Timeout | null
+            if (timeout)
+                clearTimeout(timeout)
+
+            ctx.set('reconnectTimeout', null)
+
+            const repo = this.repository as unknown as { close?: () => void } | null
+            if (repo && typeof repo.close === 'function')
+                repo.close()
+        })
+
+        this.onState = (fn: OnStateFn) => {
+            this.onStateFns.push(fn)
+        }
+    }
+
+    RED.nodes.registerType('empirbus-config', EmpirbusConfigNodeConstructor as any)
+
+    RED.httpAdmin.get('/empirbus/:id/channels', async (req, res) => {
+        const configNode = RED.nodes.getNode(req.params.id) as EmpirbusConfigNode | null
+        if (!configNode) {
+            res.status(404).json({ error: 'config not found' })
+            return
+        }
+
+        const repo = await configNode.getRepository()
+        repo
+            .getChannelList()
+            .then((channels: Channel[]) => {
+                res.json(channels)
+            })
+            .catch(error => {
+                res.status(500).json({ error: String(error) })
+            })
+    })
+}
+
+export = nodeInit

package/src/nodes/empirbus-dim.html

@@ -0,0 +1,151 @@
+<script type="text/x-red" data-template-name="empirbus-dim">
+
+    <style>
+      .empirbus-row { display: flex; align-items: flex-start; gap: 8px; }
+      .empirbus-row input[type="text"], .empirbus-row input[type="number"] { flex: 1; width: 100%; }
+      .empirbus-row label { flex: 0 0 160px; max-width: 160px; white-space: nowrap; padding-top: 7px; }
+      .empirbus-input-wrapper { display: flex; flex-direction: column; flex: 1; }
+      .empirbus-input-wrapper input { flex: 1; }
+      .empirbus-input-wrapper input[type="checkbox"] { flex: 0 0 auto; width: auto; margin-top: 4px; align-self: flex-start; }
+      .empirbus-input-wrapper .help { font-size: 0.85em; opacity: 0.8; margin-top: 2px; }
+      .empirbus-channel-checkbox { flex: 0 0 20px; }
+      .empirbus-channel-id { flex: 0 0 50px; font-weight: bold; opacity: 0.8; text-align: right; display: block; padding-right: 5px; }
+      .empirbus-channel-label { flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+      .empirbus-channel-row { display: flex; align-items: center; gap: 8px; padding: 3px 0; }
+    </style>
+
+    <div class="form-row empirbus-row">
+      <label for="node-input-name">
+        <i class="fa fa-tag"></i> Name
+      </label>
+      <input type="text" id="node-input-name">
+    </div>
+
+    <div class="form-row empirbus-row">
+      <label for="node-input-config">
+        <i class="fa fa-cog"></i> EmpirBus Config
+      </label>
+      <input type="text" id="node-input-config">
+    </div>
+
+    <div class="form-row empirbus-row">
+      <label for="node-input-channelId">
+        <i class="fa fa-hashtag"></i> Channel ID
+      </label>
+      <div class="empirbus-input-wrapper">
+        <input type="number" id="node-input-channelId" style="width: 100%;">
+        <span class="help">Fallback, wenn keine Checkbox gewählt und kein Name gesetzt ist</span>
+      </div>
+    </div>
+
+    <div class="form-row empirbus-row">
+      <label for="node-input-channelName">
+        <i class="fa fa-font"></i> Channel Name
+      </label>
+      <input type="text" id="node-input-channelName">
+    </div>
+
+    <div class="form-row empirbus-row">
+      <label for="node-input-acknowledge">
+        <i class="fa fa-check"></i> bestätigen
+      </label>
+      <div class="empirbus-input-wrapper">
+        <input type="checkbox" id="node-input-acknowledge">
+        <span class="help">Wenn der Befehl erfolgreich ist, wird acknowledge:true an das msg Objekt gehängt</span>
+      </div>
+    </div>
+
+    <div class="form-row">
+      <label>Kanäle</label>
+      <div id="empirbus-dim-channels"></div>
+      <input type="hidden" id="node-input-channelIds">
+      <span class="help">Auswahl mehrerer Kanäle</span>
+    </div>
+
+</script>
+
+<script type="text/javascript">
+    /* exported oneditprepare, oneditsave */
+    /* global RED */
+    RED.nodes.registerType('empirbus-dim', {
+        category: 'output',
+        color: '#a6bbcf',
+        defaults: {
+            name: { value: '' },
+            config: { value: '', type: 'empirbus-config', required: true },
+            channelId: { value: '', required: false },
+            channelName: { value: '', required: false },
+            channelIds: { value: '', required: false },
+            acknowledge: { value: false }
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: 'bridge.svg',
+        label() {
+            return this.name || "EmpirBus Dim"
+        },
+
+        oneditprepare() {
+            const node = this
+
+            $('#node-input-acknowledge')
+                .prop('checked', !!node.acknowledge)
+
+            const loadChannels = configId => {
+                if (!configId) return
+                const container = $('#empirbus-dim-channels')
+                container.empty()
+
+                $.getJSON('empirbus/' + configId + '/channels', channels => {
+                    const selected = (node.channelIds || '')
+                        .split(',')
+                        .map(s => s.trim())
+                        .filter(s => s.length > 0)
+
+                    channels.forEach(ch => {
+                        const id = String(ch.id)
+                        const row = $('<div/>').addClass('empirbus-channel-row')
+
+                        const checkbox = $('<input type="checkbox">')
+                            .addClass('empirbus-channel-checkbox')
+                            .attr('data-channel-id', id)
+
+                        if (selected.indexOf(id) !== -1) {
+                            checkbox.prop('checked', true)
+                        }
+
+                        const idLabel = $('<span/>')
+                            .addClass('empirbus-channel-id')
+                            .text(id)
+
+                        const labelText = ch.description || ch.name || 'Channel ' + id
+                        const label = $('<span/>')
+                            .addClass('empirbus-channel-label')
+                            .text(labelText)
+
+                        row.append(checkbox).append(idLabel).append(label)
+                        container.append(row)
+                    })
+                })
+            }
+
+            $('#node-input-config').on('change', function () {
+                loadChannels($(this).val())
+            })
+
+            const initialConfig = $('#node-input-config').val()
+            if (initialConfig) loadChannels(initialConfig)
+        },
+
+        oneditsave() {
+            const ids = []
+            $('#empirbus-dim-channels input[type="checkbox"]:checked').each(function () {
+                ids.push($(this).attr('data-channel-id'))
+            })
+            $('#node-input-channelIds').val(ids.join(','))
+
+            const acknowledge = $('#node-input-acknowledge').is(':checked')
+            $('#node-input-acknowledge').val(acknowledge)
+        }
+    })
+</script>

package/src/nodes/empirbus-dim.ts

@@ -0,0 +1,75 @@
+import { DimState } from 'garmin-empirbus-ts'
+import type { NodeDef, NodeInitializer } from 'node-red'
+import { parseChannelIds, resolveChannelIds } from '../helpers/channelHandling'
+import { EmpirbusConfigNode } from '../types/EmpirbusConfigNode'
+import { EmpirbusToggleAndSwitchNode } from '../types/EmpirbusToggleAndSwitchNode'
+import { getRepository } from '../helpers/getRepository'
+
+interface EmpirbusDimNodeDef extends NodeDef {
+    acknowledge: boolean
+    channelId?: string
+    channelIds?: string
+    channelName?: string
+    config: string
+    name: string
+}
+
+const nodeInit: NodeInitializer = RED => {
+    function EmpirbusDimNodeConstructor(this: EmpirbusToggleAndSwitchNode, config: EmpirbusDimNodeDef) {
+        RED.nodes.createNode(this, config)
+        this.acknowledge = config.acknowledge || false
+        this.configNode = RED.nodes.getNode(config.config) as EmpirbusConfigNode | null
+        this.channelId = config.channelId ? Number(config.channelId) : undefined
+        this.channelName = config.channelName || undefined
+        this.channelIds = config.channelIds || ''
+        this.channelIds = config.channelIds || ''
+        this.selectedChannelIds = parseChannelIds(this.channelIds)
+
+        this.on('input', async msg => {
+            const repo = await getRepository(this)
+            if (!repo) {
+                this.error('No EmpirBus config node configured. Configure and select an EmpirBus config node first!', msg)
+                return
+            }
+
+            const ids = await resolveChannelIds(this, msg, repo)
+            if (ids.length === 0) {
+                this.error('No matching channel found', msg)
+                this.send(msg)
+                return
+            }
+
+            try {
+                let level = (msg.payload as number) * 10
+                if (level < 120 && (msg.payload as number) > 0)
+                    level = 120
+                const results = ids.map(id => repo.dim(id, level as DimState))
+                if (results.filter(result => result.hasFailed).length === 0) {
+                    if (this.acknowledge) {
+                        msg.acknowledge = true
+                        msg.payload = {
+                            state: {
+                                brightness: msg.payload
+                            }
+                        }
+                    }
+                    this.log(`Dimmed channels ${ids.join(',')} ${msg.payload}, returning message ${JSON.stringify(msg)}`)
+                }
+                else {
+                    results.filter(result => result.hasFailed).forEach(result => {
+                        this.error(result.errors.join(', '), msg)
+                    })
+                }
+
+                this.send(msg)
+            }
+            catch (error) {
+                this.error(error as Error, msg)
+            }
+        })
+    }
+
+    RED.nodes.registerType('empirbus-dim', EmpirbusDimNodeConstructor)
+}
+
+export = nodeInit

package/src/nodes/empirbus-switch.html

@@ -0,0 +1,151 @@
+<script type="text/x-red" data-template-name="empirbus-switch">
+
+    <style>
+      .empirbus-row { display: flex; align-items: flex-start; gap: 8px; }
+      .empirbus-row input[type="text"], .empirbus-row input[type="number"] { flex: 1; width: 100%; }
+      .empirbus-row label { flex: 0 0 160px; max-width: 160px; white-space: nowrap; padding-top: 7px; }
+      .empirbus-input-wrapper { display: flex; flex-direction: column; flex: 1; }
+      .empirbus-input-wrapper input { flex: 1; }
+      .empirbus-input-wrapper input[type="checkbox"] { flex: 0 0 auto; width: auto; margin-top: 4px; align-self: flex-start; }
+      .empirbus-input-wrapper .help { font-size: 0.85em; opacity: 0.8; margin-top: 2px; }
+      .empirbus-channel-checkbox { flex: 0 0 20px; }
+      .empirbus-channel-id { flex: 0 0 50px; font-weight: bold; opacity: 0.8; text-align: right; display: block; padding-right: 5px; }
+      .empirbus-channel-label { flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+      .empirbus-channel-row { display: flex; align-items: center; gap: 8px; padding: 3px 0; }
+    </style>
+
+    <div class="form-row empirbus-row">
+      <label for="node-input-name">
+        <i class="fa fa-tag"></i> Name
+      </label>
+      <input type="text" id="node-input-name">
+    </div>
+
+    <div class="form-row empirbus-row">
+      <label for="node-input-config">
+        <i class="fa fa-cog"></i> EmpirBus Config
+      </label>
+      <input type="text" id="node-input-config">
+    </div>
+
+    <div class="form-row empirbus-row">
+      <label for="node-input-channelId">
+        <i class="fa fa-hashtag"></i> Channel ID
+      </label>
+      <div class="empirbus-input-wrapper">
+        <input type="number" id="node-input-channelId" style="width: 100%;">
+        <span class="help">Fallback, wenn keine Checkbox gewählt und kein Name gesetzt ist</span>
+      </div>
+    </div>
+
+    <div class="form-row empirbus-row">
+      <label for="node-input-channelName">
+        <i class="fa fa-font"></i> Channel Name
+      </label>
+      <input type="text" id="node-input-channelName">
+    </div>
+
+    <div class="form-row empirbus-row">
+      <label for="node-input-acknowledge">
+        <i class="fa fa-check"></i> bestätigen
+      </label>
+      <div class="empirbus-input-wrapper">
+        <input type="checkbox" id="node-input-acknowledge">
+        <span class="help">Wenn der Befehl erfolgreich ist, wird acknowledge:true an das msg Objekt gehängt</span>
+      </div>
+    </div>
+
+    <div class="form-row">
+      <label>Kanäle</label>
+      <div id="empirbus-switch-channels"></div>
+      <input type="hidden" id="node-input-channelIds">
+      <span class="help">Auswahl mehrerer Kanäle</span>
+    </div>
+
+</script>
+
+<script type="text/javascript">
+    /* exported oneditprepare, oneditsave */
+    /* global RED */
+    RED.nodes.registerType('empirbus-switch', {
+        category: 'output',
+        color: '#a6bbcf',
+        defaults: {
+            name: { value: '' },
+            config: { value: '', type: 'empirbus-config', required: true },
+            channelId: { value: '', required: false },
+            channelName: { value: '', required: false },
+            channelIds: { value: '', required: false },
+            acknowledge: { value: false }
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: 'bridge.svg',
+        label() {
+            return this.name || "EmpirBus Switch"
+        },
+
+        oneditprepare() {
+            const node = this
+
+            $('#node-input-acknowledge')
+                .prop('checked', !!node.acknowledge)
+
+            const loadChannels = configId => {
+                if (!configId) return
+                const container = $('#empirbus-switch-channels')
+                container.empty()
+
+                $.getJSON('empirbus/' + configId + '/channels', channels => {
+                    const selected = (node.channelIds || '')
+                        .split(',')
+                        .map(s => s.trim())
+                        .filter(s => s.length > 0)
+
+                    channels.forEach(ch => {
+                        const id = String(ch.id)
+                        const row = $('<div/>').addClass('empirbus-channel-row')
+
+                        const checkbox = $('<input type="checkbox">')
+                            .addClass('empirbus-channel-checkbox')
+                            .attr('data-channel-id', id)
+
+                        if (selected.indexOf(id) !== -1) {
+                            checkbox.prop('checked', true)
+                        }
+
+                        const idLabel = $('<span/>')
+                            .addClass('empirbus-channel-id')
+                            .text(id)
+
+                        const labelText = ch.description || ch.name || 'Channel ' + id
+                        const label = $('<span/>')
+                            .addClass('empirbus-channel-label')
+                            .text(labelText)
+
+                        row.append(checkbox).append(idLabel).append(label)
+                        container.append(row)
+                    })
+                })
+            }
+
+            $('#node-input-config').on('change', function () {
+                loadChannels($(this).val())
+            })
+
+            const initialConfig = $('#node-input-config').val()
+            if (initialConfig) loadChannels(initialConfig)
+        },
+
+        oneditsave() {
+            const ids = []
+            $('#empirbus-switch-channels input[type="checkbox"]:checked').each(function () {
+                ids.push($(this).attr('data-channel-id'))
+            })
+            $('#node-input-channelIds').val(ids.join(','))
+
+            const acknowledge = $('#node-input-acknowledge').is(':checked')
+            $('#node-input-acknowledge').val(acknowledge)
+        }
+    })
+</script>

package/src/nodes/empirbus-switch.ts

@@ -0,0 +1,99 @@
+import { EmpirBusChannelRepository, EmpirBusClientState } from 'garmin-empirbus-ts'
+import { SwitchState } from 'garmin-empirbus-ts/dist/infrastructure/repositories/EmpirBus/EmpirBusChannelRepository'
+import type { NodeDef, NodeInitializer } from 'node-red'
+import { parseChannelIds, resolveChannelIds } from '../helpers/channelHandling'
+import { EmpirbusConfigNode } from '../types/EmpirbusConfigNode'
+import { EmpirbusToggleAndSwitchNode } from '../types/EmpirbusToggleAndSwitchNode'
+
+interface EmpirbusSwitchNodeDef extends NodeDef {
+    acknowledge: boolean
+    channelId?: string
+    channelIds?: string
+    channelName?: string
+    config: string
+    name: string
+}
+
+const getRepository = async (node: EmpirbusToggleAndSwitchNode): Promise<EmpirBusChannelRepository | null> => {
+    if (!node.configNode)
+        return null
+    return node.configNode.getRepository()
+}
+
+const nodeInit: NodeInitializer = RED => {
+    function EmpirbusSwitchNodeConstructor(this: EmpirbusToggleAndSwitchNode, config: EmpirbusSwitchNodeDef) {
+        RED.nodes.createNode(this, config)
+        this.acknowledge = config.acknowledge || false
+        this.configNode = RED.nodes.getNode(config.config) as EmpirbusConfigNode | null
+        this.channelId = config.channelId ? Number(config.channelId) : undefined
+        this.channelName = config.channelName || undefined
+        this.channelIds = config.channelIds || ''
+        this.channelIds = config.channelIds || ''
+        this.selectedChannelIds = parseChannelIds(this.channelIds)
+
+        if (this.configNode) {
+            this.configNode.onState((state: EmpirBusClientState) => {
+                switch (state) {
+                    case EmpirBusClientState.Connected:
+                        this.status({ fill: 'green', shape: 'dot', text: `connected` })
+                        break
+                    case EmpirBusClientState.Error:
+                        this.status({ fill: 'red', shape: 'dot', text: `ERROR` })
+                        break
+                    case EmpirBusClientState.Connecting:
+                        this.status({ fill: 'red', shape: 'ring', text: `connecting` })
+                        break
+                    default:
+                    case EmpirBusClientState.Closed:
+                        this.status({ fill: 'red', shape: 'ring', text: `disconnected` })
+                        break
+                }
+            })
+        }
+
+        this.on('input', async msg => {
+            const repo = await getRepository(this)
+            if (!repo) {
+                this.error('No EmpirBus config node configured. Configure and select an EmpirBus config node first!', msg)
+                return
+            }
+
+            const ids = await resolveChannelIds(this, msg, repo)
+            if (ids.length === 0) {
+                this.error('No matching channel found', msg)
+                this.send(msg)
+                return
+            }
+
+            try {
+                const promises = ids.map(id => repo.switch(id, msg.payload as SwitchState))
+                const results = await Promise.all(promises)
+                if (results.filter(result => result.hasFailed).length === 0) {
+                    if (this.acknowledge) {
+                        msg.acknowledge = true
+                        msg.payload = {
+                            state: {
+                                power: msg.payload
+                            }
+                        }
+                    }
+                    this.log(`Switched channels ${ids.join(',')} ${msg.payload}, returning message ${JSON.stringify(msg)}`)
+                }
+                else {
+                    results.filter(result => result.hasFailed).forEach(result => {
+                        this.error(result.errors.join(', '), msg)
+                    })
+                }
+
+                this.send(msg)
+            }
+            catch (error) {
+                this.error(error as Error, msg)
+            }
+        })
+    }
+
+    RED.nodes.registerType('empirbus-switch', EmpirbusSwitchNodeConstructor)
+}
+
+export = nodeInit

package/src/nodes/empirbus-toggle.html

@@ -0,0 +1,151 @@
+<script type="text/x-red" data-template-name="empirbus-toggle">
+
+    <style>
+      .empirbus-row { display: flex; align-items: flex-start; gap: 8px; }
+      .empirbus-row input[type="text"], .empirbus-row input[type="number"] { flex: 1; width: 100%; }
+      .empirbus-row label { flex: 0 0 160px; max-width: 160px; white-space: nowrap; padding-top: 7px; }
+      .empirbus-input-wrapper { display: flex; flex-direction: column; flex: 1; }
+      .empirbus-input-wrapper input { flex: 1; }
+      .empirbus-input-wrapper input[type="checkbox"] { flex: 0 0 auto; width: auto; margin-top: 4px; align-self: flex-start; }
+      .empirbus-input-wrapper .help { font-size: 0.85em; opacity: 0.8; margin-top: 2px; }
+      .empirbus-channel-checkbox { flex: 0 0 20px; }
+      .empirbus-channel-id { flex: 0 0 50px; font-weight: bold; opacity: 0.8; text-align: right; display: block; padding-right: 5px; }
+      .empirbus-channel-label { flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+      .empirbus-channel-row { display: flex; align-items: center; gap: 8px; padding: 3px 0; }
+    </style>
+
+    <div class="form-row empirbus-row">
+      <label for="node-input-name">
+        <i class="fa fa-tag"></i> Name
+      </label>
+      <input type="text" id="node-input-name">
+    </div>
+
+    <div class="form-row empirbus-row">
+      <label for="node-input-config">
+        <i class="fa fa-cog"></i> EmpirBus Config
+      </label>
+      <input type="text" id="node-input-config">
+    </div>
+
+    <div class="form-row empirbus-row">
+      <label for="node-input-channelId">
+        <i class="fa fa-hashtag"></i> Channel ID
+      </label>
+      <div class="empirbus-input-wrapper">
+        <input type="number" id="node-input-channelId" style="width: 100%;">
+        <span class="help">Fallback, wenn keine Checkbox gewählt und kein Name gesetzt ist</span>
+      </div>
+    </div>
+
+    <div class="form-row empirbus-row">
+      <label for="node-input-channelName">
+        <i class="fa fa-font"></i> Channel Name
+      </label>
+      <input type="text" id="node-input-channelName">
+    </div>
+
+    <div class="form-row empirbus-row">
+      <label for="node-input-acknowledge">
+        <i class="fa fa-check"></i> bestätigen
+      </label>
+      <div class="empirbus-input-wrapper">
+        <input type="checkbox" id="node-input-acknowledge">
+        <span class="help">Wenn der Befehl erfolgreich ist, wird acknowledge:true an das msg Objekt gehängt</span>
+      </div>
+    </div>
+
+    <div class="form-row">
+      <label>Kanäle</label>
+      <div id="empirbus-toggle-channels"></div>
+      <input type="hidden" id="node-input-channelIds">
+      <span class="help">Auswahl mehrerer Kanäle</span>
+    </div>
+
+</script>
+
+<script type="text/javascript">
+    /* exported oneditprepare, oneditsave */
+    /* global RED */
+    RED.nodes.registerType('empirbus-toggle', {
+        category: 'output',
+        color: '#a6bbcf',
+        defaults: {
+            name: { value: '' },
+            config: { value: '', type: 'empirbus-config', required: true },
+            channelId: { value: '', required: false },
+            channelName: { value: '', required: false },
+            channelIds: { value: '', required: false },
+            acknowledge: { value: false }
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: 'bridge.svg',
+        label() {
+            return this.name || "EmpirBus Toggle"
+        },
+
+        oneditprepare() {
+            const node = this
+
+            $('#node-input-acknowledge')
+                .prop('checked', !!node.acknowledge)
+
+            const loadChannels = configId => {
+                if (!configId) return
+                const container = $('#empirbus-toggle-channels')
+                container.empty()
+
+                $.getJSON('empirbus/' + configId + '/channels', channels => {
+                    const selected = (node.channelIds || '')
+                        .split(',')
+                        .map(s => s.trim())
+                        .filter(s => s.length > 0)
+
+                    channels.forEach(ch => {
+                        const id = String(ch.id)
+                        const row = $('<div/>').addClass('empirbus-channel-row')
+
+                        const checkbox = $('<input type="checkbox">')
+                            .addClass('empirbus-channel-checkbox')
+                            .attr('data-channel-id', id)
+
+                        if (selected.indexOf(id) !== -1) {
+                            checkbox.prop('checked', true)
+                        }
+
+                        const idLabel = $('<span/>')
+                            .addClass('empirbus-channel-id')
+                            .text(id)
+
+                        const labelText = ch.description || ch.name || 'Channel ' + id
+                        const label = $('<span/>')
+                            .addClass('empirbus-channel-label')
+                            .text(labelText)
+
+                        row.append(checkbox).append(idLabel).append(label)
+                        container.append(row)
+                    })
+                })
+            }
+
+            $('#node-input-config').on('change', function () {
+                loadChannels($(this).val())
+            })
+
+            const initialConfig = $('#node-input-config').val()
+            if (initialConfig) loadChannels(initialConfig)
+        },
+
+        oneditsave() {
+            const ids = []
+            $('#empirbus-toggle-channels input[type="checkbox"]:checked').each(function () {
+                ids.push($(this).attr('data-channel-id'))
+            })
+            $('#node-input-channelIds').val(ids.join(','))
+
+            const acknowledge = $('#node-input-acknowledge').is(':checked')
+            $('#node-input-acknowledge').val(acknowledge)
+        }
+    })
+</script>

package/src/nodes/empirbus-toggle.ts

@@ -0,0 +1,65 @@
+import { EmpirBusChannelRepository } from 'garmin-empirbus-ts'
+import { SwitchState } from 'garmin-empirbus-ts/dist/infrastructure/repositories/EmpirBus/EmpirBusChannelRepository'
+import type { Node as NodeRedNode, NodeDef, NodeInitializer } from 'node-red'
+import { parseChannelIds, resolveChannelIds } from '../helpers/channelHandling'
+import { EmpirbusConfigNode } from '../types/EmpirbusConfigNode'
+import { EmpirbusToggleAndSwitchNode } from '../types/EmpirbusToggleAndSwitchNode'
+
+interface EmpirbusToggleNodeDef extends NodeDef {
+    acknowledge: boolean
+    channelId?: string
+    channelIds?: string
+    channelName?: string
+    config: string
+    name: string
+}
+
+const getRepository = async (node: EmpirbusToggleAndSwitchNode): Promise<EmpirBusChannelRepository | null> => {
+    if (!node.configNode)
+        return null
+    return node.configNode.getRepository()
+}
+
+const nodeInit: NodeInitializer = RED => {
+    function EmpirbusToggleNodeConstructor(this: EmpirbusToggleAndSwitchNode, config: EmpirbusToggleNodeDef) {
+        RED.nodes.createNode(this, config)
+        this.acknowledge = config.acknowledge || false
+        this.configNode = RED.nodes.getNode(config.config) as EmpirbusConfigNode | null
+        this.channelId = config.channelId ? Number(config.channelId) : undefined
+        this.channelName = config.channelName || undefined
+        this.channelIds = config.channelIds || ''
+        this.channelIds = config.channelIds || ''
+        this.selectedChannelIds = parseChannelIds(this.channelIds)
+
+        this.on('input', async msg => {
+            const repo = await getRepository(this)
+            if (!repo) {
+                this.error('No EmpirBus config node configured. Configure and select an EmpirBus config node first!', msg)
+                return
+            }
+
+            const ids = await resolveChannelIds(this, msg, repo)
+            if (ids.length === 0) {
+                this.error('No matching channel found', msg)
+                this.send(msg)
+                return
+            }
+
+            try {
+                const promises = ids.map(id => repo.toggle(id))
+                await Promise.all(promises)
+                if (this.acknowledge)
+                    msg.acknowledge = true
+                this.log(`Toggled channels ${ids.join(',')}, returning message ${JSON.stringify(msg)}`)
+                this.send(msg)
+            }
+            catch (error) {
+                this.error(error as Error, msg)
+            }
+        })
+    }
+
+    RED.nodes.registerType('empirbus-toggle', EmpirbusToggleNodeConstructor)
+}
+
+export = nodeInit

package/src/types/EmpirbusConfigNode.ts

@@ -0,0 +1,14 @@
+import { EmpirBusChannelRepository, EmpirBusClientState } from 'garmin-empirbus-ts'
+import { Node as NodeRed } from 'node-red'
+
+export interface EmpirbusConfigNode extends NodeRed {
+    name: string
+    url: string
+    repository: EmpirBusChannelRepository | null
+    getRepository: () => Promise<EmpirBusChannelRepository>
+    onState: (fn: OnStateFn) => void
+    onStateFns: Array<OnStateFn>
+    timeout: NodeJS.Timeout | null
+}
+
+export type OnStateFn = (state: EmpirBusClientState) => void

package/src/types/EmpirbusToggleAndSwitchNode.ts

@@ -0,0 +1,12 @@
+import type { Node as NodeRedNode } from 'node-red'
+import { EmpirbusConfigNode } from './EmpirbusConfigNode'
+
+export interface EmpirbusToggleAndSwitchNode extends NodeRedNode {
+    acknowledge: boolean
+    channelId?: number
+    channelIds?: string
+    channelIndexByName?: Map<string, number>
+    channelName?: string
+    configNode: EmpirbusConfigNode | null
+    selectedChannelIds?: number[]
+}

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "module": "CommonJS",
+    "moduleResolution": "Node",
+    "noEmitOnError": true,
+    "outDir": "dist",
+    "resolveJsonModule": true,
+    "rootDir": "src",
+    "skipLibCheck": true,
+    "sourceMap": true,
+    "strict": true,
+    "target": "ES2021"
+  },
+  "include": [
+    "src"
+  ]
+}