Cattron Messenger BLE, User Manual

Page 1: ...Messenger BLE User s Guide Version 1 0 38 September 30 2020 ...

Page 2: ...2 MessengerBLE User Guide ...

Page 3: ...d Syntax 31 7 Modbus 34 7 1 RTU Slave 34 7 2 RTU Master 34 8 Debug Menu 35 9 Configuration 36 9 1 Debug Configuration Commands 38 9 2 OTA Configuration Commands 42 9 3 Site Configuration Type 1 43 9 4 Options Configuration Type 2 45 9 5 CELL Configuration Type 3 47 9 6 FTP Configuration Type 4 50 9 7 GeoFence Configuration Type 5 52 9 8 Serial Port Configuration Type 6 53 9 9 Reporting Configurati...

Page 4: ...e battery 83 10 4 Setting hard acceleration deceleration alarms 83 10 5 Using a Digital Input to Determine Engine On 84 10 6 Using the Analog Input for Fuel Level 86 12 Appendix A Monitored Engine Parameters 87 13 Appendix B Data Registers 91 Table of Figures Figure 1 Deutsch EEC Thermoplastic Enclosure Dimensions 12 Figure2 Messenger with Enclosure End Cap Attached 13 Table of Tables Table 1 DIP ...

Page 5: ...his manual may contain other proprietary notices and copyright information that should be observed Information in this document is subject to change without notice The software described in this document is furnished under a license agreement or nondisclosure agreement The software may be used or copied only in accordance with the terms of those agreements No part of this publication may be reprod...

Page 6: ...ial communications to external devices Features The hardware feature set of this platform includes ARM 32 bit Cortex M4 Core w FPU 2 MB of on board FLASH memory 8MB of external FLASH 640kB of on board SRAM memory 512kB of external battery backed SRAM Real Time Clock battery backed 2 Serial Ports RS485 only 4 Digital Inputs user configurable for voltage or grounded input 3 Digital Outputs open coll...

Page 7: ...tted based on time or notification events Notification events are based on rules set by the user and each event can generate an immediate report Telemetry includes cellular connectivity and GPS for asset location Monitored data values are mapped to fixed channels in the Messenger A channel defines a set of attributes for the monitored data for doing calculations alarm detection data formatting and...

Page 8: ... Power on or reset 1 3 1 Event Codes Every message sent by the Messenger to a host based server application is triggered by an event The event generates a message and the message contains an Event Code The Event Code uniquely identifies to the server the reason the message is being sent Some of the messages generated contain data others serve as just notification that a particular event has occurr...

Page 9: ...time differs from actual time by more than 30 seconds the RTC time will be adjusted The RTC can be set in one of the following ways Method Description Automatic via Cell This is the default setting The Messenger will set the RTC from an internet NIST time server Automatic via GPS The Messenger will set the RTC from the date time read from the GPS module Manually Set the time via the Debug port thr...

Page 10: ...put or grounded input user selectable high speed pulse counter inputs user selectable current limited overvoltage protection Analog inputs 3 ea 12 bit ADC accuracy 2 FS input ranges 0 10vdc 0 20mA 4 20mA user selectable CAN input 1 ea termination resistor user selectable spike suppression Serial RS485 inputs 2 ea termination resistor user selectable current limited overvoltage protection Bluetooth...

Page 11: ...s 3 Connect Main Power 4 Connect to engine bus J1939 5 Confirm that the Amber LED indicates normal CAN activity when the engine is started If it does not check the following a Confirm there is proper termination on the main CAN bus trunk b Double check the bus connections and signal polarity 2 2 Unpacking the Equipment The Messenger is shipped with the following The Messenger electronics housed in...

Page 12: ...ended 2 4 Mounting the Antenna The antenna shipped with the Messenger is a hockey puck style combination cell and GPS The GPS antenna frequency is 1575 42MHz The cell is a dual band antenna 880MHz 960MHz and 1710MHz 1990MHz The antenna can be ordered with a magnetic or a screw mount base In general the antenna should be mounted with an unobstructed view of the sky The GPS side works best when it c...

Page 13: ...ough 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 Figure 2 Messenger with Enclosure End Cap Attached ...

Page 14: ...ed the power must be cycled for the new switch positions to be read Table 1 DIP Switch 3 Decode Position 1 2 3 4 Description Function Enter BOOT Loader Used for code download via internal debug port RS232 57600 8 1 N Factory Default Settings Key switch in OFF position switch in ON position NOTE Switch positions 1 and 2 will override any other settings for Ports 2 3 or 4 ...

Page 15: ...pending on the customer input output requirements there may be 1 or 2 cable harnesses supplied for the customer to connect to his field signals The IO signals available in the Messenger are diagrammed below indicating how to connect field signals to the Messenger using these cables Custom cable configurations can be made to facilitate field wiring Contact the factory for assistance There are 3 IO ...

