beautypg.com

Appendix c. command-line tool - dtmcmd – DekTec DTM-3237 DVB-S2 Receiver User Manual

Page 33

background image

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