@robdobsn/raftjs 1.7.8 → 1.10.7

package/src/RaftDeviceMgrIF.ts

@@ -0,0 +1,33 @@
+/////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+//
+// RaftDeviceMgrIF.ts
+// Interface to devices state
+//
+// Rob Dobson (C) 2024
+//
+/////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+import { DeviceTypeAction } from "./RaftDeviceInfo";
+import { DeviceAttributeState, DevicesState, DeviceState } from "./RaftDeviceStates";
+
+export default interface RaftDeviceMgrIF {
+
+    // Get state of devices
+    getDevicesState(): DevicesState;
+    getDeviceState(deviceKey: string): DeviceState;
+
+    // Settings
+    setMaxDataPointsToStore(maxDataPointsToStore: number): void;
+
+    // Callbacks
+    addNewDeviceCallback(callback: (deviceKey: string, state: DeviceState) => void): void;
+    removeNewDeviceCallback(callback: (deviceKey: string, state: DeviceState) => void): void;
+    addNewAttributeCallback(callback: (deviceKey: string, attrState: DeviceAttributeState) => void): void;
+    removeNewAttributeCallback(callback: (deviceKey: string, attrState: DeviceAttributeState) => void): void;
+    addAttributeDataCallback(callback: (deviceKey: string, attrState: DeviceAttributeState) => void): void;
+    removeAttributeDataCallback(callback: (deviceKey: string, attrState: DeviceAttributeState) => void): void;
+
+    // Send action to device
+    sendAction(deviceKey: string, action: DeviceTypeAction, data: number[]): void;
+    sendCompoundAction(deviceKey: string, action: DeviceTypeAction, data: number[][]): void;
+}

package/src/RaftDeviceMsg.ts

@@ -0,0 +1,20 @@
+/////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+//
+// RaftDeviceMsg
+// Device message for Raft devices
+//
+// Rob Dobson (C) 2024
+//
+/////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+export interface DeviceMsgJsonElem {
+    [attrGroupName: string]: string | number | boolean; // Attribute group name and value
+}
+
+export interface DeviceMsgJsonBus {
+    [devAddr: string]: DeviceMsgJsonElem;
+}
+  
+export interface DeviceMsgJson {
+    [busName: string]: DeviceMsgJsonBus;
+}

package/src/RaftDeviceStates.ts

@@ -0,0 +1,92 @@
+/////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+//
+// RaftDeviceStates
+// Device states for Raft devices
+//
+// Rob Dobson (C) 2024
+//
+/////////////////////////////////////////////////////////////////////////////////////////////////////////////////
+
+import { DeviceTypeInfo } from "./RaftDeviceInfo";
+
+export function deviceAttrGetLatestFormatted(attrState: DeviceAttributeState): string {
+
+    if (attrState.values.length === 0) {
+        return 'N/A';
+    }
+    if (attrState.format.length === 0) {
+        return attrState.values[attrState.values.length - 1].toString();
+    }
+    const value = attrState.values[attrState.values.length - 1];
+    let format = attrState.format;
+    if (format.startsWith("%")) {
+        format = format.slice(1);
+    }
+    if (format.endsWith('f')) {
+        // Floating point number formatting
+        const parts = format.split('.');
+        let decimalPlaces = 0;
+        if (parts.length === 2) {
+            decimalPlaces = parseInt(parts[1], 10);
+        }
+        const formattedNumber = value.toFixed(decimalPlaces);
+        const fieldWidth = parseInt(parts[0], 10);
+        return fieldWidth ? formattedNumber.padStart(fieldWidth, ' ') : formattedNumber;
+    } else if (format.endsWith('x')) {
+        // Hexadecimal formatting
+        const totalLength = parseInt(format.slice(0, -1), 10);
+        return Math.floor(value).toString(16).padStart(totalLength, format.startsWith('0') ? '0' : ' ');
+    } else if (format.endsWith('d')) {
+        // Decimal integer formatting
+        const totalLength = parseInt(format.slice(0, -1), 10);
+        return Math.floor(value).toString(10).padStart(totalLength, format.startsWith('0') ? '0' : ' ');
+    } else if (format.endsWith('b')) {
+        // Binary formatting
+        return Math.floor(value) === 0 ? 'no' : 'yes';
+    }
+    return value.toString();
+}
+
+export interface DeviceAttributeState {
+    name: string;
+    newAttribute: boolean;
+    newData: boolean;
+    numNewValues: number;
+    values: number[];
+    units: string;
+    range: number[];
+    format: string;
+    visibleSeries: boolean;
+    visibleForm: boolean;
+}
+
+export interface DeviceAttributesState {
+    [attributeName: string]: DeviceAttributeState;
+}
+
+export interface DeviceTimeline {
+    timestampsUs: number[];
+    lastReportTimestampUs: number;
+    reportTimestampOffsetUs: number;
+}
+    
+export interface DeviceState {
+    deviceTypeInfo: DeviceTypeInfo | undefined;
+    deviceTimeline: DeviceTimeline;
+    deviceAttributes: DeviceAttributesState;
+    deviceIsNew: boolean;
+    stateChanged: boolean;
+    isOnline: boolean;
+    deviceAddress: string;
+    deviceType: string;
+    busName: string;
+}
+
+export class DevicesState {
+    [deviceKey: string]: DeviceState;
+}
+
+// Add the getDeviceKey method to generate a composite key
+export function getDeviceKey(busName: string, devAddr: string): string {
+    return `${busName}_${devAddr}`;
+}