Page 16: ...male M12 8 Pin Male M12 WHT WHT RED RED BRN BRN GRN GRN BLU BLU YEL YEL PNK PNK GRY GRY V 8 36vdc GND CAN L CAN H Cables PVC Jacket PVC Conductor Insulation 8x22 2A 60VAC 75VDC Temp 40C to 105C Protection NEMA 1 3 4 6P IP68 and IP69K USER IO 3 USER IO 2 USER IO 1 DIN 3 AIN 2 DIN 2 GND DIN 4 DIN 1 AIN 1 P1 RS485B P1 RS485A 1 2 3 4 5 6 7 8 1 2 3 4 5 6 7 8 Table 5 User IO 1 Jumper Selection J11 User ...

Page 17: ...17 MessengerBLE User Guide Figure 4 User IO Jumper Location If digital outputs DOUT1 DOUT2 or DOUT3 are to be used in the application ...

Page 18: ... Radio Provider Options Account Type Static IP SIM APN Username Password Server IP Port HSPA 3G AT T Verizon Data SMS required required required optional required LTE 4G AT T Verizon Data SMS required required required optional required 2 9 Bluetooth Setup The Messenger uses a dedicated processor for facilitating Bluetooth Low Energy connections The hardware offers two antenna options a chip anten...

Page 19: ...ften the OK state 3 blinks are to convey that there is an issue that may need attention 2 blinks are used as needed to convey a state that may be of interest to the user no blinks LED solid on or off indicates the system is no longer functioning verify option to turn LED off is disabled contact factory for assistance Status LED Behavior The Status LED will cycle through blinking each color the app...

Page 20: ...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 Figure 5 IO Architecture Diagram ...

Page 21: ...nnel in the Messenger is referenced by a fixed channel number e g RPM is always channel 52 There is a set of pre defined channels numbers 1 300 and a set of user defined channels numbers 301 350 The user defined channels can be configured to represent any data value in the system The pre defined channels have the data source parameter already set 5 1 Pre Defined Channels The following channels are...

Page 22: ...0 voltage 3vdc 5 User DIN3 Digital If SWX4 3 closed 0 input open 1 input voltage 1vdc If SWX4 3 open 1 input open 0 input voltage 3vdc 6 User DIN4 Digital If SWX4 4 closed 0 input open 1 input voltage 1vdc If SWX4 4 open 1 input open 0 input voltage 3vdc 9 Engine Run Digital Engine run state 1 on 0 off run if RPM start threshold 10 Shutdown Digital CAN J1587 Red LED Engine Shutdown Indicator 11 Wa...

Page 23: ...tive Regeneration Inhibit Status Digital Support for tier 4 diesel engines 43 DPF Active Regeneration Inhibit Switch Digital Support for tier 4 diesel engines 44 DPF Active Regeneration Inhibit Temp Lockout Digital Support for tier 4 diesel engines 45 DPF Active Regeneration Inhibit Perm Lockout Digital Support for tier 4 diesel engines 46 DPF AutoAct Regeneration Config Digital Support for tier 4...

Page 24: ...lled odometer 81 Engine Starts Analog Accumulated count of engine starts 82 Idle Time Analog Accumulated time the engine RPM has been between the Engine Start Threshold and Idle Threshold seconds since last start 83 Idle Fuel Analog Accumulated fuel used during Idle Time gallons 84 Work Time Analog Accumulated time the engine RPM has been above the Idle Threshold seconds since last start 85 Work F...

Page 25: ...10 Engine Load Analog in percent 111 Engine Torque Analog in percent 118 Daily Distance Traveled Derived Accumulated distance travelled for the day 119 Daily Fuel Used Derived Accumulated fuel used for the day 120 Trip Distance Traveled Derived Accumulated distance travelled for last trip trip defined as engine on to engine off 121 Trip Fuel Used Derived Accumulated fuel used for last trip trip de...

Page 26: ...active Power Analog in KVAr 252 Generator Overall Power Factor Analog 253 Generator Total Real Power Analog in kW 254 Generator Average Line Line AC RMS Voltage Analog in V 255 Generator Average Line Neutral AC RMS Voltage Analog in V 256 Generator Average AC Frequency Analog in Hz 257 Generator Average AC RMS Current Analog in A 258 259 Spare undefined 260 DPF1 Soot Load Analog Support for tier 4...

Page 27: ...ort for tier 4 diesel engines 270 Exh High Temp Lamp Cmd Analog Support for tier 4 diesel engines 271 Eng Trip Fuel Analog Support for tier 4 diesel engines 272 Eng Total Fuel Analog Support for tier 4 diesel engines 273 AT1 Def Tank Level 1 Analog Support for tier 4 diesel engines 274 AT1 Def Tank Level 2 Analog Support for tier 4 diesel engines 275 AT Cat Reduction Active Analog Support for tier...

Page 28: ...28 MessengerBLE User Guide Channel Number Channel Name Type Source Data Register Description 290 300 Spare Start User Defined Channels 301 350 User Defined User Defined Analog or Digital channels ...

