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 –...
Page 3
R&D department 2018/08/01 1.1.37 lcvselect – LCV autoselect........................28 1.1.38 setlcv – set LCV group, subgroup and automatically enable possible IOs........30 1.1.39 getlog/stoplog – get device log remotely..................32 1.1.40 info – get some 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...
Page 4
R&D department 2018/08/01 Change log Date Version Description 2015-08-20 Initial draft; 2015-09-08 Added: SMS command: imei – obtain the IMEI number; Added: Table of supported SMS commands; 2015-11-12 Added: Description of the setcfg, getcfg, setioparam and getioparam commands; 2015-11-25 Added: Description of the setvalue command; 2016-03-10 Added: Description of the set3g, get3g and dfota commands;...
Page 5
R&D department 2018/08/01 2017-06-29 1.24 Added: New SMS commands – doutreset, immobilizer, resetimmob; 2017-07-25 1.25 Updated: Custom SMS text function; 2017-08-25 1.26 Added: 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;...
R&D department 2018/08/01 1 SMS There is a possibility to send SMS message to FM device. FM device answers with SMS message too. This is an easy way to quickly interact with FM device. SMS messages are used: to get specific information from FM device; •...
R&D department 2018/08/01 hdop Current HDOP level. state Current GPS/GLONASS state: 1-off, 2-on no fix, 3-on got fix, 4-not responding, 5-sleep, 6- disabled. Example: pass coords Response example: 2013-04-24 07:01, lat. 46.1443183, long. 11.881766, alt. 217.5, sat. 8, dir. 198.10, hdop 100, state 3 1.1.2 Version –...
Page 8
R&D department 2018/08/01 A GSM Cell ID (CID) is a generally unique number used to identify each Cell ID Base Transceiver Station (BTS) or sector of a BTS “” Network mode Current network mode. There are two possible values: GSM and 3G. FM device modem parameters (M) The number of times when FM device has tried to initialize modem Initialization...
R&D department 2018/08/01 0:O 64,C 0, E 248; LK:O 575, E 1, TMO 126; RS: 04; P 0 1.1.4 Imei SMS message is used to get device IMEI number. Example: pass imei Response example: IMEI: 863071016796615 1.1.5 Reset SMS message is used to reset FM device. Device will reboot, its configuration parameters will not be lost. Example: pass reset Response example: Resetting device 1.1.6...
R&D department 2018/08/01 32-bit number, commonly known as an Internet 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 econnect apn,apnlogin,apnpass,192.168.0.1,7011,TCP Response example: Emergency connection data ok After unsuccessful operation device responds: Emergency connection data incorrect 1.1.8...
R&D department 2018/08/01 SMS format: pass switchip X X – which IP and port should be primary IP1 primary set example: pass switchip 1 Response example: Setting primary IP OK IP2 primary set example: pass switchip 2 Response example: Setting primary IP OK If the operation is unsuccessful, then the answer is: Setting primary IP FAIL 1.1.11 Setio –...
R&D department 2018/08/01 1.1.14 Modrev – modem revision SMS message is used to get modem revision information. Answer SMS format: Modem revision: 24_symbol_info Example: pass modrev Response example: Modem revision: 1137B06SIM900M64_ST 1.1.15 Caninfo – can configuration info SMS message is used to get information about CAN settings of FM3 (about CAN1 settings for FM4) device (only works with Tco devices).
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.
R&D department 2018/08/01 1.1.18 Clear obd – clear OBD values SMS message is used with FM Tco OBD (00.03.XX) device. Purpose is to clear all OBD (On-board diagnostic) related data in device memory (not configuration). It can be assumed as OBD values reset command. Example: pass clear obd Response example: OBD parameters and DTC cleared 1.1.19...
R&D department 2018/08/01 Time GMT date & time of coordinates Hyperlink Hyperlink to Google maps with coordinates: latitude and longitude Speed Current vehicle speed, km/h Ignition Ignition status Syntax: pass webcoords Can be 3 different SMS message responses. 1. When GPS data is available. Response example: 2015-05-11 13:01, https://www.google.com/maps/?q=54.7404933,25.2222366, speed: 94, ignition: 2.
Page 16
R&D department 2018/08/01 If one setiotime interrupts another, the state is UNDEFINED ('1' or '0') after both restores the previous status. sequences are finished. Interrupt in this case means that several consecutive "setiotime" commands were sent, one overlapping the other. Sending several "setiotime" commands in a fast succession will make the the DOUT stuck, thus requiring a device reboot.
R&D department 2018/08/01 If configuration SMS is incorrect, device will response: setiotime syntax error in DOUTX settings: error text Where „DOUTX“ is DOUT1 or DOUT2. „Error text“ is described below in the table. It's minimal diagnostic when something wrong with impulse set in SMS. Error text Error description other process controls output...
R&D department 2018/08/01 1.1.24 accinfo SMS message is used to check if accelerometer is calibrated for eco-driving functionality. Only state information is should be interpreted. Parameter Description State 0 – not calibrated 1 – calibration started 2 – zero position calibration is in progress 3 –...
R&D department 2018/08/01 “Calibration successful” - when calibration process was finished successfully. 1.1.26 lastchange SMS message is used to know when was the last time device configuration or primary server IP changed. Example: pass lastchange If time is not synchronized, or changes occur during that time, SMS content will be: Response example: lastchange ip: no time available;...
R&D department 2018/08/01 This command is only used for getting the current status of the parameter selected. Maximum simultaneously received parameters in one SMS message is limited by SMS message length (160 symbols). When parameter ID is correct, FM-device answer: „ID: XXX,value:XXX;“ Example: ‘ID: 96,value:1000;’...
Page 22
R&D department 2018/08/01 id=256,profile=4,enable=1,level=3500,delta=250,average=2000,eventon=2,include=1,priority=1,switch=1,edge=3 This SMS can be used in any way, but it must at least contain Id,profile and enable parameters. Shortest possible message should be written this way: password setioparam id=id,profile=profile,enable=enable Example: 01234567890123456 setioparam id=256,profile=4,enable=1 If the short version is used the other parameters are set with old values. Id,profile and enable parameters are mandatory to make a valid SMS command.
R&D department 2018/08/01 Following responses are provided for IO configuration by SMS: If IO parameter was set correctly, the FM-device would answer: • „setioparam OK, slot: XX“ Where XX is the slot number where the FM-device set parameter. If IO parameter was not set correctly, FM-device would answer: •...
R&D department 2018/08/01 If SMS configuration is disabled in configuration tool or configuration has password: • „You do not have permission to read the settings“ 1.1.32 setvalue – set specific IO values Purpose is to set specific IO values. Parameter Pro4 family Eco4 family Plug4...
R&D department 2018/08/01 1.1.33 set3g The structure of the command would be: password set3g 1/0/2 The field enable/disable could have three values: ‘1’ means enabled, ‘0’ means disabled and ‘2’ means automatic. Only current profile would be changed. Example: password set3g 1 In this example, 3G would be enabled.
R&D department 2018/08/01 Example: password get3g Following responses are provided for the number, which sent the get3g by SMS (response from FM device). Response format: automatic/disabled/enabled 3G mode, connected to 3G/GSM (1/2/3/4-profile) If device has enabled 3G and status is OK. For all examples current profile is 3: •...
Page 27
R&D department 2018/08/01 Example of FTP update command: password dfota ftp://test:test@demo.com:21/update/delta.bin Modem firmware over the HTTP server The structure of the command would be: password dfota http://<http_server_URL>:<http_port>/<http_file_path> <http_server_URL> - String type, the IP address or domain name of the HTTP server <http_port>...
R&D department 2018/08/01 1.1.36 enginevolt – Automatic engine detection This SMS message is used to automatically measure engine power voltage upper level, when engine is on and lower level, when engine is off. With these voltage levels the device will automatically detect, when the engine is on and when it is off.
Page 29
R&D department 2018/08/01 The structure of the command is: password lcvselect distance,RPM,enableIO <password> - String type, the password for authentication. The maximum size of the parameter is 50 bytes <lcvselect> - Automatic select of correct LCV group and sub group combination command name. <distance>...
R&D department 2018/08/01 “Parameters are out of ranges” - Distance and/or RPM value received via SMS are out of accepted range. • “No CAN data were received” - No CAN data packets were received. • “No valid matches were found” - LCV auto select task concluded, but it failed to find matches in our database. •...
Page 31
R&D department 2018/08/01 mandatory. All other fields are optional. Default values for the optional parameters: ▪ <Silent/Active> = Silent; ▪ <Channel_X> = 1; ▪ <Additional_CAN_interface> - not active. Notes The SMS command is not case sensitive, so uppercase letters won't have influence when inputting the Group name. •...
R&D department 2018/08/01 “Error: unknown parameter” - Group name is misspelled, Subgroup number incorrect or invalid value was • provided for one of the parameters. “Error: LCV auto select still in progress” - The device is currently in the progress of LCV auto select, during which •...
R&D department 2018/08/01 Responses: When device gets this command and log sending is in progress, it should stop sending log to server and reply • with SMS: stoplog ok If device gets this command and the log is not running, then the reply should be: getlog already stopped •...
Page 34
R&D department 2018/08/01 Parameter Description 14 means 10 (software reset) + 04 (reset pin) In other words FM device resets himself, for example after FW update. GPRS protocol version: 0 – standard protocol; 1 – extended protocol. imei Device IMEI number APN name apnu APN username...
R&D department 2018/08/01 Answer: https://www.google.com/maps/?q=54.7413016,25.2227550;54.7413016,25.2227550;0x4C5455313233343536 373839303132333400000000000000;11659;2016-12-13 11:20:02;#05 If some requested IO is not enabled in configuration or some tag is unknown, then the device will reply: NA Example: pass info time;imei;eng;IO29;lktma Answer: 2016-12-13 12:41:57;865789021340700;0;NA;NA 1.1.41 USSD command GSM network operators are providing various services via USSD communication. Support of the USSD commands allows users to send various USSD request to the GSM operator over the FM device and receive answers.
R&D department 2018/08/01 1.1.42 clear dtc This SMS command allows to clear J1939 and J1708 DTC codes from the memory of the FM device. SMS command SMS command structure: pass clear DTC Responses If command was performed successfully, response will be: DTC codes were cleared •...
R&D department 2018/08/01 Responses If the immobilizer is successfully reset, the response will be: immobilizer reset • 1.1.45 setdinmode This SMS command allows to set the DIN mode (Positive mode or Negative mode) for configurable DINs (DIN3 or DIN4) SMS command SMS command structure: pass setdinmode <din#>...
R&D department 2018/08/01 DIN# - negative mode; • Configurable DIN functionality is not available for your HW version. • 1.1.47 SMS forward This SMS command allows to forward a SMS via the FM device. SMS command SMS command structure: pass forward <phone_number> <text> <phone_number>...
R&D department 2018/08/01 1.2 Informational messages, alerts 1.2.1 Driving rule violation, accident (FM-Pro3 only) SMS message is sent if one of the following SMS alerts are configured: overspeeding, harsh braking, extreme braking, harsh acceleration, DIN1, DIN2, DIN3, DIN4. Purpose of this message is to inform about the driving rule violations or accidents.
Page 41
R&D department 2018/08/01 Power supply voltage - “Event on” set to Hysteresis and hysteresis must be set to On Falling ; • GPS speed - “Event on” set to Hysteresis and hysteresis must be set to On Rising. • After the “Event on” parameter is properly set, a new checkbox will appear at the top of the IO properties section called “SMS alert”.
Need help?
Do you have a question about the FM Pro and is the answer not in the manual?
Questions and answers