echoscp¶
echoscp [options] port
Description¶
The echoscp
application implements a Service Class Provider (SCP) for the
Verification SOP Class (UID 1.2.840.10008.1.1) [1]. It establishes an
Association with peer Application Entities (AEs) and listens for
DICOM C-ECHO-RQ [2] messages to which it responds with a DICOM C-ECHO-RSP
message. The application can be used to verify basic DICOM connectivity.
The following example shows what happens when it is started and receives a C-ECHO request from a peer:
user@host: echoscp 11112
More information is available when a connection is received while running with
the -v
option:
user@host: echoscp 11112 -v
I: Association Received
I: Association Accepted
I: Received Echo Request (MsgID 1)
I: Association Released
When a peer AE attempts to send non C-ECHO message:
user@host: echoscu 192.168.2.1 11112 -v
I: Association Received
I: Association Accepted
I: Aborting Association
Much more information is available when a connection is received while
running with the -d
option:
user@host: echoscp 11112 -d
D: $echosco.py v0.4.1
D:
I: Association Received
D: Request Parameters:
D: ====================== BEGIN A-ASSOCIATE-RQ =============================
D: Their Implementation Class UID: 1.2.826.0.1.3680043.9.381.0.9.0
...
I: Received Echo Request (MsgID 1)
...
I: Association Released
Options¶
Logging¶
-q --quiet
- quiet mode, prints no warnings or errors
-v --verbose
- verbose mode, prints processing details
-d --debug
- debug mode, prints debugging information
-ll --log-level [l]evel (str)
- One of [‘critical’, ‘error’, ‘warning’, ‘info’, ‘debug’], prints logging messages with corresponding level l or higher
-lc --log-config [f]ilename (str)
- use python logging config [3] file f for the logger
Application Entity Titles¶
-aet --aetitle [a]etitle (str)
- set my AE title (default: ECHOSCP)
Miscellaneous DICOM¶
-to --timeout [s]econds (int)
- timeout for connection requests (default: unlimited)
-ta --acse-timeout [s]econds (int)
- timeout for ACSE messages (default: 30)
-td --dimse-timeout [s]econdsr (int)
- timeout for DIMSE messages (default: unlimited)
-pdu --max-pdu [n]umber of bytes (int)
- set maximum receive PDU bytes to n bytes (default: 16384)
Preferred Transfer Syntaxes¶
-x= --prefer-uncompr
- prefer explicit VR local byte order (default)
-xe --prefer-little
- prefer explicit VR little endian transfer syntax
-xb --prefer-big
- prefer explicit VR big endian transfer syntax
-xi --implicit
- accept implicit VR little endian transfer syntax only
DICOM Conformance¶
The echoscp
application supports the following SOP Class as an SCP:
UID | SOP Class |
---|---|
1.2.840.10008.1.1 | Verification SOP Class |
The supported Transfer Syntaxes [4] are:
UID | Transfer Syntax |
---|---|
1.2.840.10008.1.2 | Little Endian Implicit VR |
1.2.840.10008.1.2.1 | Little Endian Explicit VR |
1.2.840.10008.1.2.2 | Big Endian Explicit VR |
Footnotes
[1] | DICOM Standard, Part 6, Table A-1 |
[2] | DICOM Standard, Part 7, Sections 9.1.5 and 9.3.5 |
[3] | The Python documentation |
[4] | DICOM Standard, Part 5, Section 10 and Annex A |