Page 29: ...tate secs There are a few channels that can be configured for special functions All the physical digital input channels can be configured to accept pulse inputs e g from a flow meter and the physical analog inputs can be used to totalize volume when the input is a flow rate These channels have an extended data set Extended Data Set For the analog channel Daily total volume available on channel 154...

Page 30: ...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 ...

Page 31: ...ssenger to connect to remote diagnostic utility Contact factory for assistance ip IP address of PC that the diagnostic utility is running on port port number on the PC that the IP address is bound to s spare leave blank ACTION x request to execute action identified by action number x action number Table 4 Action Commands Action Number Action Description Response 1 Generate on demand standard repor...

Page 32: ...Return SIM card info SIM info 32 Clear ADC channel daily flow totals ack 33 Clear ADC channel running flow totals ack 35 Return CELL Status CELL status 40 43 OEM Specific 50 55 Initiate Modbus control sequence 99 Force Hardware Reset ack Action Responses ack text v r c status text VID v CELL i s REG r g RSSI GPS p JBUS j m n DATAQ d e f OUTP a b SWX x MSGS f c VER v date prot modem jbus VID v vehi...

Page 33: ... 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 ...

Page 34: ...values to the Messenger from a MODBUS Master These written values can then be transferred to a channel for alarming or logging for telemetry The Modbus register map for all channel data values is available on request Reference document number Messenger MODBUS Slave Register Map 7 2 RTU Master When configured as a Modbus RTU Master device the Messenger reads register values from Modbus Slave device...

Page 35: ...ir connection using the Antx Remote Diagnostic utility This utility is available on request DIP Switch 2 can be used to force a direct connect serial port into Debug mode NOTE Once connected press the Enter key to see the Main Menu example below Messenger ANTX G2 J1939 Version v6 4 2 A 09 26 15 Date Time 11 10 15 14 24 03 Asset ID 011998000279820 MSISDN 15332791849 Local IP 10 115 17 6 CELL RSSI 1...

Page 36: ...tten using text strings with commas to separate values in the string This basic format is the same for all methods listed above Some of the methods put a wrapper around the configuration line to aid in transport and decoding on the receive end The basic configuration line CL format is described below CL x i y zzzz y zzzz y zzzz y zzzz Where the commas are required as the delimiter between value fi...

Page 37: ... alarm parameters for channels Channel Number Range 1 400 10 Expressions Mathematical expressions Expression Index Range 1 10 11 Analog Inputs Physical analog inputs ADC input Range 1 6 12 Report Flags Defines data types to include in reports to the host server Channel Number Range 1 400 13 Digital Outputs Physical digital outputs Digital Output Range 1 3 14 J1939 SPN Parameters specific to PGNs o...

Page 38: ...and This is the read configuration command format 255 x i CR Where 255 is the read command x is the configuration line type code i is an optional index that is a function of the line type code see Table 5 CR is a line terminating carriage return Some examples using the READ command Examples 255 1 CR Prints Site config 255 8 CR Prints Engine config 255 6 1 CR Prints Serial Port 1 config 255 6 255 C...

Page 39: ...onfig config 255 8 Returns Engine config config 255 6 1 Returns Serial Port 1 config config 255 6 255 Invalid SMS Read command config 255 255 Invalid SMS Read command CAUTION The read all command 255 255 does not function via SMS due to SMS message size constraints ...

Page 40: ...dex that is a function of the line type code see Table 5 CR is a line terminating carriage return Some examples using the RESET command Examples 256 1 CR Reset Site config 256 8 CR Reset Engine config 256 6 1 CR Reset Serial Port 1 config 256 6 256 CR Reset all Serial Port configs 256 256 CR Reset System config CAUTION The reset all command 256 256 should be used with caution All communications wi...

Page 41: ...dex j is a required ending index greater than i NOTE the range of indexes from i to j is inclusive and by definition are sequential y is a parameter code identifying the configuration parameter that follows zzzz is the configuration parameter this parameter could be an integer a floating point number or a text string as defined by the parameter code y Some examples using the GLOBAL command Example...

Page 42: ... 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 When a configuration line is sent via SMS message it will have the following basic format config CL For all other methods listed above the configuration line will have the following format Configuratio...

Page 43: ...r display and event log timestamps Central 3 Range 0 7 0 UTC 1 Atlantic 2 Eastern 3 Central 4 Mountain 5 Pacific 6 Alaska 7 Hawaii 4 Next Call Delay This delay is enforced between successive attempts to connect and send data to host server 10 Range 1 32000 seconds 5 Enter Low Power Mode This is the delay to enter low power mode 240 Range 60 3600 seconds 6 Exit Low Power Mode This is the delay to e...

Page 44: ...ius Used to generate a GPS location delta report 200 ft Range 0 5280 ft 10 Vin Watchdog Threshold This threshold sets the point at which the power ADC channel watchdog trips and enables supercap discharge 10 8 v Range 8 0 32 0 v 11 Get Time Method Determines the method for getting the system time Cell 1 Range 0 4 0 Internet NTP server 1 Cell Modem 2 GPS 3 BLE 4 None User input ...

