background image

R&D department

2018/08/01

Table of Contents

 1 SMS......................................................................................................................................................................6

 1.1 Commands...................................................................................................................................................6

 1.1.1 Coords – current coordinates...............................................................................................................6
 1.1.2 Version – FM device version.................................................................................................................7
 1.1.3 Gsminfo – GSM/GPRS information......................................................................................................7
 1.1.4 Imei.......................................................................................................................................................9
 1.1.5 Reset.....................................................................................................................................................9
 1.1.6 Connect – custom connection.............................................................................................................9
 1.1.7 Econnect – emergency custom connection.........................................................................................9
 1.1.8 Getapn – get APN parameters...........................................................................................................10
 1.1.9 Setconnection – change connection configuration...........................................................................10
 1.1.10 Switchip – switch primary IP and port.............................................................................................10
 1.1.11 Setio – set outputs...........................................................................................................................11
 1.1.12 Getio – read inputs/outputs states..................................................................................................11
 1.1.13 Delrecords – delete all records........................................................................................................11
 1.1.14 Modrev – modem revision...............................................................................................................12
 1.1.15 Caninfo – can configuration info......................................................................................................12
 1.1.16 Cansinfo – dual can configuration info.............................................................................................13
 1.1.17 Getsd – SD card info.........................................................................................................................13
 1.1.18 Clear obd – clear OBD values...........................................................................................................14
 1.1.19 IEversion – TCO extender version....................................................................................................14
 1.1.20 Tacho – tachograph status...............................................................................................................14
 1.1.21 webcoords – Google maps hyperlink with coordinates ..................................................................14
 1.1.22 setiotime – set output for temporary period...................................................................................15
 1.1.23 Banned – temporary banned operators...........................................................................................17
 1.1.24 accinfo..............................................................................................................................................18
 1.1.25 accreset............................................................................................................................................18
 1.1.26 lastchange........................................................................................................................................19
 1.1.27 SMS during critical process .............................................................................................................19
 1.1.28 setcfg................................................................................................................................................20
 1.1.29 getcfg................................................................................................................................................20
 1.1.30 setioparam.......................................................................................................................................21
 1.1.31 getioparam.......................................................................................................................................23
 1.1.32 setvalue – set specific IO values.......................................................................................................24
 1.1.33 set3g.................................................................................................................................................25
 1.1.34 get3g.................................................................................................................................................25
 1.1.35 dfota – update modem firmware over the FTP or HTTP server.......................................................26
 1.1.36 enginevolt – Automatic engine detection........................................................................................28

 2

Summary of Contents for FM Eco

Page 1: ...R D department 2018 08 01 FM Pro FM Eco FM Tco SMS Commands List 1 ...

Page 2: ...ion 12 1 1 15 Caninfo can configuration info 12 1 1 16 Cansinfo dual can configuration info 13 1 1 17 Getsd SD card info 13 1 1 18 Clear obd clear OBD values 14 1 1 19 IEversion TCO extender version 14 1 1 20 Tacho tachograph status 14 1 1 21 webcoords Google maps hyperlink with coordinates 14 1 1 22 setiotime set output for temporary period 15 1 1 23 Banned temporary banned operators 17 1 1 24 ac...

Page 3: ...ome specific information from the FM device via SMS 33 1 1 41 USSD command 35 1 1 42 clear dtc 36 1 1 43 doutreset 36 1 1 44 immobilizer 36 1 1 45 setdinmode 37 1 1 46 getdinmode 37 1 1 47 SMS forward 38 1 1 48 snapshot 38 1 1 49 Supported SMS commands table 39 1 2 Informational messages alerts 40 1 2 1 Driving rule violation accident FM Pro3 only 40 1 2 2 SMS alerts with date time FM4 devices onl...

Page 4: ...les after unsuccessful operation for connect and econnect SMS commands 2016 11 22 1 11 Added Description of the feature Ignore empty space before the SMS command 2016 12 05 1 12 Added SMS commands supported by the FM Basic to the table of supported SMS commands 2016 12 12 1 13 Removed SMS command fastsleep Minor corrections and description improvements 2016 12 20 1 14 Improved the description of t...

Page 5: ...dded New SMS commands setdinmode getdinmode 2017 09 05 1 27 Added New SMS command setlcv 2018 02 12 1 28 Added New SMS command forward 2018 03 08 1 29 Updated SMS command accreset 2018 03 20 1 30 Updated SMS command setdinmode Updated SMS command getdinmode Updated SMS command table 2018 08 01 1 31 Added SMS command snapshot Updated Supported SMS commands table 5 ...

