SW_DevScreen

Device Module "Screen"

Module Information

System

System	Comments
RPi	OK
PC Linux	OK
PC Windows	OK
Mac	OK

Dependencies

Windows:

Python Module	Install	Anaconda
colorama	pip install colorama	conda install colorama

Linux:

Python Module	Install	Anaconda
termios	?	?

Command Line Arguments

-S
--noscreen

Use this argument to disable the screen

Config File Parameter

Param	Default	Values	Description
show_BuZi	true	false / true	If true, show special characters for Bu / Zi on Screen
show_capital	false	false / true	if true, use capital letters on screen
show_ctrl	true	false / true	if true, show control sequences on screen
show_info	false	false / true	if true, show additional info on screen
show_line	true	false / true	if true, show vertical border line „|“ on screen

Description

The screen module lets you communicate with the connected teletype over ASCII-terminal and keyboard of the computer running piTelex. It can be accessed directly over the computer's display and keyboard connectors or via ssh (Windows: PuTTY). In most application cases, this module should be enabled.

This way the output of the teletype can be monitored and keystrokes can be sent to the printer. These keystrokes may consist of simple text, but may also contain commands to control the teletype:

Quick keys for console operation:

Key	<ESC>-Sequence	function	description
<Insert>	<ESC>at<enter>	AT	start outgoing call ("Anruf-Taste")
<Del>	<ESC>st<enter>	ST	end an (outgoing) call ("Schluss-Taste")
<Home>	<ESC>lt<enter>	LT	enter local mode ("Lokal-Taste")
Ctrl-C	<ESC>exit<enter>	Stop piTelex
@		WRU	Request answerback ("Kennungsgeber") from remote machine
#		ID	Send local answerback ("Kennungsgeber")
_		ZV LF	Line Feed
\		WR CR	Carriage Return
%		Bell	ring the bell of the connected teletype
$			Expands to "The quick brown fox jumps over the lazy dog."
<backspace>			Expand to "e e e"

More short commands

The following <cmd>s can be used, embedded between <ESC>and <Enter>:

cmd	Description
ry	print 1 row of "ryryryry...."
fox	print "the quick brown fox jumps over the lazy dog"
pelze	print "kaufen sie jede woche vier gute bequeme pelze xy 1234567890"
abc	print "abc...xyz 12...90 .,-+=/()?'%"
a1	print "a1b2c3d4....x4y5z%"
lorem	print 7 lines of blind text ("lorem·ipsum·dolor·sit·amet,·consectetur·adipisici·elit,...")
logo	print piTelex logo as Baudot Art (takes 8 lines)
test	print 6 lines of ".-=x=-.-=x=-. ...."
date	print DateTime String
font	enter font mode. In font mode, all entered characters are recoded so that they can be punched to tape in a human-readable baudot-art representation
read	read, if necessary convert, and print the contents of <file>, see below
cli	enter cmdline interface, see below

Command line interface

Typing <esc>cli<Enter> gives access to a tiny command line interface. It provides the following commands:

cmd	Description
whoami	prints "pitelex-cli"
wru	prints software answerback, if configured
debug	prints configured debug level (deprecated)
ping	:-)
ip	prints IPV4-address and hostname
port	prints configured i-telex port
dev	prints the names of the enabled devices and the associated software modules
exit	prints "bye" and leaves the cmdline interface
	Linux only commands
ipx	prints IP information
cpu	prints cpu load
mem	prints memory usage
disk	prints disk usage
uptime	prints uptime since last reboot
w	lists logged in users

Reading files

read <file> allows for reading and inserting the contents of a file.

The following file types are recognized:

Extension	Description
.txt	ASCII Text in UTF-8 encoding
.pix
.pox
.bin
.ls
...To be continued...

Note: Starting piTelex in foreground (from the shell) will lead you immediately to this interface, if enabled.

If piTelex is running in background, you can connect to it's screen output by means of screen or byobu. See Software installation for details

Note: Most of these commands are not directly provided by device Screen, but because they will in most cases be used from the screen interface, they are described here for convenience.

Implementation

TODO