Page 45: ...ration to allow run hours to match the last known run time 0 3 Turn off all LEDs except System 0 1 0 4 Add Msg Checksum Add checksum to data records sent to host server 0 5 Set RTC From GPS If enabled will set the system clock from the GPS clock The AUTO TIMESET parameter in the cell config will set the system clock from an internet time server Enable only one of these parameters 0 6 Use DIN1 as E...

Page 46: ... Parameters for Options Configuration Parameter Code Reference Description Default 29 Disable reporting of GPS data When GPS data is not relevant to the application disabling reduces the size of the messages to the host server 0 ...

Page 47: ...e between the system and the host server when sending messages 1 Range 0 2 0 Messages are sent and no ACK response expected 1 When the system sends a message it waits for an ACK response from the host server 2 A fixed offset 10000 is added to an event code to indicate to the host server that the system is expecting an ACK response 3 Auto Time Set Enables setting of the system clock RTC via interne...

Page 48: ...Address Defines IP address of primary host server Order specific 127 characters max Can be entered in DNS or dotted decimal format 9 Secondary Host Port Number Defines port number of secondary host Order specific Range 0 65535 10 Secondary Host IP Address Defines IP address of secondary host server Order specific 127 characters max Can be entered in DNS or dotted decimal format 12 APN 63 character...

Page 49: ...MessengerBLE User Guide Parameters for Cellular Configuration Parameter Code Reference Description Default 2 Redundant switches between primary and secondary servers on a communication failure with either ...

Page 50: ...txt Filenames for Put commands are automatically generated as vehicleID mmddyyhhmm ext txt Ex MyTruck0301081322 cfg txt 2 Put path on server 63 characters e g msngr elogs 3 Get path on server 63 characters e g msngr elogs or for the root directory 4 Get filename 63 characters e g MyEventLog txt blank 5 Report Rate Frequency in minute If this is a value greater than 0 then any reports via cellular ...

Page 51: ...51 MessengerBLE User Guide Parameters for FTP Configuration Parameter Code Reference Description Default 10 Transfer Mode 0 active FTP server 1 passive 1 ...

Page 52: ...ameter Code Reference Description Default 1 Type Defines the geometry of the geographical boundary Disabled 0 0 disabled 1 rectangular 2 circular 2 Top Left Latitude Top left corner of rectangle latitude Range 90 000000 to 90 000000 deg 3 Top Left Longitude Top left corner of rectangle longitude Range 180 000000 to 180 000000 deg 4 Bottom Right Latitude Bottom right corner of rectangle latitude Ra...

Page 53: ... with the internal GPS module Port 5 is user port 1 available as RS485 only Port 6 is user port 2 available as RS485 only CAUTION Not all parameters shown below apply to every port Parameters for Serial Port Configuration Parameter Code Reference Description Default 1 Enable Use to enable disable the port Port Specific 0 disables 1 enables 1 Mode Defines the port function Port Specific Range 0 2 0...

Page 54: ... the duration of time between enabling the RS485 transmitter and starting transmission 16 Range 0 31 bit times 8 RS485 post tx delay Defines the duration of time after transmission of the last character to disabling the RS485 transmitter 16 Range 0 31 bit times 9 Data Bits Defines the number of data bits in the serial stream NOTE If parity is set to even or odd number of data bits must be set to 9...

Page 55: ...End of Day Rate Interval between end of day reports 1440 Range 0 1440 mins 0 disables end of day reports 3 Standard Report Rate Defines the interval at which Standard Reports are generated 60 Range 0 1440 minutes 0 disables standard reports 4 Speed Over Ground Threshold Defines the vehicle speed necessary to trigger exception reporting 0 0 Range 0 0 to 200 0 MPH 0 0 disables the speed over ground ...

Page 56: ...otocol Start Message Character This defines the start of message character used in the reporting protocol This will be specific to a particular host server application Reference protocol document M09 PRTCLxxx 0 null character Entered as a numeric value Restrictions 1 cannot be a letter of the alphabet 2 cannot be a number 3 cannot be the same as the protocol delimiter character 4 cannot be one of ...

Page 57: ...hreshold defines 2 states once the engine has started idle and work If the RPM is less than or equal to this threshold engine is idling else engine is working 950 0 Range 100 0 to 2000 0 RPM 17 Fuel Level Delta If the fuel level drops by more than this delta over a fixed time an event is generated Fuel Level must be available on the engine bus If the level drops more than this delta in 5 minutes t...

Page 58: ... engine run time use this number to preset the hours to match actual run hours 0 0 Range 0 0 to 999999 0 hours to the nearest tenth of an hour 5 Engine Starts Preset The Messenger automatically counts engine starts Use this number to preset starts to match actual starts 0 Range 0 to 999999 12 Odometer Preset If the Messenger is configured to compute odometer distance travelled use this number to p...

