Micro Vibe

My Micro Hobby Projects

  • Increase font size
  • Default font size
  • Decrease font size
Home PropTerm General Using PropTerm

Using PropTerm

Print

This article describes how to operate the PropTerm terminal project once it is completed. The PropTerm terminal is an ANSI control protocol based serial terminal display. The display uses an analog VGA connector to attach to a VGA display device, a PS2 keyboard connector is used to attach the keyboard.  Finally a nine volt DC power supply is required to power the PropTerm. By default the VGA display resolution is set to 800x600 @ 72Hz, this can be changed in the project source code. At 800x600 resolution the terminal will display 100 columns by 50 rows.

NOTE: the attached PS2 keyboard must have the Windows "WIN" key to be able to enter setup mode.

Once power is applied (slide power switch to center position on Proto Board) the PropTerm should activate. If this is the first time the PropTerm has started up there will be a short delay as all the internal font tables saved in the eeprom are initialized with a copy of the default font (font saved in Propeller code). Once activated the terminal should display a flashing cursor at the top left corner of the display and the keyboard should be powered up and active. 

The PropTerm has a built in setup dialog used to set the default terminal settings. To invoke the setup dialog press the WIN+F12 key combination. To exit the setup dialog without saving changes press the ESC key. 

Each line of text in the setup dialog shows a keyboard function key name, a description of the setting, and the current setting's value. Pressing one of the listed function keys will toggle the corresponding setting's value.

F1 - Baud Rate:

Sets the terminal's RS232 baud rate from 300 to 115K baud.

F2 - Data Format:

Sets the format of the RS232 data stream. The RS232 interface supports 7 or 8 bit data with no parity, even or odd parity.

F3 - Auto Wrap:

Sets the state of the auto wrap feature. When auto wrap is "ON" and the terminal's cursor is in the last column position the next displayed character will be set to the first column of the next row. The display will scroll if required. When auto wrap is "OFF" and the cursor is in the last column position the next displayed character will be displayed at the current cursor position with no change in the cursor position.

F4 - Font Color:

Sets the default (reset) font color used at start-up. Normally this should be set to "White".

F5 - BG Color:

Sets the default (reset) display background color. All the screen clear and erase commands use this color to clear a region of the screen. Normally this should be set to "Black".

F6 - Cursor Key:

Alter the codes sent when a cursor key is pressed. When set to "ANSI" the cursor keys are sent as standard ANSI cursor key codes. When set to "FUNC" cursor keys are sent the same way as function keys. See the "Func Prefix" setting for more information.

F7- Func Prefix:

Controls the prefix characters added to function keys. When set to "ESC O" all function keys sent by the terminal are prefixed by an ANSI ESC character followed by the "O" character. When set to "CHAR 143" a single control character will prefix function keys. The "CHAR 143" setting will only work when the terminal is configured for 8 bit data transfer.

F8 - Enter Key:

Controls the ANSI control characters sent by the keyboard "ENTER" key. When set to "CR" pressing the ENTER key causes the terminal to send a single ANSI CR (carriage return) character. When set to "CR+LF" pressing the ENTER key causes the terminal to send an ANSI CR character followed by an ANSI LF (line feed) character.

F9 - Term Mode:

Determines whether the terminal responds to ANSI control codes and escape sequences. When set to "ANSI" the terminal will respond to ANSI control codes and escape sequences. When set to "TTY" the terminal will act like a dumb teletype terminal and ignore ANSI escape sequences and most control codes.

F10 - Local Echo:

Controls the display of characters typed on the terminal's keyboard. When set to "ON" all characters typed on the terminal's keyboard are sent to both the serial interface (RS232) and the terminal display. When set to "OFF" characters typed at the terminal's keyboard are only sent to the serial interface.

F11 - Rx CR As:

Controls the meaning of the ANSI CR character (carriage return)  received from the serial RS232 interface. When set to "CR" a  carriage return control character causes the terminal's cursor to move to the first column of the current row. When set to "CR+LF" a  carriage return control character causes the terminal's cursor to move to the first column of the next row, the display will scroll if required.

F12 - Font:

Sets the current font set used by the terminal. When set to "DEFAULT" the font embedded in the PropTerm program is used as the current terminal display font. When set to "CUSTOM 1", "CUSTOM 2", or "CUSTOM 3" the terminal display font will use the font set saved to the specified custom font location. Custom fonts can be uploaded to the terminal using the Propterm ANSI Font Control Commands. See the WIN+F3 setup dialog command for information on saving custom fonts.

WIN+F3 Update Font:

Save the font set in the terminal's RAM memory to one of the custom fonts saved in the eeprom. When the font selected in the setup dialog is one of the custom fonts the WIN+F3 command will be displayed allowing the terminal's font memory to be saved. Fonts glyphs can be uploaded to the terminal using the ANSI font escape sequences. Once the font has been uploaded use the update font command to save the altered font to one of the custom font locations.

WIN+F1 Save:

Save the currently displayed settings and restore the display. When you enter the setup dialog the terminal's display memory is saved to the eeprom memory device. When the save command is invoked the display is restored after the settings are saved. To exit the setup dialog without saving changes press the ESC key.

WIN+F5 Save/Reset:

Save the currently displayed settings and reset the terminal. When the save/reset command is invoked the display is reset after the settings are saved. To exit the setup dialog without saving changes press the ESC key.

 

Last Updated on Tuesday, 01 September 2009 04:51