diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 949811a..1e88782 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -9,6 +9,7 @@ changes ^^^^^^^ - packaging: configured the coverage-analysis codecov.io - GitHub: improved issues-template +- documentation: add troubleshooting tip to network-interface contributors ^^^^^^^^^^^^ diff --git a/doc/user/printers.rst b/doc/user/printers.rst index c1f5495..cdf3c0f 100644 --- a/doc/user/printers.rst +++ b/doc/user/printers.rst @@ -35,6 +35,17 @@ Based on socket * ``host`` is an alphanumeric host name, could be either DNS host name or IP address. * ``port`` to write to (default = 9100) +Troubleshooting: +Problems with a network-attached printer can have numerous causes. Make sure that your device has a proper IP address. +Often you can check the IP address by triggering the self-test of the device. As a next step try to send text +manually to the device. You could use for example: + +:: + echo "OK\n" | nc IPADDRESS 9100 + # the port number is often 9100 + +As a last resort try to reset the interface of the printer. This should be described in its manual. + File("file\_name") ^^^^^^^^^^^^^^^^^^