Page 59: ... monitored and tested against limits 3 Alarm Delay The continuous time the value must exceed a limit before it is considered to be in violation of that limit 10 Range 0 65535 seconds 0 no delay time immediate alarm Source Data Register This defines the source register of the value for this channel Reference Appendix B 10 Delta Threshold 10 Delta Debounce 10 Alarm Output Data Register An output dat...

Page 60: ...cision of value reported to host server Channel Specific Range 0 8 7 Low Warning Limit Low warning limit 1 0 Floating point value e g 15 2 Range 999999 0 to 999999 0 1 0 disables limit 8 Low Alarm Limit Low alarm limit should be less than low warning 1 0 Floating point value e g 12 8 Range 999999 0 to 999999 0 1 0 disables limit 9 High Warning Limit High warning limit 1 0 Floating point value e g ...

Page 61: ...red and tested against limits 3 Alarm Delay The continuous time the value must exceed a limit before it is considered to be in violation of that limit 10 Range 0 65535 seconds 0 no delay time immediate alarm Source Data Register This defines the source register of the value for this channel Reference Appendix B 10 Delta Debounce 10 Alarm Output Data Register An output data register that can be set...

Page 62: ...do not change the current state 6 Normal Idle State State of input when condition being monitored is normal Normally Open 0 0 open or 3 0V 1 closed to ground 7 Modbus slave bit packed position bitpos Read Only 8 Duration Limit A limit on the accumulated time that this input is not normal 1 Range 1 to 9999999 seconds 1 disables limit 9 Starts Limit A limit on the number of times the input transitio...

Page 63: ...and DEM Include all channels with this flag in response to a poll request On demand poll request from server 3 End of Day EOD Include all channels that have an EOD report flag set Midnight UTC Time or on demand 4 Trip TRIP Defined as engine on to engine off Include all channels that have a TRIP report flag set Engine off 5 SMS911 SMS Include all channels that have the SMS report flag set This repo...

Page 64: ...Standard PER 0 none 1 current value 2 current value current max min 3 undefined End of Day EOD 0 none 1 current value 2 current value daily max min 3 undefined Trip TRIP 0 none 1 current value 2 current value trip max min 3 undefined Digital Standard PER 0 none 1 current value 2 current value counts duration 3 undefined End of Day EOD 0 none 1 current value daily counts daily duration 2 current va...

Page 65: ... an alternate method for setting date time OTA Parameters for Date Time Configuration Parameter Code Reference Description 1 Time Enter as hours minutes and seconds Format hhmmss Use 2 digits for each 2 Date Enter as month day and year Format mmddyy Use 2 digits for each 3 Time Zone Local time zone Range 0 7 0 UTC 1 Atlantic 2 Eastern 3 Central 4 Mountain 5 Pacific 6 Alaska 7 Hawaii 4 Day Light Sa...

Page 66: ...peer devices 22 Modbus Function Code Defines the type of data register to read write in the slave None 0 0 None 1 Read Coil 1 bit 2 Read Status 1 bit 3 Read Holding 16 bit 4 Read Input 16 bit 5 Write Coil 1 bit 6 Write Holding 16 bit 15 Write Multiple Coil 1 bit 16 Write Multiple Holding 16 bit 21 Register Number Register number in slave to read write 1 Range 1 65535 21 Register Type 0 Range 0 7 0...

Page 67: ... value offset 0 0 Floating point value e g 25 0 Range 999999 0 to 999999 0 27 Signed Indicates that the register contains a signed value Not Signed 0 1 register signed 0 register not signed 27 Display Precision Number of significant digits to print Not Signed 0 Range 0 8 25 Endian When reading double registers this defines the byte ordering in the register pair Example Double register value hex 0x...

Page 68: ...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 This makes it possible for an alarm and normal event to be generated for the same channel at the same time ffffffff Hexadecimal value e g ffff1afc Range 0 ffffffff 26 Bit Number When reading bit packed registers function codes 11 12 34 and 35 use this val...

Page 69: ...s max 2 Input Type Analog input type 4 20 mA 2 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 0 75 Range 0 0 to 1 0 4 Offset custom scaling Custom scaling offset when input type is custom 4 5 or 6 0 0 Range 99 999 999 to 99 999 999 5 Bit Weight custom scaling Custom scaling bit weight when input type is custom 4 5 o...

Page 70: ...efault 1 Name A representative name to reference the channel by C ASCII Text 30 characters max 2 Type Input type Channel Specific 0 none 1 digital input 2 pulse input 20 Debounce Debounce of both rising and falling edges applies to digital input type only 8 Range 1 to 255 22 Pull Up Enable Pull up the input 1 0 de activate pull up 1 activate pull up ...

Page 71: ...tivated Channel Specific 0 open 1 close 2 3 do nothing 3 Source Define the source of the value that should drive this output 8 Range valid data register 4 Pulse Duration Defines the duration that the output will stay in the activated state 1 0 de activate pull up 1 activate pull up 5 Output State When Source Value is 1 Defines the state of the output when the source data register value 1 1 0 open ...