Page 6: ...chanism was updated Currently if there is no password set for the SMS commands the device will ignore empty space s before the command This means that the device accepts SMS commands with or without empty space s before the command Feature applies starting from theses firmware versions FM Plug4 4 00 01 07 01 FM Eco4 4 and FM Eco4 light light 00 01 21 08 FM Tco4 HCV FM Tco4 LCV FM Pro4 00 02 25 XX ...

Page 7: ...mware version 3 Hardware version 4 GSM signal level 5 Voltage status 0 lower then 8 Volts bad 1 higher then 8 Volts OK Exception for new Eco4s product 0 lower then 6 Volts bad 1 higher then 6 Volts OK Example pass version Response example 5402 00 02 15 1089 5 1 1 1 3 Gsminfo GSM GPRS information SMS message is used to get GSM and GPRS information Response has 16 parameters Parameter Title Descript...

Page 8: ...The number of closed GPRS sessions E Error The number of GPRS errors Link with server LK O Opened The number of opened links C Closed The number of closed links E Error The number of link errors TMO Timeout The number of server response timeout Reset RS Reset FM device last reset source Possible causes 08 03 01 reset was because of modem power loss 04 reset because of watchdog 10 reset because of ...

Page 9: ...rnet Protocol address xxx xxx xxx xxx Port 16 bit number commonly known as the port number xxxxx Protocol The principal of communication There are two available protocols TCP and UDP Example pass connect 192 168 0 1 7011 TCP Response example connection data ok After unsuccessful operation device responds connection data incorrect 1 1 7 Econnect emergency custom connection SMS message is used to fo...

Page 10: ...tion 3 1 6 SMS format pass setconnection apn apnlogin apnpassword Protocol IP1 Port1 IP2 Port2 Example pass setconnection apn apnlogin apnpass TCP 111 111 111 111 1111 222 222 222 222 2222 Response example set connection data ok If one of the parameters should be preserved then the specific location for the parameter should be filled with old For example ip1 and port1 should be preserved old value...

Page 11: ...t Note Setio SMS command will not work with several FM device configurations If a DOUT is configured to Blocking and driver registration is enabled and registration function is set to blocking or DOUT activation under conditions enabled and DOUT is set as an output channel then setio SMS command will have no effect 1 1 12 Getio read inputs outputs states SMS message is used to get status about Dou...

Page 12: ...uration file it doesn t necessarily reflect actual mode of operation Answer SMS format CAN enable X Manufacturer Y Type Z Active A Parameter Description CAN enable 0 CAN is disabled 1 CAN is enabled FMS standard mode 2 CAN is enabled LCV mode 3 CAN is enabled OBD mode 4 CAN is enabled Tachograph mode Manufacturer Manufacture group of Light Commercial Vehicles number value Value Name 1 VAG 2 Merced...

Page 13: ...ctive 0 1 1 17 Getsd SD card info SMS message is used to get information about SD card inserted into FM Tco or FM Pro device There are 4 available answers SD card is inserted and used for records Using SD Card for Records Size sector_count x sector_size B H SDrecordHead T SDrecordTail SD card is inserted and used for log Using SD Card for Log and working OK Size sector_count x sector_size B H SDre...

Page 14: ...nected to Port A via extender 2 tachograph is connected to Port B via extender 3 tachograph is connected to FM Tco TCO device CAN Y extender firmware version text Example pass ieversion Response example conf 1 ver IE 00 01 1 1 20 Tacho tachograph status SMS message is used get tachograph status information Answer SMS format TACHO status X Status X Description 0 Not available 1 Everything is OK 2 T...

Page 15: ...222366 speed 65 ignition ON current ignition OFF 1 1 22 setiotime set output for temporary period Using this feature FM is able to switch the DOUTs for temporary period of time User must provide pulse lengths for logical 1 0 values SMS format example pass setiotime 1 500 0 500 0 200 1 300 Description Parameter Description pass SMS password setiotime Command Identifier 1 DOUT1 first logical state 1...

