Appendix c. command-line tool - dtmcmd – DekTec DTM-3237 DVB-S2 Receiver User 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