Page 72: ...ption Default 1 Name A representative name to reference the expression by C ASCII Text 30 characters max 2 Enable Defines whether or not this expression will be evaluated 0 0 disabled 1 enabled 3 Evaluation Order There are 2 levels of expression evaluation Level 2 is only necessary if an intermediate value must first be calculated 8 1 evaluate first 2 evaluate second 4 Evaluation Type Defines the ...

Page 73: ...rand B type 1 0 none 1 variable 2 constant 21 Constant If operand B is of type constant this is the value of that constant 1 0 Floating point number 22 Variable Data Register If operand B is of type variable this is the data register where the value to use is stored 1 0 Data Register 23 Variable Data Type If operand B is of type variable this defines the data value to use from that data register i...

Page 74: ...a Register Operand D 40 Type Operand D type 1 0 none 1 variable 2 constant 41 Constant If operand D is of type constant this is the value of that constant 1 0 Floating point number 42 Variable Data Register If operand D is of type variable this is the data register where the value to use is stored 1 0 Data Register 43 Variable Data Type If operand D is of type variable this defines the data value ...

Page 75: ...r of PGNs supported is 50 Parameters for PGN Configuration Parameter Code Reference Description Default 1 Name A representative name to reference the PGN by C ASCII Text 30 characters max 2 Enable Is this PGN enabled for reading from the J1939 CAN bus 0 no 1 yes 3 Number Number defined by the SAE 4 SPN List A listing of SPNs that should be extracted from this PGN The maximum number of SPNs is 16 8...

Page 76: ...presentative name to reference the SPN by C ASCII Text 30 characters max 2 Enable Is this SPN enabled for decoding from a received PGN 0 no 1 yes 3 Number Unique number defined by the SAE 4 Type The value decoded from the PGN message will be of this type 8 0 none 1 digital 2 bits no scaling 2 numeric a numeric value only no scaling 3 analog requires scaling 4 text treat as string value 5 other 5 S...

Page 77: ... Parameters for SPN Configuration Parameter Code Reference Description Default float 9 k factor Damping factor 1 0 Range 0 0 1 0 10 Units A text string representing the engineering units of the value ASCII Text 11 characters max ...

Page 78: ...on parameters in a Modbus channel 1 Set the slave ID to match one of the predefined peer IDs 240 to 255 This ID corresponds to one of the 16 possible peer configurations i e 240 references Peer 1 241 references Peer 2 etc 2 If reading an analog value set the Function Code to READ FLOAT If reading a digital value set the Function Code to READ COIL 3 Set the Register Number to the channel number in ...

Page 79: ...predefined peer IDs 240 to 255 This reserves this channel to receive a pushed value 2 If receiving an analog value set the Function Code to READ FLOAT If receiving a digital value set the Function Code to READ COIL Parameters for Peer Push Configuration Parameter Code Reference Description Default 1 Source Channel Number Defines a channel number in the local peer as the source of the data 0 Range ...

Page 80: ...80 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 10 Range 0 to 3600 seconds ...

Page 81: ...iption Default 1 Device Name Name that appears in the 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_ Messenger3 ASCII Text 21 characters max 2 Password Password used in Bluetooth pairing 268928 ASCII Text Numbers only 6 characters exactly ...

Page 82: ...rotocol 258 7 2 120 3 300 Debug Port 7 2 120 3 300 10 2 Computing Engine Hours from Engine Run Occasionally the J1939 or J1708 bus does not have the Engine Hours parameter available The Messenger can be configured to compute the Engine Hours from the RPM parameter The steps to set this up follow Setting Via SMS OTA or Debug Port Set the Messenger to Compute Engine Hours SMS config 2 4 1 OTA TXT co...

Page 83: ...onfig 2 1 1 OTA Messenger Protocol 258 2 1 1 Debug Port 2 1 1 Set time delay to enter low power mode to 120 seconds enterlp SMS config 1 4 120 OTA TXT config 1 4 120 OTA Messenger Protocol 258 1 4 120 Debug Port 1 4 120 Set time interval to exit low power mode to check for any incoming messages to 60 minutes SMS config 1 5 60 OTA TXT config 1 5 60 OTA Messenger Protocol 258 1 5 60 Debug Port 1 5 6...

Page 84: ... To accomplish this the following must be performed Setting Via SMS OTA or Debug Port Enable Engine Run to be determined from a Digital Input 14 1 Set the Messenger to Compute Engine Hours 4 1 Make sure the 1708 option is disabled 5 0 SMS config 2 4 1 5 0 14 1 OTA TXT config 2 4 1 5 0 14 1 OTA Messenger 258 2 4 1 5 0 14 1 Debug Port 2 4 1 5 0 14 1 Set Reporting debounce time to 5 seconds This defi...

Page 85: ... 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 Set the Norm state 1 6 1 if the signal floats or goes above 3 0V when the engine is running Example of signal 3 0V when engine is running SMS config 9 4 6 1 OTA TXT config 9 4 6 1 OT...

