Messenger BLE User’s Guide Version 1.0.
MessengerBLE User Guide 2
MessengerBLE User Guide Table of Contents 1 Description .............................................................................................................................7 1.1 1.2 1.3 2 Installation and Setup ...........................................................................................................11 2.1 2.2 2.3 2.4 2.5 2.6 2.7 2.8 2.9 3 4 5 Command Syntax ......................................................................................... 31 Modbus ..................
MessengerBLE User Guide 9.18 9.19 9.20 9.21 9.22 9.23 10 How-To............................................................................................................................82 10.1 10.2 10.3 10.4 10.5 10.6 12 13 EVAL Expression Configuration – Type 10 ................................................ 72 J1939 PGN Configuration – Type 15 ........................................................... 75 J1939 SPN Configuration – Type 14 ...........................................................
MessengerBLE User Guide VERSION DATE NOTES 1 5/14/2020 Initial release Copyright and Trademark Information All Pages Copyright © 2020 Cattron. All Rights Reserved. U.S. Government Users Restricted Rights. Use, duplication, or disclosure by the Government is subject to restrictions as set forth in applicable laws and regulations. Use of the materials by the Government constitutes acknowledgment of Cattron’s proprietary rights in them.
MessengerBLE User Guide Introduction This User’s Manual describes installation and setup of the Messenger-BLE product. Throughout this document, Messenger-BLE and Messenger are used interchangeably. The Messenger is a complete monitoring, alarm notification, and telemetry platform. The intended markets include (but not limited to) water/wastewater utility, off-road heavy construction equipment, on-road semi-trucks, oil and gas, and standby power generators.
MessengerBLE User Guide 1 Description 1.1 Capabilities The Messenger is a highly configurable platform for remote monitoring and control applications. Some of the capabilities are listed below.
MessengerBLE User Guide date/time, an event code, and associated data. An event code provides a unique identifier to indicate the reason that notification is being sent – e.g. normal scheduled update or an engine diagnostic message received. A description of the protocol, format of messages, and definition of event codes is available on request (reference protocol document “M09-PRTCLxxx”).
MessengerBLE User Guide acknowledged. This store and forward memory is non-volatile and remains intact during power off. 1.3.4 Real-Time Clock (RTC) The RTC is used to timestamp data records and events. All messages sent to the host server contain a timestamp to provide a chronology of data/events to the end user. This timestamp is UTC time. All timestamps viewed from the debug menu are local time based on the configured time zone. The RTC is battery backed to provide time keeping during power off.
MessengerBLE User Guide 1.3.
MessengerBLE User Guide 2 Installation and Setup This section provides information on installing the Messenger and confirming its initial operation. WARNING It is recommended to read this entire chapter before starting installation. 2.1 Installation Steps Installation consists of the following steps: 1. 2. 3. 4. 5. Unpack the Equipment. Mount the Equipment. The Messenger should be mounted in a vertical position to try and minimize the chance of water entering through the antenna connections.
MessengerBLE User Guide Mount the enclosure in a vertical orientation and provide service loops for each antenna and IO cable to prevent water intrusion. 2.3.1 EEC Thermoplastic Enclosure Figure 1: Deutsch EEC Thermoplastic Enclosure Dimensions When mounting the enclosure to vibrating equipment, it is recommended to use rubber dampeners to isolate the unit. Stainless mounting hardware is preferred and the use of lock washers is highly recommended. 2.
MessengerBLE User Guide CAUTION Service loops should be provided for the antenna cabling, near the antenna connections to minimize water ingress through the SMA RF coax connections. 2.5 DIP Switch/Jumper Settings The Messenger uses an on-board DIP switch and jumpers to configure application specific IO and set operational modes. DIP SW3 is used to set operational modes. See Figure 3 for switch/jumper locations. See Figure 4 for IO selection settings.
MessengerBLE User Guide 2.6 DIP Switch 3 Decode DIP Switch 3 is a 4-position dip switch located on the left side of the board (Figure 3). If any switch 3 position is changed, the power must be cycled for the new switch positions to be read.
MessengerBLE User Guide 2.7 IO Connections The Deutsch EEC enclosure has a water tight end-cap fitted with one M12x8 MALE connector (JR2-PRI), one M12x8 FEMALE connector (JR1-SEC), one SMA JACK GPS antenna connector, and one SMA-RP JACK CELL antenna connector. See figure x. Figure 3: Messenger IO Connectors Depending on the customer input/output requirements, there may be 1 or 2 cable harnesses supplied for the customer to connect to his field signals.
MessengerBLE User Guide Figure X: Messenger IO Signals MessengerBLE IO Harness Flying Lead JR2 (Pri) WHT PWR IN 1 CAN L 2 BRN CAN H 3 GRN YEL P1-RS485B 5 GRY AIN 1 6 PNK GND 7 BLU 8 JR1 (Sec) 1 WHT DIN 2 2 BRN 3 GRN AIN 2 4 YEL DIN 4 USER IO 1 USER IO 2 USER IO 3 GND GND BRN CAN-L GRN CAN-H BLU P1-RS485A YEL P1-RS485B RED 8-Pin Female M12 DIN 3 RED 4 DIN 1 P1-RS485A WHT V+ (8-36vdc) Cables PVC Jacket PVC Conductor Insulation 8x22 2A, 60VAC, 75VDC Temp: -40C to 105C Protec
MessengerBLE User Guide Figure 4: User IO Jumper Location If digital outputs (DOUT1, DOUT2, or DOUT3) are to be used in the application 17
MessengerBLE User Guide 2.8 Cellular Setup The Messenger supports two cellular technologies, HSPA (3G) and LTE (4G). The current offering for HSPA is a 3G penta-band capable radio. For LTE, it is a 4G, dualband radio. Both of these radio options require a wireless account with a cellular provider such as AT&T or Verizon.
MessengerBLE User Guide 3 LED States There is one tri-color LED visible to the user to indicate various system conditions. These conditions are conveyed to the user via LED color and blink patterns. Blinking of LEDs can be disabled via a configuration setting (OPTIONS Configuration). On powerup, an LED test is performed by blinking all LEDs every second for 3 seconds. Following the LED test, the LEDs blink based on the following conditions: The number of blinks will range from 1 to 3.
MessengerBLE User Guide 4 IO Architecture The IO architecture is shown in the diagram below. Each of the physical IO entities has a configuration that is set based on user requirements. Based on that configuration, the values sampled are stored in their respective data registers. These data registers are used to reference the corresponding value for use in channel creation or in expressions used to compute values. The complete list of available data registers can be found in Appendix B.
MessengerBLE User Guide 5 Channels The Messenger maps all monitored conditions into channels. Each channel has data storage and configuration parameters. Data storage holds current value, max/min values, and other run time data values. Configuration consists of user settable parameters that define rules on how the data values are to be processed (Channel Configuration). The data stored in a channel is user definable.
MessengerBLE User Guide Channel Number Channel Name Type 4 User DIN1 Digital 21 User DIN2 Digital 5 User DIN3 Digital 6 User DIN4 Digital 9 Engine Run Digital 10 Shutdown Digital 11 Warning Digital 20 GPS Digital (System) Source Data Register Description 0=normal If SWX4-1 closed: 0=open 1=ground applied If SWX4-1 open: 1=open 0=voltage applied If SWX4-2 closed: 0=input open 1=input grounded If SWX4-2 open: 1=input open 0=voltage > 3vdc If SWX4-3 closed: 0=in
MessengerBLE User Guide Channel Number Channel Name Type 30 User DOUT1 Digital 31 User DOUT2 Digital 32-39 40 Spare DPF Passive Regeneration Status DPF Active Regeneration Status DPF Active Regeneration Inhibit Status DPF Active Regeneration Inhibit Switch DPF Active Regeneration Inhibit Temp Lockout DPF Active Regeneration Inhibit Perm Lockout DPF AutoAct Regeneration Config DPF1 Cond Not Met For Regeneration Spare Digital Digital 41 42 43 44 45 46 47 48-50 51 Fuel Level Source Data
MessengerBLE User Guide Channel Number 52 53 Channel Name Eng RPM Eng HRS 56 Coolant Temp Battery Electrical Oil Pressure Fuel Rate User Analog 57 58 59 60 62 79 Type Analog Analog Analog Analog Analog Analog Analog 81 Analog 82 Idle Time Analog 83 Idle Fuel Analog 84 Work Time Analog 85 Work Fuel Analog 86 Daily Idle Time Daily Idle Fuel Daily Work Time Daily Work Fuel Oil Level Analog 88 89 90 Description Engine speed, RPM Accumulated engine run time (hours) degrees C Analog V
MessengerBLE User Guide Channel Number 91 92 95 96 105 106 107 108 109 110 111 118 119 Channel Name Oil Temp Coolant Level Throttle Position Road Speed Barometric Pressure Cabin Temperature Ambient Temperature Accelerator Pedal Position Air Filter Diff.
MessengerBLE User Guide Channel Number 155 250 251 252 253 254 255 256 257 258259 260 261 262 Channel Name Running Flow Volume Generator, Total kW Hours Export Generator, Total Reactive Power Generator, Overall Power Factor Generator, Total Real Power Generator, Average Line-Line AC RMS Voltage Generator, Average Line-Neutral AC RMS Voltage Generator, Average AC Frequency Generator, Average AC RMS Current Spare DPF1 Soot Load DPF1 Ash Load DPF1 ET Regen Type Source Data Register Accumulated fl
MessengerBLE User Guide Channel Number 263 264 265 266 267 268 Channel Name AT1 DPF Regen Threshold DPF2 Soot Load DPF2 Ash Load DPF2 ET Regen AT2 DPF Regen Threshold DPF Lamp Cmd Type Analog Analog Analog 270 Exh High Temp Lamp Cmd Analog 271 Eng Trip Fuel Analog 273 274 275 276 277 278 279 Support for tier 4 diesel engines Support for tier 4 diesel engines Support for tier 4 diesel engines Analog Analog Eng Total Fuel AT1 Def Tank Level 1 AT1 Def Tank Level 2 AT Cat Reduction Active Eng Wai
MessengerBLE User Guide Channel Number 290300 Channel Name Spare 301350 User-Defined Type User Defined Source Data Register Description Start User-Defined Channels Analog or Digital channels 28
MessengerBLE User Guide 5.2 Channel Data All values read from physical IO, an engine bus, or from a Modbus slave device are continually updated and tested as defined by the configuration parameters. For each channel, based on its type (analog or digital), there is a basic set of data collected. For purposes of discussion, the term “not normal” is used to indicate an analog value that has violated a limit threshold or a digital value that does not match its configured ‘normal’ state.
MessengerBLE User Guide The daily data set is a separate set of current and max/min values that span the 24 hour period from midnight to midnight, UTC time. At midnight, an end of day report is generated from this data. Because Modbus channel data is polled, Modbus digital channels do not maintain count or duration values.
MessengerBLE User Guide 6 SMS Text Commands The Messenger can receive and execute SMS commands to perform specific functions. The SMS command set includes: CONFIG – used to modify configuration parameters ADIPREQ – request to connect to remote diagnostic utility ACTION – on-demand action request 6.1 Command Syntax The commands can be upper case, lower case, or combination. y,zzzz)> - used to modify configuration parameters.
MessengerBLE User Guide (Channels are fixed and include RPM, Engine Hours, Coolant Temp, Battery Voltage, Oil Pressure, and Odometer) Clear oldest data record from queue Force digital output 2 on Force digital output 2 off Reset/restart Peer poll/push Force exit of mini-ping mode Zero all non-volatile counter data Return SIM card info Clear ADC channel daily flow totals Clear ADC channel running flow totals Return CELL Status OEM Specific Initiate Modbus control sequence Force Hardware Reset 13 16 17 24 2
MessengerBLE User Guide d = count in queue e = deleted from queue f = failed OUTP A B SWX MSGS f = failed c = count VER prot = protocol (Antx, Rastrac, other) modem = type of modem, jbus = type of bus coordinates text: VID(v)-LAT(s)-LON(g)-STATUS(u)-AGE(p)-ANT(j) SIM info text: VID(v)-MSISDN(s)-ICCID(g)-IMSI(u)-IMEI(p) data text: VID v-Running: s-52 RPM: r-x Hours: h- CoolTemp: x-Battery -OilPress Odometer o 33
MessengerBLE User Guide 7 Modbus The Messenger can be configured as a Modbus Master, Modbus Slave or both. This is done by setting the Mode of one of the available user serial ports, 5 or 6. Both ports support RS485 only. If RS232 is required, an RS485 to RS232 adapter will need to be inserted. 7.1 RTU Slave Being configured as a Modbus RTU Slave device allows SCADA/HMI software to read channel values from the Messenger.
MessengerBLE User Guide 8 Debug Menu The debug menu is a text based menu system accessible via terminal emulation software running on a PC (i.e. TeraTerm or Hyperterminal) or via a PC based utility that connects to the Messenger OTA via TCP. Debug menus allow the user to view or change configuration parameters, view data values and history logs, see communications between CPU and attached peripherals, and to clear accumulated data values or logs.
MessengerBLE User Guide 9 Configuration The Messenger is a highly configurable platform with several methods in place to allow a user to read and/or modify the whole configuration or any part of. All configuration parameters are stored in non-volatile memory.
MessengerBLE User Guide This table identifies the available configuration line types and their type code.
MessengerBLE User Guide Configuration Line Types 28 Peer Poll 29 Peer Push 30 40 VFD Virtual Channel FOTA 96 VFD Parameter Setup Virtual channel configuration parameters FOTA configuration for updating cellular modem firmware Peer Index Range 1-16 Peer Index Range 1-16 None Virtual Channel Index Range 1-40 None 9.1 Debug Configuration Commands Users can manage the current configuration via the built in Debug Menu system. From the main menu, select Site Setup (6).
MessengerBLE User Guide Examples: Returns Site config Returns Engine config Returns Serial Port 1 config Invalid SMS Read command Invalid SMS Read command CAUTION The read all command (255,255) does not function via SMS due to SMS message size constraints.
MessengerBLE User Guide 9.1.
MessengerBLE User Guide 9.1.3 Global Command The global command can be used to set the same parameter, within the same configuration type, for consecutive indexes, to the same value. The global command only works with Geo-Fence, Channel, and Report Flag configuration types.
MessengerBLE User Guide 9.2 OTA Configuration Commands 9.2.1 OTA Command The protocol for sending/receiving configurations OTA is covered in detail in document xxxxx. A configuration line sent OTA from a host-based server application will have the following basic format: |258,CL| CL is the configuration line as defined in Section 8 above. 9.2.2 SMS Command Sending configuration changes via SMS is covered in the section SMS Text Commands.
MessengerBLE User Guide 9.3 Site Configuration – Type 1 Parameters for Site Configuration Parameter Reference Description Code 1 Site Name Site name to uniquely identify this unit. 2 Daylight Savings 3 Time Zone 4 Next Call Delay 5 Enter Low Power Mode Exit Low Power Mode Modbus Poll Mode 6 7 8 Modbus Scan Rate ASCII Text 30 characters max Used to adjust local time for daylight savings. Local time is used for time stamp of events and display of date/time in debug menu.
MessengerBLE User Guide Parameters for Site Configuration Parameter Reference Description Code Range 0 – 3600 seconds 0 = no delay between successive polls 9 GPS Delta Used to generate a GPS location delta Radius report Range 0 – 5280 ft 10 Vin This threshold sets the point at which the Watchdog power ADC channel watchdog trips and Threshold enables supercap discharge Range 8.0 – 32.0 v 11 Get Time Determines the method for getting the Method system time.
MessengerBLE User Guide 9.4 Options Configuration – Type 2 A value of 0 will disable the option and a value of 1 will enable the option, unless otherwise noted. Parameters for Options Configuration Parameter Reference Description Code 1 Low Power [0-1] Operation 2 Accumulate engine Engine run time is computed run hours from instead of reading from engine engine run state bus. When Run Hours is not available on the bus, enable this option to compute run hours.
MessengerBLE User Guide Parameters for Options Configuration Parameter Reference Description Code 29 Disable reporting When GPS data is not relevant to of GPS data the application, disabling reduces the size of the messages to the host server.
MessengerBLE User Guide 9.5 CELL Configuration – Type 3 These configuration parameters apply to both HSPA (3G) and CDMA (2G) radios, unless otherwise noted. Parameters for Cellular Configuration Parameter Reference Description Code 1 Vehicle ID Unique identifier used in every message transaction with host server. When blank, the IMEI/MEID of the modem is used. Otherwise, characters entered here will serve as the message identifier.
MessengerBLE User Guide Parameters for Cellular Configuration Parameter Reference Description Code 5 Carrier Some modems allow selection of carrier, AT&T or Verizon. A matching SIM is required. Range 0-1 0 = ATT 1 = Verizon 6 Host Server Used to select the TCP/IP protocol Protocol between the system and the host server. 0 = UDP 1 = TCP 7 Primary Host Port Defines port number of primary Number host. Range 0 - 65535 8 Primary Host IP Defines IP address of primary host Address server.
MessengerBLE User Guide Parameters for Cellular Configuration Parameter Reference Description Code 2 = Redundant (switches between primary and secondary servers on a communication failure with either) 49 Default
MessengerBLE User Guide 9.6 FTP Configuration – Type 4 These configuration parameters are used in communications with an FTP server. They apply to both HSPA (3G) and LTE (4G) radios. Parameters for FTP Configuration Parameter Reference Description Code 1 Report Type Report types that can be requested on demand from Over the Air or SMS put = to FTP server get = to Messenger Default 24 = put data log (***.dat.txt) 25 = put event log (***.evt.
MessengerBLE User Guide Parameters for FTP Configuration Parameter Reference Description Code 10 Transfer 0 - active FTP server, 1 - passive Mode 51 Default 1
MessengerBLE User Guide 9.7 GeoFence Configuration – Type 5 A geo-fence defines a geographical boundary, using GPS coordinates to construct a virtual barrier. If this boundary is crossed, the Messenger generates a fence notification event indicating the position of the vehicle relative to the boundary, inside or out. The Messenger supports up to 10 fences. A rectangular geo-fence is defined by 2 corners of a rectangle, top left and bottom right. A circular geo-fence is defined by a center and a radius.
MessengerBLE User Guide 9.8 Serial Port Configuration – Type 6 The Messenger has 6 serial ports (1-6). Port 1 is dedicated to the on-board cellular modem. CAUTION Do not modify the parameters of Port 1. Port 2 is dedicated to the debug function. It is only available via an internal connection and requires a TTL->RS232 converter. Port 3 is dedicated to communications with the internal Bluetooth processor. Port 4 is dedicated to communications with the internal GPS module.
MessengerBLE User Guide Parameters for Serial Port Configuration Parameter Reference Description Code 38400 57600 115200 5 Max Idle Defines the period of inactivity, after reception has started, before the active receive buffer is closed. Range 1 – 32000 msecs 6 Response Maximum time to wait for a response. Timeout Range 1 – 60 seconds 7 RS485 pre-tx Defines the duration of time between delay enabling the RS485 transmitter and starting transmission.
MessengerBLE User Guide 9.9 Reporting Configuration – Type 7 The reporting parameters allow user control over when and why a report is generated. There are 2 basic report types, standard and exception. The standard report is time based and is generated at the Standard Report Interval. An exception report has to be triggered and, once triggered, is generated at the Exception Report Interval for as long as the trigger is true. Some examples of exception triggers are speed over ground and RPM.
MessengerBLE User Guide Parameters for Reporting Configuration Parameter Reference Description Code 0.0 disables the RPM trigger 14 Protocol This defines the delimiter character used Delimiter in the reporting protocol. This will be Character specific to a particular host server application. Reference protocol document “M09-PRTCLxxx”.
MessengerBLE User Guide 9.10 Engine Configuration – Type 8 The Messenger can be used to monitor values presented on a J1939 CAN bus. Parameters for Engine Configuration Parameter Reference Description Code 1 Messenger CAN Address Range 0-255 2 ECM CAN Address Range 0-255 3 Panel CAN Address Range 0-255 4 CAN Baud Range 0-255 5 DM1 Conversion Range 0-255 Method 6 Engine Start The engine enters the “started” state Threshold when the measured RPM exceeds this threshold. Range 50.0 to 2000.
MessengerBLE User Guide Parameters for Engine Configuration Parameter Reference Description Code 11 Max DTC Defines the maximum number of times Count the same DTC will be reported. Range 0 – 126 0 disables reporting of all DTCs 4 Engine Hours If the Messenger is configured to track Preset engine run time, use this number to preset the hours to match actual run hours. Range 0.0 to 999999.0 hours (to the nearest tenth of an hour) 5 Engine Starts The Messenger automatically counts Preset engine starts.
MessengerBLE User Guide 9.11 Channel Configuration – Type 9 Parameters for Analog Channel Configuration (channel numbers 51-300 are pre-defined analog channels) Parameter Reference Description Code 1 Name A representative name to reference the channel by. ASCII Text 30 characters max 2 Mode Defines operating mode of channel.
MessengerBLE User Guide Parameters for Analog Channel Configuration (channel numbers 51-300 are pre-defined analog channels) Parameter Reference Description Code Output Range 0-3 State on 0 = de-activate (open) Alarm 1 = activate (close) 2 = undefined 3 = static (do not change the current state) 4-5 reserved 6 Precision Digits to the right of the decimal point. Affects precision of value displayed and precision of value reported to host server.
MessengerBLE User Guide Parameters for Digital Channel Configuration (channel numbers 1-50 are pre-defined digital channels) Parameter Reference Description Code 1 Name A representative name to reference the channel by. ASCII Text 30 characters max 2 Mode Defines operating mode of channel.
MessengerBLE User Guide Parameters for Digital Channel Configuration (channel numbers 1-50 are pre-defined digital channels) Parameter Reference Description Code Output Range 0-3 State on 0 = de-activate (open) Alarm 1 = activate (close) 2 = undefined 3 = static (do not change the current state) 6 Normal State of input when condition being (Idle) State monitored is normal. 0 – open or > 3.
MessengerBLE User Guide 9.12 Report Flag Configuration – Type 12 There are several report types that can be generated by the Messenger, each with a unique trigger mechanism. Report flags are used to enable specific channel data to be included in specific report types. Parameters for Report Flag Configuration Parameter Report Description Code Type 1 Standard Include all channels that have a (PER) PER report flag set.
MessengerBLE User Guide Defining which channels to be included in which report is step 1. Step 2 is to decide what type of data from that channel to include. Each channel maintains a basic set of data based on channel type, analog or digital (see Channel Data). Channel Type Report Type Analog Standard (PER) Data Types Reported (i.e.
MessengerBLE User Guide 9.13 Date/Time Read/Write – Type 16 This method of setting the RTC in the system is always available but should be used with caution. When GPS or cellular is available, setting time this way can generate unwanted side effects. There is not a real Date/Time configuration. This provides an alternate method for setting date/time OTA.
MessengerBLE User Guide 9.14 MODBUS Configuration – Type 18 Parameters for MODBUS Configuration Parameter Reference Description Code 1 Name A name representative of this data register type ASCII Text 30 characters max 2 Enable Enable 0 = disabled 1 = disabled 20 Slave ID Modbus ID of slave unit Range -1 to 255 -1,0 = disabled 1-227 = for direct connect slave devices 228-239 = reserved 240-255 = for peer to peer devices 22 Modbus Defines the type of data register to Function read/write in the slave.
MessengerBLE User Guide Parameters for MODBUS Configuration Parameter Reference Description Code 23 Weight Used to scale register value when not in engineering units. Scaled = (weight * register value) + offset Floating point value – e.g. 0.25 Range -999999.0 to 999999.0 24 Offset Used to scale register value when not in engineering units. Scaled = (weight * register value) + offset Floating point value – e.g. -25.0 Range -999999.0 to 999999.0 27 Signed Indicates that the register contains a signed value.
MessengerBLE User Guide Parameters for MODBUS Configuration Parameter Reference Description Code 26 Aggregate When reading bit packed registers Mask (function codes 11, 12, 34, and 35) , use this value to mask unwanted bits. A 0 in a bit position clears that bit in the value read. For the remaining bits, when a change from 0 to 1 is detected, an alarm event is generated. If a change from 1 to 0 is detected, a return to normal event is generated.
MessengerBLE User Guide 9.15 Analog Input Configuration – Type 11 Parameters for Analog Input Configuration Parameter Reference Description Code 1 Name A representative name to reference the channel by. ASCII Text 30 characters max 2 Input Analog input type Type 0 = none 1 = 0-20 mA DC 2 = 4-20 mA DC 3 = 0-10 V DC 4 = 0-20 mA DC – custom 5 = 4-20 mA DC – custom 6 = 0-10 V DC – custom 3 k-factor Damping factor Range 0.0 to 1.
MessengerBLE User Guide 9.16 Digital Input Configuration – Type 17 Parameters for Digital Input Configuration Parameter Reference Description Code 1 Name A representative name to reference the channel by.
MessengerBLE User Guide 9.17 Digital Output Configuration – Type 13 Parameters for Digital Output Configuration Parameter Reference Description Code 1 Name A representative name to reference the channel by. ASCII Text 30 characters max 2 Active Define what state is considered the State active state. Used to track number of activations and duration activated.
MessengerBLE User Guide 9.18 EVAL Expression Configuration – Type 10 An expression can be used to calculate a value from inputs/outputs in the system. Some examples would be to scale a value, do units conversion on a value, compute a logical value for activating an output, detecting an alarm, etc. Expressions are user entered and can contain up to 4 operands, A, B, C, and D.
MessengerBLE User Guide Parameters for Expression Configuration Parameter Reference Description Code 11 Constant If operand A is of type constant, this is the value of that constant. Floating point number 12 Variable If operand A is of type variable, this is Data the data register where the value to use Register is stored. Data Register 13 Variable If operand A is of type variable, this Data Type defines the data value to use from that data register, i.e.
MessengerBLE User Guide Parameters for Expression Configuration Parameter Reference Description Code Data Register 33 Variable If operand C is of type variable, this Data Type defines the data value to use from that data register, i.e. raw value, scaled engineering value, etc Data Register Operand D 40 Type Operand D type 0 = none 1 = variable 2= constant 41 Constant If operand D is of type constant, this is the value of that constant.
MessengerBLE User Guide 9.19 J1939 PGN Configuration – Type 15 There are several common PGNs that are pre-defined in the system. The user can also define a different or proprietary PGN for their own application. The maximum number of PGNs supported is 50. Parameters for PGN Configuration Parameter Reference Description Code 1 Name A representative name to reference the PGN by. ASCII Text 30 characters max 2 Enable Is this PGN enabled for reading from the J1939 CAN bus.
MessengerBLE User Guide 9.20 J1939 SPN Configuration – Type 14 Within a PGN message received on the CAN bus are encoded many values. These values are referred to as SPNs. When a PGN message is received, it is decoded by the configuration shown below. The decoded value is stored in the corresponding SPN data register. There are several common SPNs that are pre-defined in the system. The user can also define a different or proprietary SPN for their own application.
MessengerBLE User Guide Parameters for SPN Configuration Parameter Reference Description Code float 9 k-factor Damping factor. Range: 0.0 - 1.0 10 Units A text string representing the engineering units of the value. ASCII Text 11 characters max 77 Default 1.
MessengerBLE User Guide 9.21 PEER Poll Configuration – Type 28 The Messenger can be configured to work in a peer to peer mode with another Messenger. This mode of operation allows a peer to share data directly with another peer. For this to work, all radios in the peer to peer network must be CDMA modems with static IPs. Data is exchanged by a client peer (local) polling a server peer (remote). The protocol used between peers is Modbus RTU.
MessengerBLE User Guide 9.22 PEER Push Configuration – Type 29 This is part of the peer mechanism used to share data between devices in a peer to peer network. This method pushes a data value to a remote peer based on a change in the value. This is a more efficient method than the polling as described in 8.16. Data is exchanged by a client (local) peer pushing (writing) data to a server (remote) peer. The protocol used between peers is Modbus RTU.
MessengerBLE User Guide 5 Debounce Once a trigger condition has been detected, this defines the continuous time that condition must exist before the value is pushed.
MessengerBLE User Guide 9.23 Bluetooth Nordic Configuration – Type 52 Parameters for Bluetooth Configuration Parameter Reference Description Code 1 Device Name that appears in the Name Bluetooth app when connecting to the device. When the device name is the default then a pseudo unique string of hex characters will be appended to “M3_”. ASCII Text 21 characters max 2 Password Password used in Bluetooth pairing.
MessengerBLE User Guide 10 How-To This section provides how-to steps to perform some common functions. 10.1 Setting reporting rates when moving and stationary Setting Standard Reporting Rate – when not exceeding a pre-defined speed over ground, course change or RPM threshold (set to 120 minutes) Exception Reporting Rate – when moving faster than the course over ground limit, course change or RPM limit (set to 300 seconds) 10.
MessengerBLE User Guide 10.3 Enabling low power mode to conserve battery In low power mode, the Messenger turns off the Cellular and GPS modules, stops monitoring all inputs and puts the processor into a very low power mode. The Messenger processor wakes up every 10 seconds to determine if the engine is running – either from CAN activity, J1708 activity or Digital Input 1, whichever is configured to indicate Engine Run.
MessengerBLE User Guide Setting Set Hard Braking alarm limit. For example, set to 7.5 MPH. If the Road Speed drops by more than 7.5 MPH in a second. Set Fast Acceleration alarm limit. For example, set to 4.5 MPH. If the Road Speed increases by more than 4.5 MPH in a second. 10.5 Via SMS, OTA or Debug Port SMS: OTA: $TXT: OTA Messenger Protocol: |258,8,9,7.5| Debug Port: 8,9,7.5 SMS: OTA: $TXT: OTA Messenger Protocol: |258,8,10,4.
MessengerBLE User Guide Setting This allows the Messenger to provide accurate Engine Hours reporting. Set the state of the input to match the engine running signal. For example, Digital Input 1 is considered ‘normal’ when the input is floating or> 3.0V and ‘notnormal’ when it is grounded. ‘Notnormal’ would indicate the engine is running. Digital input 1 is channel 4. Set the Norm state = 0 (6,0) if the signal goes to ground when the engine is running.
MessengerBLE User Guide 10.6 Using the Analog Input for Fuel Level Fuel Level is frequently not available via the J1939 or J1708 bus. If the Fuel Level sender provides an analog value that represents the level in the tank in a linear fashion, the Analog Input on the Messenger can be configured to provide the Fuel Level. Setting Configure the Analog Input 1-10V (6,8) For example, if 0.6V corresponds to 0 pcercent and 4.7V corresponds to 100 percent.
MessengerBLE User Guide 12 Appendix A – Monitored Engine Parameters Engine Parameter AMBER Lamp Check Eng RED Lamp Eng Shutdown PTO State Chan# 11 J1939 PGN SPN 10 16 Fan Drive State 17 Fuel Level 51 RPM 52 Engine Hours 53 Coolant Temperature Battery voltage or Electrical potential Oil Pressure 56 59 Fuel Rate 60 Vehicle Distance 79 Oil Level 90 Oil Temperature 91 Coolant Level 92 Average Fuel Economy Instantaneous Fuel Economy Throttle Position 93 57 94 95 87 6526 5 6521 3 65
MessengerBLE User Guide Engine Parameter Road Speed Chan# 96 Barometric Pressure Cabin Temperature Ambient Temperature Accelerator Pedal Position Air Filter Differential Pressure Engine Load 110 Engine Torque 111 Engine Fuel Temp Estimated Fan Speed Diagnostic Message, Single Diagnostic Message, Multiple 151 Transmission Oil Temp Total kW Hours Export Total Reactive Power Overall Power Factor Total Real Power Avg Line-Line AC RMS Voltage 105 106 107 108 109 152 None None 153 251 252 253 254 255
MessengerBLE User Guide Engine Parameter Avg Line-Neutral AC RMS Voltage Avg AC Frequency Avg AC RMS Current DPF Passive Regen Status DPF Active Regen Status DPF Active Regen Inhibit Status DPF Active Regen Inhibit Switch DPF Active Regen Inhibit Temp Lockout DPF Active Regen Inhibit Perm Lockout DPF Auto Active Regen Config DPF1 Conditions Not Met For Regen DPF1 Soot Load Chan# 256 257 258 40 41 42 J1939 PGN SPN 6503 2444 0 6503 2436 0 6503 2448 0 6489 3699 2 6489 3700 2 6489 3702 2 43 6489 2 3703 4
MessengerBLE User Guide Engine Parameter DPF2 Elapsed Time Regen AT2 DPF Regen Threshold DPF Lamp Cmd Chan# 266 267 268 DPF Status 269 Exhaust High Temp Lamp Cmd Trip Fuel 270 271 Total Fuel 272 AT1 DEF Tank Level 1 AT1 DEF Tank Level 2 AT Catalytic Reduction Active Engine Wait Start Lamp Engine Protection Shutdown Engine Protection Near Shutdown Engine Protection Coolant Level Status 273 274 275 276 277 J1939 PGN SPN 6489 3724 0 6489 5467 0 6489 3697 2 6489 3701 2 6489 3698 2 6525 182 7 6525 250
MessengerBLE User Guide 13 Appendix B – Data Registers /**************************************************************************** * Defined register addresses for all data values in the system. * These addresses are used to retrieve the respective values * for use in computations and for updating values in channels.
MessengerBLE User Guide /*________________ Supported PGNs _______________*/ Name DATA_REG_PGN_DM1 DATA_REG_PGN_TPCM DATA_REG_PGN_TPDT DATA_REG_PGN_TSC1 DATA_REG_PGN_EEC1 DATA_REG_PGN_ET1 DATA_REG_PGN_EFL_P1 DATA_REG_PGN_LFE DATA_REG_PGN_VEP DATA_REG_PGN_DD DATA_REG_PGN_HOURS DATA_REG_PGN_VD DATA_REG_PGN_VDHR DATA_REG_PGN_CCVS DATA_REG_PGN_ATS1 DATA_REG_PGN_ATS2 DATA_REG_PGN_DPCFC1 DATA_REG_PGN_LFC DATA_REG_PGN_AT1T1L DATA_REG_PGN_SHUTDN DATA_REG_PGN_AMB DATA_REG_PGN_EEC2 DATA_REG_PGN_IC DATA_REG_PGN_TF DATA
MessengerBLE User Guide /*______________ Supported SPNs _________________*/ Name Data Register Number 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 DATA_REG_SPN_DM1_DTC DATA_REG_SPN_DM1_RED_STOP_LAMP DATA_REG_SPN_DM1_AMBER_WARN_LAMP DATA_REG_SPN_DM1_PROTECT_LAMP DATA_REG_SPN_DM1_MIL_LAMP DATA_REG_SPN_TSC1_REQ_SPEED DATA_REG_SPN_TSC1_REQ_TORQUE DATA_REG_SPN_EEC1_
MessengerBLE User Guide Name Data Register Number 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 DATA_REG_SPN_AT1_DEF_TANK_LEVEL1 DATA_REG_SPN_AT1_DEF_TANK_LEVEL2 DATA_REG_SPN_AT1_CATALYTIC_RED_ACT DATA_REG_SPN_ENG_WAIT_START_LAMP DATA_REG_SPN_ENG_PROT_SHUTDOWN DATA_REG_SPN_ENG_PROT_NEAR_SHUTDN DATA_REG_SPN_ENG_PROT_COOL_LVL_ST DATA_REG_SPN_AMB_BAR_PRESS
MessengerBLE User Guide Name Data Register Number 698 699 700 DATA_REG_SPN_SVC_TMR14 DATA_REG_SPN_SVC_TMR15 DATA_REG_SPN_SVC_TMR16 95 Description
MessengerBLE User Guide /*___________ Geo-Fences ____________*/ Name Data Register Number 900 901 902 903 904 905 906 907 908 909 DATA_REG_GFC1 DATA_REG_GFC2 DATA_REG_GFC3 DATA_REG_GFC4 DATA_REG_GFC5 DATA_REG_GFC6 DATA_REG_GFC7 DATA_REG_GFC8 DATA_REG_GFC9 DATA_REG_GFC10 Description /*______________ Computed Values ________________*/ Name Data Register Number 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 DATA_REG_EVAL1 DATA_REG_EVAL2 DATA_REG_EVAL3 DATA_REG_EVAL4 DATA_REG_EVAL5 DATA_REG_EVAL6 DATA_
MessengerBLE User Guide Name DATA_REG_CHAN_AS_EN DATA_REG_CHAN_AS1_INPUT DATA_REG_CHAN_AS2_INPUT DATA_REG_CHAN_DPF_PASS_REGEN_STATUS DATA_REG_CHAN_DPF_ACT_REGEN_STATUS DATA_REG_CHAN_DPF_ACT_REGEN_INH_STATUS DATA_REG_CHAN_DPF_ACT_REGEN_INH_SWX DATA_REG_CHAN_DPF_ACT_REGEN_INH_TEMP_LOCKOUT DATA_REG_CHAN_DPF_ACT_REGEN_INH_PERM_LOCKOUT DATA_REG_CHAN_DPF_AUTO_ACT_REGEN_CFG DATA_REG_CHAN_DPF1_COND_NOT_MET_FOR_REGEN Data Register Number 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 Description /*_______
MessengerBLE User Guide Name Data Register Number 3033 3034 3035 3036 3037 3038 3039 3040 3041 3042 3043 3044 3045 3046 3047 3048 3049 3050 3051 3052 3053 3054 3055 3056 3057 3058 3059 3060 3061 3062 3063 3064 3065 3066 3067 3068 3069 3070 3071 3072 DATA_REG_CHAN_ENG_OIL_TEMP DATA_REG_CHAN_COOLANT_LEVEL DATA_REG_CHAN_AVG_FUEL_ECON DATA_REG_CHAN_INST_FUEL_ECON DATA_REG_CHAN_THROTTLE_POS DATA_REG_CHAN_VEH_SPEED DATA_REG_CHAN_BAR_PRESS DATA_REG_CHAN_CAB_TEMP DATA_REG_CHAN_AMB_TEMP DATA_REG_CHAN_ACCEL_PEDAL_P
MessengerBLE User Guide /*______________ MODBUS Registers ________________*/ Name DATA_REG_MBUS1 DATA_REG_MBUS2 ---DATA_REG_MBUS100 Data Register Number 5000 5001 --5099 99 Description
MessengerBLE User Guide 14 Appendix C – Regulatory Information FCC ID: CN24102 IC: 1007A-4102 Human Exposure Compliance Statement Pursuant to 47 CFR § 24.52 of the FCC Rules and Regulations, personal communications services (PCS) equipment is subject to the radio frequency radiation exposure requirements specified in § 1.1307(b), § 2.1091 and § 2.1093, as appropriate.
MessengerBLE User Guide occur in a particular installation. If this equipment does cause harmful interference to radio or television reception, which can be determined by turning the equipment off and on, the user is encouraged to try to correct the interference by one or more of the following measures: — Reorient or relocate the receiving antenna. —Increase the separation between the equipment and receiver.
MessengerBLE User Guide Cattron (formerly Antx) 3005 Glacier Pass Lane Cedar Park, TX 78613 P: 512-255-2800 F: 512-255-8306 www.cattron.