Page 16: ... DOUT1 first logical state 1 0 500 DOUT1 first logical state length ms 0 DOUT1 second logical state 1 0 500 DOUT1 second logical state length ms n Repetition identifier Setter symbol 10 Amount of repetitions DOUT separator 0 DOUT2 first logical state 1 0 200 DOUT2 first logical state length ms 1 DOUT2 second logical state 1 0 300 DOUT2 second logical state length ms n Repetition identifier Setter ...

Page 17: ...ymbol wrong ms number Wrong time number wrong repeat number Wrong repeat count number exceeded max slot For one output is possible to set maximum 10 slot If this count is exceeded this error is displayed pulse is shorter than 10ms Pulse length less than 10 milliseconds was set It s not acceptable other reason Includes other reason not described in this table 1 1 23 Banned temporary banned operator...

Page 18: ... 023 ABC 0 15 0 9 0 32 N_ 0 8 A_B_C_ 1 24 0 42 0 6 1 1 25 accreset SMS message is used to reset accelerometer used for eco driving functionality calibration Example pass accreset Response example Acc reset OK Additional parameter can be included in the main SMS command which will initiate a new calibrationprocess and inform the user of the ongoing calibration status Example pass accreset r Respons...

Page 19: ... change date and time will be updated during any type of configuration modification When device is connecting to GPRS and tries to open link with different IP settings IP change date and time will be updated When device reconnects to server with same IP but different Port IP change date and time will not be updated 1 1 27 SMS during critical process There are 4 critical processes Firmware update C...

Page 20: ... not fit into one SMS message passwords configuration and SMS and enable SMS configuration Following responses are provided for the number which sent configuration by SMS When successfully setting parameters for FM device Configuration parameter s was set Incorrect parameter setting Configuration parameter s was NOT set Parameter No 1 is incorrect Unsuccessful set up when parameters are locked Con...

Page 21: ... m2m member com other values not fit Parameters configuration password and SMS password are not reachable with this SMS In this case the device answer ERROR parameter s read is forbidden If parameter ID is invalid answer would be ID XXX value requested ID not found Example ID 556 value requested ID not found Other possible replies when something is wrong ERROR request is empty ERROR wrong request ...

Page 22: ...it will not be changed Previous value will remain When the FM device receives the SMS where the parameter enable is set to 1 it searches in the current configuration if this parameter with the same ID is already enabled If parameter with the same ID was not enabled FM device will set this IO parameter to the first free slot that is available If IO parameter with the same ID was enabled FM device w...

Page 23: ...setioparam ERROR parameter is already disable If SMS configuration is disabled in configuration tool You do not have permission to change the settings 1 1 31 getioparam Structure of getioparam SMS password getioparam id profile Example password getioparam 28 3 This command is only used for get the current status of the IO parameter selected If IO parameter was enabled the FM device would answer Ex...

Page 24: ...valid message from CAN Bus if available in specific vehicle In general SMS structure is password command command text In command text field there will be ID and its value separated by comma The response format depends on these options 1 If IO value was changed successfully then format is ID value 2 If FM device failed to change IO value then format is ID fail 3 If the value change for specified IO...

Page 25: ...f device enabled 3G For all examples current profile is 1 3G enabled mode set OK 1 profile If device could not enabled 3G 3G enabled mode set FAIL 1 profile If device disabled 3G 3G disabled mode set OK 1 profile If device could not disable 3G 3G disabled mode set FAIL 1 profile If device change to automatic 3G 3G automatic mode set OK 1 profile If device could not change to automatic 3G 3G automa...

Page 26: ...fota update modem firmware over the FTP or HTTP server This SMS is used to update modem firmware of a device with 3G GSM modem Firmwares of 3G modems are in diff form so it only sends differences between new and current firmware Because of this current modem firmware has to be known before the update Binary file of Modem firmware must be placed in FTP or HTTP server before update Modem firmware ov...

Page 27: ...es dfota command it responds When modem update was started successfully Modem FW update process started Check modem FW version with modrev command later When modem firmware update does not start because of bad SMS input ERROR DFOTA FW update NOT supported on this modem when trying to update modem that is not 3G ERROR link string too short when minimum link requirements are not met ERROR wrong comm...

Page 28: ...fter that it searches for a match within its LCV profile database and selects the best possible configuration With the SMS message user can also provide distance and or RPM values These values are used by the auto selection process to make a more accurate selection Additionally the user can add a optional parameter to enable all possible IOs for the selected LCV group on the active profile after t...