Page 86: ...cercent and 4 7V corresponds to 100 percent Need to determine what 0V and 10V would correspond to Slope 100 0 4 7 0 6 Slope 24 4 0V 0 6 24 4 14 6 10V 24 4 10 0 14 6 10V 229 4 SMS config 1 6 8 7 14 6 8 229 4 OTA TXT config 1 6 8 7 14 6 8 229 4 OTA Messenger 258 1 6 8 7 14 6 8 229 4 Debug Port 1 6 8 7 14 6 8 229 4 Set the Analog Input value to be always valid SMS config 2 12 1 OTA TXT config 2 12 1 ...

Page 87: ...1 6527 6 96 RPM 52 6144 4 190 Engine Hours 53 6525 3 247 Coolant Temperature 56 6526 2 110 Battery voltage or Electrical potential 57 6527 1 158 or 168 Oil Pressure 59 6526 3 100 Fuel Rate 60 6526 6 183 Vehicle Distance 79 6524 8 245 Oil Level 90 6526 3 98 Oil Temperature 91 6526 2 175 Coolant Level 92 6526 3 111 Average Fuel Economy 93 6526 6 185 Instantaneous Fuel Economy 94 6526 6 184 Throttle ...

Page 88: ...9 6527 0 107 Engine Load 110 6144 3 92 Engine Torque 111 6144 4 513 Engine Fuel Temp 151 6526 2 174 Estimated Fan Speed 152 6521 3 975 Diagnostic Message Single None 6522 6 DM1 Diagnostic Message Multiple None 6041 6 and 6016 0 TPCM and TPDT Transmission Oil Temp 153 6527 2 177 Total kW Hours Export 251 6501 8 2468 Total Reactive Power 252 6502 8 2456 Overall Power Factor 253 6502 8 2464 Total Rea...

Page 89: ...Inhibit Status 42 6489 2 3702 DPF Active Regen Inhibit Switch 43 6489 2 3703 DPF Active Regen Inhibit Temp Lockout 44 6489 2 3714 DPF Active Regen Inhibit Perm Lockout 45 6489 2 3715 DPF Auto Active Regen Config 46 6489 2 3718 DPF1 Conditions Not Met For Regen 47 6489 2 3750 DPF1 Soot Load 260 6489 1 3719 DPF1 Ash Load 261 6489 1 3720 DPF1 Elapsed Time Regen 262 6489 1 3721 AT1 DPF Regen Threshold...

Page 90: ... Exhaust High Temp Lamp Cmd 270 6489 2 3698 Trip Fuel 271 6525 7 182 Total Fuel 272 6525 7 250 AT1 DEF Tank Level 1 273 6511 0 1761 AT1 DEF Tank Level 2 274 6511 0 3517 AT Catalytic Reduction Active 275 6511 0 5245 Engine Wait Start Lamp 276 6525 2 1081 Engine Protection Shutdown 277 6525 2 1110 Engine Protection Near Shutdown 278 6525 2 1109 Engine Protection Coolant Level Status 279 6525 2 5566 ...

Page 91: ...atus of user port 1 DATA_REG_SYS_COMM2 3 Status of user port 2 DATA_REG_SYS_CAN 4 Status of CAN DATA_REG_SYS_GPS 5 Status of GPS DATA_REG_SYS_ACCEL 6 Status of accelerometer DATA_REG_SYS_BLUETOOTH 7 Status of bluetooth engine ___________ Physical Analog Inputs ____________ Name Data Register Number Description DATA_REG_ADC_1 100 DATA_REG_ADC_2 101 DATA_REG_ADC_3 102 DATA_REG_ADC_VIN 103 DATA_REG_A...

Page 92: ...PGN_VD 411 DATA_REG_PGN_VDHR 412 DATA_REG_PGN_CCVS 413 DATA_REG_PGN_ATS1 414 DATA_REG_PGN_ATS2 415 DATA_REG_PGN_DPCFC1 416 DATA_REG_PGN_LFC 417 DATA_REG_PGN_AT1T1L 418 DATA_REG_PGN_SHUTDN 419 DATA_REG_PGN_AMB 420 DATA_REG_PGN_EEC2 421 DATA_REG_PGN_IC 422 DATA_REG_PGN_TF 423 DATA_REG_PGN_AUXIO5 424 DATA_REG_PGN_LCN1 425 DATA_REG_PGN_LCN2 426 DATA_REG_PGN_LCN3 427 DATA_REG_PGN_L_CCS 428 DATA_REG_PGN...

Page 93: ...A_REG_SPN_VEP_BATT_SWXED 620 DATA_REG_SPN_DD_FUEL_LEVEL 621 DATA_REG_SPN_HOURS_ENGINE_TOTAL 622 DATA_REG_SPN_VD_VEHDIST 623 DATA_REG_SPN_VDHR_VEHDIST_HR 624 DATA_REG_SPN_CCVS_VEH_SPEED 625 DATA_REG_SPN_CCVS_PTO_STATE 626 DATA_REG_SPN_ATS1_DPF1_SOOT_LOAD 627 DATA_REG_SPN_ATS1_DPF1_ASH_LOAD 628 DATA_REG_SPN_ATS1_DPF1_ET_REGEN 629 DATA_REG_SPN_ATS1_DPF_REGEN_THRESH 630 DATA_REG_SPN_ATS2_DPF2_SOOT_LOA...

