acn/vt132-quickref
acn
/
vt132-quickref
1
0
Fork 0
Code Releases 1 Activity

Some changes :)

This commit is contained in:
acn 2020-07-21 15:50:44 +02:00
parent 6d90734279
commit 5798941cbd
8 changed files with 88 additions and 59 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
appendix.tex
View File

@ -6,7 +6,7 @@
To install the VT132 in an RC2014 or a compatible system, place it in a standard or extended bus socket.
If your backplane does not offer an extended bus, the modem cannot be used via bus pins, instead the modem FTDI header has to be used.
If your backplane does not offer an extended bus, the modem cannot be used via bus pins, instead the modem 6 pin header has to be used.
The extended bus pins are not used for other purposes.
\textbf{On a new VT132, the NVR (Non-volatile RAM) is not initialized.}
@ -32,18 +32,18 @@ JP4 RxB \\
\hline
JP5 Pwr FTDI & Connect Power to FTDI +5V pin \\
\hline
JP6 Pwr Modem & Connect Power to modem FTDI +5V pin \\
JP6 Pwr Modem & Connect Power to modem header +5V pin \\
\hline
\end{tabular}
Enabling JP1 and JP2 is highly advised, as the VT100 terminal serial connection is not available on a FTDI header.
Enabling JP1 and JP2 is highly advised, as the VT100 terminal serial connection is not available on a 6 pin header.
If you want to provide power to, or take power from either of the 6 pin headers then JP5 and JP6 will provide power
or isolate the \texttt{Vcc} pin in the \texttt{FTDI Program} and \texttt{Modem Port B} 6-pin headers respectively.
or isolate the \texttt{Vcc} pin in the \texttt{FTDI Program} and \texttt{Modem Port B} 6 pin headers respectively.
\textbf{Warning:} You should normally only connect one power source to the system at a time.
\begin{tabular}{ c | p{0.38\textwidth} || c | p{0.38\textwidth}}
\begin{tabular}{ c | p{0.38\textwidth} || c | p{0.37\textwidth}}
\hline
\multicolumn{2}{ l || }{FTDI Program} & \multicolumn{2}{ l }{Modem Port B} \\
\hline
@ -62,7 +62,7 @@ If your RC2014 serial module uses the RTS/CTS pins, you can disable JP3+4 and us
as no bus pins are assigned to RTS/CTS.
The \textbf{FTDI Program} header outputs debug messages from the ESP32 microcontroller. You can connect another terminal (or a PC) to watch the debug output.
The output uses 115.200 baud, 8 data bits, no parity, 1 stop bit (8-N-1).
The output uses 115200 baud, 8 data bits, no parity, 1 stop bit (8-N-1).
It is also possible to flash the ESP32 via this header. To enable the \textit{programming mode}, press and hold \textbf{Reset}, press and hold \textbf{Prog}, release \textbf{Reset}
and release \textbf{Reset}. Another firmware can now be uploaded, eg. via \texttt{esptool}.
@ -72,7 +72,7 @@ and release \textbf{Reset}. Another firmware can now be uploaded, eg. via \textt
The VT132 module offers two buttons:
\begin{itemize}
\begin{itemize}[leftmargin=1em]
\item Reset
\item Prog
\end{itemize}

17
includes.tex
View File

