FireFlyI2CServer

Overview

FireFly I2C Server is used to perform I2C read and write operations to FireFly's EEPROM over IPC. The design attempts to be stateless and enable redux oriented actions over IPC.

Supported FireFly Variants:

• FireFly ECUOB04
• FireFly ECUOT12
• FireFly ECUOBR12

Publishing to NPM registry

yarn run prepublish

Installation

Local install:

yarn add @samtec-ash/fireflyi2cserver

Global install:

yarn global add @samtec-ash/fireflyi2cserver --prefix /usr/local

Environmental Variables

• NODE_ENV: development, production
• ENV_TEST: true, false
• IPC_ADDRESS: IPC IP Address to use. Defaults to localhost.
• IPC_PORT: IPC IP Port to use. Defaults to 7777

Run

./node_modules/.bin/fireflyi2cserver

Actions:

DETECT_FIREFLYS

Input Payload:

{
  actionUUID: string,
  action: 'DETECT_FIREFLYS',
  payload: null
}

Output Payload:

{
  action: 'DETECT_FIREFLYS',
  success: boolean,
  error: string | null,
  payload: Array<FireFlyStatus>
}

READ_FIREFLY_STATUS

Input Payload:

{
  action: 'READ_FIREFLY_STATUS',
  payload: {
    ids: ?Array<string>
  }
}

Output Payload:

{
  action: 'READ_FIREFLY_STATUS',
  success: boolean,
  error: string | null,
  payload: Array<FireFlyStatus>
}

READ_FIREFLY_EEPROM

Input Payload:

{
  action: 'READ_FIREFLY_EEPROM',
  payload: {
    id: string,
    fields: Array<string>
  }
}

Output Payload:

{
  action: 'READ_FIREFLY_EEPROM',
  success: boolean,
  error: string | null,
  payload: {
    status: FireFlyStatus,
    fields: Array<FireFlyField>
  }
}

WRITE_FIREFLY_EEPROM

Input Payload:

{
  action: 'WRITE_FIREFLY_EEPROM',
  payload: {
    id: string,
    fields: Array<FireFlyField>
  }
}

Output Payload:

{
  action: 'WRITE_FIREFLY_EEPROM',
  success: boolean,
  error: string | null,
  payload: {
    status: FireFlyStatus
  }
}

Types:

type GPIOSetting = {
  +pin: number,
  +dir: "output" | "input",
  +value: "low" | "high"
}
 
type FireFlyStatus = {
  +id: string,  // Serial Number
  +name: string,
  +type: string,
  +i2cAddress: string,
  +gpioSettings: [GPIOSetting],
  +connected: bool,
  +error: string,  
};
 
type FireFlyField = {
  +name: string,
  +value: boolean|string|number|Array<boolean|string|number>
}
 
type FireFlyECUOB04 = {
  // General Indicator
  +serialNumber: string,
  +partNumber: string,
  +firmwareVersion: string,
  +eepromVersion: string,
  +vendorDate: string,
  +temperature: number,
  +voltage1v8: number,
  +voltage3v3: number,
  +temperatureHighAlarm: Array<boolean>,
  +temperatureLowAlarm: Array<boolean>,
  +temperatureHighWarn: Array<boolean>,
  +temperatureLowWarn: Array<boolean>,  
  +temperatureTimes: Array<number>,
  +voltage1v8HighAlarm: Array<boolean>,  
  +voltage1v8LowAlarm: Array<boolean>,  
  +voltage1v8HighWarn: Array<boolean>,  
  +voltage1v8LowWarn: Array<boolean>,  
  +voltage3v3HighAlarm: Array<boolean>,  
  +voltage3v3LowAlarm: Array<boolean>,  
  +voltage3v3HighWarn: Array<boolean>,  
  +voltage3v3LowWarn: Array<boolean>,  
  // RX Control
  +rxEnable: Array<boolean>,
  +rxPolarityInvert: Array<boolean>,
  +rxOutputVoltageSwing: Array<number>,
  +rxOutputPreEmphasis: Array<number>,
  +rxCDREnable: Array<boolean>,
  +rxCDRRate: Array<number>,
  // RX Indicator
  +rxRSSIStatus: Array<number>,
  +rxLOSStatus: Array<boolean>,
  +rxLOLStatus: Array<boolean>,
  // TX Control
  +txEnable: Array<boolean>,
  +txPolarityInvert: Array<boolean>,
  +txInputEqualization: Array<number>,
  +txCDREnable: Array<boolean>,
  +txCDRRate: Array<number>,
  +txSquelch: Array<boolean>,
  // TX Indicator
  +txRSSIStatus: Array<number>,
  +txLOSStatus: Array<boolean>,
  +txLOLStatus: Array<boolean>,
  +txFault: Array<boolean>
}
 
type FireFlyECUOT12 = {
  // General Indicator
  +serialNumber: string,
  +partNumber: string,
  +firmwareVersion: string,
  +eepromVersion: string,
  +vendorDate: string,
  +temperature: number,
  +voltage3v3: number,
  +temperatureHighAlarm: Array<boolean>,
  +temperatureLowAlarm: Array<boolean>,
  +temperatureTimes: Array<number>,
  +voltage3v3HighAlarm: Array<boolean>,  
  +voltage3v3LowAlarm: Array<boolean>,  
  // TX Control
  +txEnable: Array<boolean>,
  +txPolarityInvert: Array<boolean>,
  // TX Indicator
  +txFault: Array<boolean>
}
 
type FireFlyECUOR12 = {
  // General Indicator
  +serialNumber: string,
  +partNumber: string,
  +firmwareVersion: string,
  +eepromVersion: string,
  +vendorDate: string,
  +temperature: number,
  +voltage3v3: number,
  +temperatureHighAlarm: Array<boolean>,
  +temperatureLowAlarm: Array<boolean>,
  +temperatureTimes: Array<number>,
  +voltage3v3HighAlarm: Array<boolean>,  
  +voltage3v3LowAlarm: Array<boolean>,  
  // RX Control
  +rxEnable: Array<boolean>,
  +rxOutputEnable: Array<boolean>,
  +rxOutputVoltageSwing: Array<number>,
  +rxOutputPreEmphasis: Array<number>,
  // RX Indicator
  +rxLOSStatus: Array<boolean>,
}