Page 94: ...G_SPN_CP750_CURR_CHAN0 667 DATA_REG_SPN_CP750_CURR_CHAN1 668 DATA_REG_SPN_CP750_CURR_CHAN2 669 DATA_REG_SPN_CP750_CURR_CHAN3 670 DATA_REG_SPN_CP750_CURR_CHAN4 671 DATA_REG_SPN_CP750_CURR_CHAN5 672 DATA_REG_SPN_CP750_CURR_CHAN6 673 DATA_REG_SPN_CP750_CURR_CHAN7 674 DATA_REG_SPN_CP750_PULSE_CNT_CHAN0 675 DATA_REG_SPN_CP750_PULSE_CNT_CHAN1 676 DATA_REG_SPN_AUXIO_AS4 677 DATA_REG_SPN_AUXIO_AS3 678 DAT...

Page 95: ...95 MessengerBLE User Guide Name Data Register Number Description DATA_REG_SPN_SVC_TMR14 698 DATA_REG_SPN_SVC_TMR15 699 DATA_REG_SPN_SVC_TMR16 700 ...

Page 96: ...AL6 1005 DATA_REG_EVAL7 1006 DATA_REG_EVAL8 1007 DATA_REG_EVAL9 1008 DATA_REG_EVAL10 1009 ______________ Pre Defined Digital Channels _______________ Name Data Register Number Description DATA_REG_CHAN_CELL 2000 DATA_REG_CHAN_COMM 2001 DATA_REG_CHAN_CAN 2002 DATA_REG_CHAN_GPS 2003 DATA_REG_CHAN_ACCEL 2004 DATA_REG_CHAN_NORDIC 2005 DATA_REG_CHAN_USER_DIN1 2006 DATA_REG_CHAN_USER_DIN2 2007 DATA_REG_...

Page 97: ...TA_REG_CHAN_AUXIO_CH1 3003 DATA_REG_CHAN_AUXIO_CH2 3004 DATA_REG_CHAN_COOLANT_TEMP 3005 DATA_REG_CHAN_BATTERY 3006 DATA_REG_CHAN_ELECTRICAL 3007 DATA_REG_CHAN_OIL_PRESS 3008 DATA_REG_CHAN_FUEL_RATE 3009 DATA_REG_CHAN_EC_STATE 3010 DATA_REG_CHAN_ADC_INPUT1 3011 DATA_REG_CHAN_ADC_INPUT2 3012 DATA_REG_CHAN_ADC_INPUT3 3013 DATA_REG_CHAN_SVC_TMR1 3014 DATA_REG_CHAN_SVC_TMR2 3015 DATA_REG_CHAN_SVC_TMR3 ...

Page 98: ... 3052 DATA_REG_CHAN_DPF1_SOOT_LOAD 3053 DATA_REG_CHAN_DPF1_ASH_LOAD 3054 DATA_REG_CHAN_DPF1_ET_REGEN 3055 DATA_REG_CHAN_AT1_DPF_REGEN_THRESH 3056 DATA_REG_CHAN_DPF2_SOOT_LOAD 3057 DATA_REG_CHAN_DPF2_ASH_LOAD 3058 DATA_REG_CHAN_DPF2_ET_REGEN 3059 DATA_REG_CHAN_AT2_DPF_REGEN_THRESH 3060 DATA_REG_CHAN_DPF_LAMP_CMD 3061 DATA_REG_CHAN_DPF_STATUS 3062 DATA_REG_CHAN_EXH_HIGH_TEMP_LAMP_CMD 3063 DATA_REG_C...

Page 99: ...99 MessengerBLE User Guide ______________ MODBUS Registers ________________ Name Data Register Number Description DATA_REG_MBUS1 5000 DATA_REG_MBUS2 5001 DATA_REG_MBUS100 5099 ...

Page 100: ...t the Messenger BLE complies with current FCC regulations limiting both maximum RF output power and human exposure to radio frequency radiation a separation distance of at least 20 cm must be maintained between the unit s antenna and the body of the user and any nearby persons at all times and in all applications and uses Additionally in mobile applications maximum antenna gain must not exceed 3 2...

Page 101: ...ent appareil est conforme aux CNR d Industrie Canada applicables aux appareils radio exempts de licence L exploitation est autorisée aux deux conditions suivantes 1 l appareil ne doit pas produire de brouillage et 2 l utilisateur de l appareil doit accepter tout brouillage radioélectrique subi même si le brouillage est susceptible d en compromettre le fonctionnement Class B digital device notice C...

Page 102: ...102 MessengerBLE User Guide Cattron formerly Antx 3005 Glacier Pass Lane Cedar Park TX 78613 P 512 255 2800 F 512 255 8306 www cattron com ...