Page 29: ...ss lcvselect RPM If you want to send only vehicle distance value the SMS command should look as follows pass lcvselect distance If you do not want to send distance and RPM values via SMS but enable automatic IO selection the SMS command should look as follows pass lcvselect 1 Responses If SMS structure is correct and LCV auto select process started successfully then the FM device responds LCV auto...

Page 30: ...o be in a valid range etc Rules for validation are defined internally Currently Fuel Vehicle distance RPM and Wheel based speed parameters are assigned different coefficient values Remaining CANbus parameters are rated lower After completing the selection process the FM device will send a SMS message with the information about selected group and sub group For example Configured group Ford Ford2 LC...

Page 31: ...ns must be made to receive all parameters from a LCV group subgroup Channel1 1 Channel 2 2 Additional_CAN_interface The user can specify whether to enable the other CAN interface Activate 1 not activate 0 Notes Enable IO parameters function requires the use of Protocol v1 1 without it enabled this function will not work Additionally enough free IO slots must be available to accommodate the newly e...

Page 32: ...word getlog 100 101 102 103 1111 1 15 When device gets this command it should open a link with defined server and send log according to defined mode All other FM device processes e g records sending peripheral device communication should keep working Only device restart can stop log data sending process If data sending is disabled by configuration log will not be sent and the device s response wil...

Page 33: ... sat Currently visible satellites dir Current angle speed Current speed km h hdop Current HDOP level gps Current GPS GLONASS state 1 off 2 on no fix 3 on got fix 4 not responding 5 sleep 6 disabled eng Current engine state 0 OFF 1 ON blver Bootloader version fwver Firmware version hwver Hardware version st Date time GMT from the last FM device rest power ON gsmlvl GSM signal level op GSM operator ...

Page 34: ...ivolts bat Returns battery voltage in millivolts io xxxxx Used to get specific IO current value xxxxx contains IO ID number Only activated in configuration IO data can be retrieved For multi part IO elements first IO ID should be requested IO parameters that are being reset with record sending should not be available response would be NA Password command and command text are separated by space sym...

Page 35: ...d is not affected or ignored by ongoing firmware configuration updates or tacho and smart card reading After getting the response the device transmits the answer to the sender of the SMS Timeout of 120 seconds is used when waiting for the response from the GSM operator SMS command Request SMS structure pass ussd command Where command is a set of digits and asterisk symbols Command always begins wi...

Page 36: ...se will be DOUT activation mechanism is inactive If the DOUT activation with conditions functionality is not configured response will be DOUT activation is not configured 1 1 44 immobilizer This SMS command allows to immobilize the vehicle This functionality works in correlation with the Immobilizer functionality described in the DOUT activation with conditions document If the Immobilizer mode is ...

Page 37: ...mode set DIN positive mode If DIN was set to positive mode response will be DIN mode set DIN positive mode If the device does not support configuration of DINs or wrong DIN mode is specified the following responses can be received DIN mode set configuration of DIN is not supported DIN mode set incorrect DIN specified DIN mode set incorrect DIN mode specified Configurable DIN functionality is not a...

Page 38: ...s 0 the command applies to all configured cameras 1 the command applies to the camera configured on PortA 2 the command applies to the camera configured on PortB Response structure snapshot camera number answer other camera number answer answer can be one of the following ok indicates that the camera took a picture successfully busy indicates that the camera is busy with a previously taken picture...

Page 39: ...ar obd connect coords delrecords econnect getapn getcfg getecu getio getioparam getsd gsminfo ieversion imei lastchange modrev optiver reset setcfg setconnection setio setioparam setiotime setvalue switchip tacho version webcoords set3g get3g dfota enginevolt lcvselect setlcv getlog stoplog info USSD clear dtc doutreset immobilizer resetimmob setdinmode getdinmode forward snapshot 39 ...

Page 40: ...alerts with date time FM4 devices only SMS message can be sent if one of the following SMS alerts is configured overspeeding power supply disconnecting DIN1 DIN2 DIN3 DIN4 ignition Purpose of this message is to inform when these events were triggered Date time is GMT To receive SMS alerts SMS Alert Number must be configured SMS Alert Number can be configured via FM configurator In the main configu...

Page 41: ...M device will accumulate events that will be sent as soon as GSM connectivity is restored The FM device can store up to 16 events If the 16 event threshold is reached the device will start to overwrite oldest events The device will send a report of all events in ONE message as many that can fit in 160 characters Multiple events in one SMS message will be delimited by a semicolon symbol Message for...

Reviews: