<- dhdcs:v3:device_menu|Device ^ dhdcs:v3:start|DHD Communication Server ^ dhdcs:v3:update_menu|Update ->
====== Logging Menu ======

The ''Logging'' menu provides you with all logging related functions. 

===== Add Device =====

Use the ''Add Device'' command to manually set up a connection to a DSP Core. This is necessary if the device is either connected to your PC via a serial port (only RM4200D devices) or if it can not connect using UDP broadcasts. 

[{{ :dhdcs:v3:add-device.png?nolink |//Add Device window from the Logging menu.//}}]

To set up a connection to the device you can use:

  * **Fixed IP** - You can enter the IP address of a device in the ''Fixed IP'' box. This is useful if the computer with the DHD Communication Server and the DSP core can not communicate using the UDP protocol, but the IP address of the device is known.
  * **COM Port** (legacy fuction) - Required to connect an RM4200D device to the computer using the serial port. Select the correct port from the list. Make sure that this port is not used by other programs. Series 52 devices can not be connected via serial connection.

Click ''OK'' to confirm the settings. The device you just added is shown in the in the DHDCS device list.

<WRAP center round info 80%>
**Note**\\  If you have added a device to the list manually, from this moment on, it is available to all DHD applications able to access the DHDCS.
</WRAP>

<WRAP center round info 80%>
**Note**\\  If ''Remember Added Devices'' checkbox is enabled in [[dhdcs:v3:logging_options|Logging Options]], DHDCS will keep those devices in the list even if you restart the application.
</WRAP>

==== Add Devices Using Command Line ====

When starting DHDCS manually you can add devices to DHDCS using command line arguments:


''DHDCS --log-ip <IP address of device to log>''\\
or
''DHDCS -li <IP address of device to log>''\\

These arguments will switch on protocol for device with the defined IP address. You can use them multiple times.

**Examples:**
''DHDCS --log-ip 192.168.1.2'' will switch on protocol for device with the IP 192.168.1.2
''DHDCS -li 192.168.1.2 -li 192.168.1.34'' will switch on protocol for devices with IP 192.168.1.2 and IP 192.168.1.34.

You can use them also as startup arguments within a shortcut the same way as described in [[dhdcs:v3:installation#change_dhdcs_location|change DHDCS location]].

===== Remove Device =====

Use this command to remove a device from the device list, if you have added it before using the ''Add Device'' command. Select the device in the DHDCS device list and then select the command ''Remove Device'' from the Logging menu. Alternatively, right-click on the device in the DHDCS device list and then click ''Remove Device''.

<WRAP center round tip 80%>
**Tip**\\  You should remove a device from the list if it is connected manually and if the UDP communication between the device and the computer is working again. In this case, the device connects automatically.
</WRAP>

If you want to disconnect a serial connection between a RM4200D device and the computer, first remove the device from the ''device list'' before disconnecting the cable. If not, this can cause error messages when interrupting the connection.

===== Freeze Log Window =====

Sometimes it can happen that a lot of messages are shown in the ''logging area'' of the DHDCS within a short period of time. The amount of incoming messages depends on how many devices are monitored and what kind of messages are included into the logging. If the window is scrolling very fast, you can stop showing new messages by clicking the ''Freeze Log Window'' command. Alternatively, you can press ''F5'' on your keyboard. You can also click this command again to continue showing the messages. After restarting the messages, you can see the number of skipped messages in the ''logging area''.

<WRAP center round info 80%>
**Note**\\  If you have configured in the options that the messages are recorded in a log file, the recording continues even if the shown messages are stopped.
</WRAP>

===== Clear Log Window =====

Use the ''Clear Log Window'' command to delete the content of the ''logging area''. An output of the messages into a log file is not influenced by this. 

===== Show Log File =====

The ''Show Log File'' command opens the log file in the default editor of the PC. 

===== Start new Log file =====

The ''Start new Log file'' command starts writing a new log file.

===== Options =====

<WRAP center round info 80%>
**Note**\\  Opening and writing the logging options requires elevation of user rights to administrator level.
</WRAP>

See [[dhdcs:v3:logging_options|Logging Options]] Page.