Devices: SendDeviceCommandAttempts to send a command to the specified device

See Also

Usage Notes

Programming

Changing modem programming and reporting behaviour over-the-air is done through command types 4, 5, 9, and 10. Fleet Freedom works around carrier firewalls in order to establish direct communication with the modem (when possible).
Changing a mobile phone's pinging schedule does not require communication with the phone itself, only with our system.

For a full list of command types, review APICommandTypesList.

Not all modems support the functions below. Please contact the manufacturer for details, or speak with Fleet Freedom support.

Configuration and Provisioning

Below is the format for the XmlParameters node when sending new programming to a modem, or when provisioning it during the initial setup. The order to the nodes does not matter.
An explanation for each node follows the format.

The config node can contain the attribute queue.
queue attribute will save the command for later execution. The system will wait up to an additional 72 hours for the modem to report in normally, and when it does the command will be removed from the queue and executed.

<config queue="?">
<inputs>
<digital number="#" enable="?" />
<digital number="#" enable="?" />
<!-- etc -->
<analog number="#" enable="?" lower="#" upper="#" />
<analog number="#" enable="?" lower="#" upper="#" />
<!-- etc -->
</inputs>
<outputs>
<digital number="#" value="?" />
<digital number="#" value="?" />
<!-- etc -->
<analog number="#" value="#" />
<analog number="#" value="#" />
<!-- etc -->
</outputs>
<severinfo ip="#.#.#.#" port="#" />
<networkinfo id="#" username="" password="" apn="" dialstring="" />
<servicetype>
<motion>
<moving type="" hours="#" minutes="#" seconds="#" />
<stationary type="" hours="#" minutes="#" seconds="#" />
<distance meters="" />
</motion>
<!-- or -->
<periodic>
<interval type="" hours="#" minutes="#" seconds="#" />
</periodic>
<!-- or -->
<track start="HH:mm:ss" end="HH:mm:ss" days="???????" moving="#" stationary="#" />
<!-- or -->
<geofence latitude="#" longitude="#" radius="#">
<inside type="" hours="#" minutes="#" seconds="#" />
<outside type="" hours="#" minutes="#" seconds="#" />
</geofence>
</servicetype>
<misc>
<phone number="#" />
<password enable="?" value="" />
<odometer value="#" />
<enginehours value="#" />
<sleep mode="#" delay="#" wire="#" />
<acceleration enabled="?" threshold="#" />
<deceleration enabled="?" threshold="#" />
</misc>
<obd2>
<battery enable="?" low="#" />
<fuel enable="?" low="%" />
<fuelrate enable="?" high="#" />
<rpm enable="?" high="#" />
<enginetemp enable="?" high="#" />
</obd2>
</config>

Track Mode (LBS)

Below is the format for the XmlParameters node when modifying the pinging schedule for an LBS handset.

<trackmode enable="?">
<schedule interval="#" starting="HH:mm:ss" ending="HH:mm:ss" days="???????" timezone="#" />
</trackmode>

Toggle Output

Below is the format for quickly toggling a modem's output.

<outputs queue="?">
<digital number="#" value="?" />
<digital number="#" value="?" />
<!-- etc -->
<analog number="#" value="#" />
<analog number="#" value="#" />
<!-- etc -->
</outputs>

Example of Returned Data

<SendDeviceCommand Success="?" CommandID="#" Message="" />

Test Method

ParameterValueTypeUsage
DeviceIDint32Unique device identifier
CommandTypeIDint32Unique identifier for the command to issue
XmlParametersstringSee Usage Notes.