DekTec DTM-3200 IP-ASI Converter - Manual (Page 39)

DTM-3200 – OEM Ethernet TSoIP Converter
User Manual
39
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.
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-3200. 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.
C.2 Reading a setting from the DTM-3200
The following command reads device property Type (category 1, setting 5):
DtmCmd -interface Serial -serial COM3 -baudrate 9600 -addr 0x40
-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 0x40
 Set the address of the DTM-3200 to 0x40.

-r
 Set the command type to read.

1 5
 Specify command category 1 and setting 5.
This command results into the following output:
DtmCmd - DTM-32xx Command Utility v1.0.1 (c) 2013 DekTec Digital
Video B.V.
- Category : 0x01 (Device properties)
- Setting : 0x05 (Type)
- Index : 0x00
- Interface : Serial
- DTM address : 0x40
- Serial path : COM3
- Serial baud : 9600
- Data read : 3200