@ -4,18 +4,12 @@
\usepackage{varioref}
\usepackage{graphicx}
\usepackage{multirow}
\usepackage{enumitem}
\usepackage[unicode,
bookmarks=true,
bookmarksnumbered=true,
pdfpagemode=UseOutlines,
pdfstartview={FitV 0},
pdffitwindow=true,
colorlinks=true,
linkcolor=black,
citecolor=black,
filecolor=black,
urlcolor=black,
\usepackage[unicode=true,
bookmarks=true, bookmarksopen=true, bookmarksopenlevel=1, bookmarksnumbered=true,
pdfpagemode=UseOutlines, pdfstartview=FitV, pdffitwindow=true,
colorlinks=true, linkcolor=black, citecolor=black, filecolor=black, urlcolor=black,
pdfauthor={Anna Christina Naß},
pdftitle={VT132 Manual},
pdfsubject={Documentation},
@ -26,3 +20,4 @@
\renewcommand{\arraystretch}{1.2}
% The TOC should only contain Chapters and Sections:
\setcounter{tocdepth}{\sectiontocdepth}

16
modem.tex
View File

@ -5,7 +5,7 @@
The VT132 modem part is designed to provide a modified Hayes \texttt{AT} compatible command set for connecting over WiFi via TCP/IP
sockets with an optional Telnet protocol layer.
\begin{itemize}
\begin{itemize}[leftmargin=1em]
\item The original \texttt{AT} command set was strictly in upper case. This is because the bit sequence of the ASCII values for \texttt{A} and \texttt{T} have
a specific property that enables autobaud detection of the connection to the data terminal equipment (DTE).
\item \textbf{The modem only responds to \texttt{AT} commands in upper case.}
@ -26,7 +26,7 @@ baud rate to the serial port -- so you can press this button repeatedly until yo
\subsection{Serial Port}
To communicate with the VT132 modem, you can use either the pins of the RC2014 extended bus (Rx2, Tx2) or the FTDI connector \textit{Modem Port B}.
To communicate with the VT132 modem, you can use either the pins of the RC2014 extended bus (Rx2, Tx2) or the 6 pin header labelled \textit{Modem Port B}.
See section \vref{jumperheaders} \textit{(Jumper settings and headers)} for details.
@ -186,7 +186,7 @@ The following table shows the responses to the \textbf{Query WiFi status} comman
The VT132 supports the following Telnet options:
\begin{itemize}
\begin{itemize}[leftmargin=1em]
\item SGA (Suppress Go Ahead)
\item ECHO
\item BIN (Binary Transmission)
@ -223,11 +223,11 @@ When connecting to \texttt{telnetd} on MacOS I use \texttt{vt100+} from the \tex
\subsection{Enabling Telnet Protocol}
Telnet protocol is \textbf{not} enabled by default.
Telnet protocol is \textbf{not} enabled by default. To enable it, set the S Register S15 to 1 manually:
\begin{itemize}
\item To enable the Telnet protocol you must manually set S Register S15 to 1 with \texttt{ATS15=1}
\item To disable the Telnet protocol you must manually set S Register S15 to 0 with \texttt{ATS15=0}
\begin{itemize}[leftmargin=1em]
\item Enable Telnet using: \texttt{ATS15=1}
\item Disable Telnet using: \texttt{ATS15=0}
\end{itemize}
The Telnet protocol is applied to both \textbf{outgoing} connections 'Dialed' with ATD and \textbf{incoming} connections 'Answered' with \texttt{ATA} or Auto-answer.
@ -239,7 +239,7 @@ The Telnet protocol is applied to both \textbf{outgoing} connections 'Dialed' wi
Listening for incoming TCP/IP socket connections is \textbf{not enabled} by default.
\begin{itemize}
\begin{itemize}[leftmargin=1em]
\item To \textbf{enable} listening for incoming TCP/IP socket connections you must manually enter \texttt{AT\&A} to \textit{Enable Answer Mode}.
\item Answer Mode will remain enabled, and can only disabled by an \texttt{ATZ} (Soft Reset), hardware reset or power-cycle.
\item Incoming TCP/IP socket connections will cause the modem to respond with \texttt{RING}, repeated every three (3) seconds.

70
setup.tex
View File

@ -8,30 +8,45 @@
\hline
\LKeyF{1} & Show/hide help \\
\LKey{5} & Advance to the next screen \\
\LKeyShiftX{T} & Reset tab stops to default \\
\LKeyTab & Move cursor to the next tab stop \\
\LKeyEnter & Move cursor to the beginning of the line \\
\LKeyShiftX{C} & On Set-Up B: reset NVRAM to factory defaults on next boot \\
\hline
\LKeyShiftX{S} & Save the settings to NVS \\
\LKeyShiftX{R} & Recall settigns from NVS \\
\hline
\end{tabular}
\section{The Set-Up Screens}
The Set-Up screens imitate the same functions on a real DEC VT100 terminal.
Use \LKeyF{1} to toggle the help display which shows all keys. \\
Use \LKey{5} to advance to the next screen.
\newpage
\subsection{Set-Up A}
This page shows the tab stops and offers to toggle \textbf{80/132 columns} text display and also switching between
\textbf{online} and \textbf{local mode}.
This page shows the tab stops at the bottom of the screen.
In \textbf{online mode}, the terminal is connected to the computer via the serial port.\\
In \textbf{local mode}, the terminal can be used to connect directly to the modem using the \textit{Quick Settings menu} (see \vref{quicksettings}).
\begin{tabular}{p{6em} | p{0.75\textwidth}}
\hline
\textbf{Key} & \textbf{Function} \\
\hline
\LKeyShiftX{T} & Reset all tab stop to default \\
\LKey{2} & Set / clear tab stop at cursor position \\
\LKey{3} & Clear all tab stops \\
\LKey{4} & Toggle online / local mode \\
\LKey{9} & Toggle 80 / 132 columns per line \\
\hline
\end{tabular}
\vspace{1em}
Use \LKeyShiftX{S} (capital \texttt{S}) to save and \LKeyShiftX{R} (capital \texttt{R}) to recall the settings from NVS.
\begin{itemize}[leftmargin=1em]
\item In \textbf{online mode}, the terminal is connected to the computer via the serial port.\\
\item In \textbf{local mode}, the terminal can be used to connect directly to the modem using the \textit{Quick Settings menu} (see \vref{quicksettings}).
\end{itemize}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newpage
\subsection{Set-Up B}
On this page, various configuration \textit{bits} can be set. Use the cursor to navigate above the bit and press \LKey{6} to toggle it. Use \LKeyTab{} and \LKeyEnter{} to move quicker.
@ -49,13 +64,13 @@ Cursor & Change cursor shape (block / line) \\
\hline
Margin Bell & Ring the bell when cursor is on right margin \\
Keyclick & Every keypress will make a clicking sound \\
Ansi/VT52 & \dots \\
Ansi/VT52 & If disabled, VT52 personality is used \\
Auto Xon/off & Use Xon/Xoff as flow control \\
\hline
US/UK & Switch between US and UK keyboard layout \\
Wrap Around & \dots \\
New Line & \dots \\
Interlace & Enable a 'scanline effect' \\
Wrap Around & Characters will flow to the next line at the end of a line \\
New Line & Pressing \LKeyEnter{} sends \texttt{CR + LF} instead of only \texttt{CR} \\
Interlace & Enable a \textit{scanline effect} \\
\hline
Parity Odd/Even & Not used \\
Parity & Not used \\
@ -64,19 +79,26 @@ Backspace DEL/BS & Send DEL or BS when pressing \texttt{Backspace} \\
\hline
Bold is Bright & If bold text is displayed bright \\
Bold is Thick & If bold text is displayed \textbf{thick} \\
Home on Erase & Should the cursor go to upper left on clear screen \\
NumLock on Reset & Should NumLock be enabled on bootup \\
Set ANSI.SYS Compliance & The terminal will be more compatible to DOS \texttt{ANSI.SYS} \\
Set NumLock on Reset & Enable NumLock on bootup \\
\hline
\end{tabular}
\newpage
\textbf{Please note:}
\begin{itemize}
\begin{itemize}[leftmargin=1em]
\item Use keys \LKey{7} and \LKey{8} to set the baudrate used on the terminal serial port, it is shown in the lower right.
\item US/UK switch will replace \# with \pounds
\item The Ansi/VT52 bit is for VT100 compatibility, as it reacts to \texttt{ESC[?2l} (start VT52 mode) and \texttt{ESC<} (return to ANSI mode,
ie. ANSI/VT100 personality). Changing the personality to VT52 disables this bit, all other wil enable it.
\item The bits for \textbf{bold} text are applied to text with the attribute \texttt{ESC[1m}.
\item \textit{Home on Erase} makes the cursor go home (\texttt{ESC [H}) on a clear screen request (\texttt{ESC[2J}), just as MS-DOS \texttt{ANSI.SYS} works.
\item \textit{ANSI.SYS Compliance} makes the cursor go home (\texttt{ESC[H}) on a clear screen request (\texttt{ESC[2J}),
and makes some of the lower ASCII characters (between 0x00-0x1F) visible.
\end{itemize}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newpage
\subsection{Set-Up C}
This screen is a VT132 enhancement over the VT100 functionality. \\
@ -95,16 +117,21 @@ You can change the following settings:
\LKey{8} & Set default background color \\
\hline
\end{tabular}
\vspace{1em}
\textbf{Please note:}
\begin{itemize}
\begin{itemize}[leftmargin=1em]
\item Codepage 437 is not available in 132 column mode.
\item When switching to 30 line mode, the modem part of VT132 is not available due to memory constraints.
\item When switching to 30 line mode, WiFi cannot be started in the modem part due to memory constraints. Also, if WiFi is already started,
30 line mode is not available (the option toggles between 24 and 25 lines then).
\item To set the colors, move the cursor above the desired color on the bottom left of the screen.
\item The current default foreground/background color is displayed by the word \texttt{Default} on the last line of the screen.
\item The current default foreground/background color is displayed on the last line of the screen by the word \texttt{Default}.
\item The current screen size is displayed on the last line of the screen.
\end{itemize}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newpage
\subsection{Set-Up D}
This screen is a VT132 enhancement over the VT100 functionality.
@ -120,9 +147,10 @@ This screen is a VT132 enhancement over the VT100 functionality.
\LKeyDown & \\
\hline
\end{tabular}
\vspace{1em}
\textbf{Please note:}
\begin{itemize}
\begin{itemize}[leftmargin=1em]
\item To change the keyboard layout, move the cursor above the desired label and press \LKey{6}.
\item When enabling NRCS, certain characters in the lower 127 characters are replaced with country-specific characters according to the
selected keyboard layout.

24
terminal.tex
View File

@ -38,35 +38,37 @@ Use these keys to navigate inside this menu:
\hline
\end{tabular}
\begin{itemize}
\begin{itemize}[leftmargin=1em]
\item Selecting an action (ie. not a menu or checkbox/radio button) will execute this action and close the menu.
\item You can press the \underline{underlined} key to select an option.
\end{itemize}
The following menu options are available:
The following \textbf{menu options} are available:
\begin{itemize}
\begin{itemize}[leftmargin=1em]
\item Actions:
\begin{itemize}
\begin{itemize}[noitemsep]
\item Clear display
\item Soft reset
\item Reset terminal: The same as \texttt{0} in Set-Up menus
\item Reset terminal: The same as \texttt{0} in Set-Up menus, resets the terminal to a defined state.
\item Reboot: Reboots the microcontroller of the VT132
\item Clean NVR: ``factory reset'' the VT132 by deleting all terminal and modem settings
\item Clean NVR: \textit{factory reset} the VT132 by deleting all terminal and modem settings
\end{itemize}
\item Terminal Type:
\begin{itemize}
\begin{itemize}[noitemsep]
\item Emulation Mode: change personality
\item 7-bit NRCS characters: enable/disable NRCS mode
\item 7-bit NRCS characters: enable/disable NRCS\footnote{National Replacement Character Set: When enabled, some characters are replaced with language specific
characters, eg. Umlauts in German} mode
\end{itemize}
\item ASCII emulation:
\begin{itemize}
\item Select a pre-defined emulation ``profile''
\begin{itemize}[noitemsep]
\item Select a pre-defined emulation \textit{profile}
\item White/Green/Amber/Blue screen all sets: DEC Codepage, Bold = Bright + Thick, ANSI color palette (except Amber: VGA palette), 80x24 screen
\item Ansi.sys sets: Codepage 437, Home on Clear, VGA color palette, 80x25 screen
\end{itemize}
\item Keyboard: Select the keyboard layout (US/UK/German/Italian)
\item Modem: Enable modem locally
\begin{itemize}
\begin{itemize}[noitemsep]
\item When enabling this setting, the modem part cannot be accessed via the serial connection
\item Instead, when switching from ONLINE to LOCAL mode, you can talk directly to the modem (bypassing the connected computer)
\end{itemize}

BIN
thn_logo.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 43 KiB

BIN
vt132.pdf
View File

Binary file not shown.

6
vt132.tex
View File

@ -20,7 +20,11 @@
\subtitle{Quick Reference Guide}
\author{}
\date{Version 1.0.0}
\publishers{\LaTeX{} by Anna Christina Naß}
\publishers{\includegraphics[scale=0.7]{thn_logo}}
% on the back of the title page:
\uppertitleback{Quick Reference Guide by by Anna Christina Naß}
\lowertitleback{Created using \LaTeX{} using Linux Libertine font package}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% Let's get started