DekTec DTM-3237 DVB-S2 Receiver - Manual (Page 33)

DTM-3237 – OEM DVB-S2 Receiver with DVB-ASI Output
User Manual
33
Appendix C. Command-Line Tool - DtmCmd
C.1 General description of DtmCmd
DtmCmd is a cross-platform (Windows & Linux) command-line tool for simple control of DTM-32xx
devices. The user can read and write device settings, e.g. the command "
DtmCmd -r 1 5 " reads and
prints the value of setting 5 in settings category 1. The most advanced capability of DtmCmd is
upgrading the firmware of a DTM-32xx device. DtmCmd comes with a Microsoft Visual Studio 2010
project for Windows and Makefile for Linux.
To use the command-line tool under Windows, open a DOS box in a directory containing the DtmCmd
executable. Each time DtmCmd is run, a single command specified with the command-line arguments
is executed on the DTM-3237. See “
DtmCmd -? ” for help on the available commands.
You can specify the interface type (serial/I 2 C), interface settings and DTM address on the command
line. The configuration settings are stored in file DtmCmd.ini . Every time DtmCmd starts, it first reads
DtmCmd.ini , so that you don’t need to specify the configuration settings every run of DtmCmd.
Please note that the USB interface on the DTM-3237 is a serial emulator and therefor the serial
interface needs to be used in DtmCmd. Please refer to §4.1 - Control interfaces for more information.
C.2 Reading a setting from the DTM-3237
The following command reads device property Type (category 1, setting 5):
DtmCmd -interface Serial -serial COM3 -baudrate 9600 -addr 0x60
-r 1 5
The following shortcut is equivalent once the configuration settings are available in DtmCmd.ini :
DtmCmd -r 1 5
The parameters used in this command have the following meanings:

-interface Serial  Set the interface type to a serial COM port. The I 2 C interface is also
supported by DtmCmd.
 -serial COM3  Set the serial COM port identifier to COM port 3.

-baudrate 9600  Set the baud rate to 9600bd.

-addr 0x60  Set the address of the DTM-3237 to 0x60.

-r  Set the command type to read.

1 5  Specify command category 1 and setting 5.
This command results into the following output when using the -v parameter (verbose mode):
DtmCmd - DTM-32xx Command Utility v1.0.1 (c) 2013 DekTec Digital Video
- Category : 0x01 (Device properties)
- Setting : 0x05 (Type)
- Index : 0x00
- Interface : Serial
- DTM address : 0x60
- Serial path : COM3
- Serial baud : 9600
- Data read : 3237