Appendix C. Command-Line Tool - Dtmcmd - DekTec DTM-3237B User Manual

DTM-3237B – DVB-S2X Receiver with DVB-ASI Output
User Manual

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-3237B. See " DtmCmd -? " for help on the available commands.
You can specify the interface type (serial/I
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-3237B 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-3237B
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
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-3237B 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) 2023 DekTec Digital Video
- Category
- Setting
- Index
- Interface
- DTM address
- Serial path
- Serial baud
- Data read
2 C), interface settings and DTM address on the command
: 0x01 (Device properties)
: 0x05 (Type)
: 0x00
: Serial
: 0x60
: COM3
: 9600
: 3237
40
2 C interface is also