Initial commit
|
After Width: | Height: | Size: 7.1 KiB |
|
After Width: | Height: | Size: 23 KiB |
|
After Width: | Height: | Size: 366 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 1.1 KiB |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 1.1 KiB |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 1.1 KiB |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 1.1 KiB |
|
After Width: | Height: | Size: 1.3 MiB |
|
After Width: | Height: | Size: 434 B |
@@ -0,0 +1,322 @@
|
||||
<b><font size="16">CoolTerm - Help</font></b>
|
||||
|
||||
<b><font size="14">Contents</font></b>
|
||||
- Overview
|
||||
- Quick Start
|
||||
- Connection Options
|
||||
- Plain Text and Hexadecimal Display Mode
|
||||
- Sending Strings
|
||||
- Capturing Received Data
|
||||
- Launching CoolTerm from the Command Line
|
||||
- Configurations for advanced users
|
||||
|
||||
|
||||
|
||||
<b><font size="14">Overview</font></b>
|
||||
|
||||
CoolTerm is an easy-to-use terminal for communication with hardware connected to serial ports.
|
||||
|
||||
CoolTerm is a simple serial port terminal application (no terminal emulation) that is geared towards hobbyists and professionals with a need to exchange data with hardware connected to serial ports such as servo controllers, robotic kits, GPS receivers, microcontrollers, etc.
|
||||
|
||||
The features of CoolTerm include:
|
||||
- Capability of multiple concurrent connections if multiple serial ports are available.
|
||||
- Display of received data in plain text or hexadecimal format.
|
||||
- Sending data via keypresses as well as a "Send String" dialog that supports data entry in plain text or hexadecimal format.
|
||||
- Sending data via copy-paste of text into the terminal window.
|
||||
- Sending of text files.
|
||||
- Capability of capturing received data to text files.
|
||||
- Local echo of transmitted data.
|
||||
- Local echo of received data (loop back to sender).
|
||||
- Hardware (CTS, DTR) and software flow control (XON).
|
||||
- Optical line status indicators.
|
||||
- Capability of manually toggling line states of certain handshaking signals when hardware flow control is disabled.
|
||||
- Configurable character and line delays.
|
||||
- Capability of saving and retrieving connection options.
|
||||
- and more...
|
||||
|
||||
|
||||
<b><font size="14">Quick Start</font></b>
|
||||
|
||||
- Use the <i>Connection Options</i> dialog to configure your serial port.
|
||||
- Click <i>Connect</i> to open the serial port and use the keyboard to type the characters to be sent.
|
||||
- Received data will be displayed in the terminal window. Use <i>View Hex</i> to view the data in the terminal window in hexadecimal format.
|
||||
- Use <i>Connection/Send String...</i> to send strings of text. This dialog allows data to be entered as plain text or in hexadecimal format for special characters.
|
||||
- Use <i>Connection/Send Textfile...</i> to send entire text files.
|
||||
- Received data can be recorded to textfile using <i>Connection/Capture to Textfile</i>.
|
||||
- Line states are indicated via the indicator icons in the lower right corner of the terminal window.
|
||||
- Line states that can be toggled manually are indicated by a bold font type. Click the indicator to toggle the line state of such a signal.
|
||||
- Display preferences such as Font, Text Color and Background Color can be configured via the <i>File/Preferences...</i> menu.
|
||||
|
||||
Connection options can be saved and retrieved via the <i>File/Save</i> and <i>File/Open</i> menu items.
|
||||
It is possible to define the default connection options that are applied each time a new terminal window is opened. To create customized default connection options, use "File/Save As Default" to save the current settings to a 'default.stc' file which will be placed in the same folder in which the CoolTerm application resides. The settings in this file will be applied as default to new terminal windows.
|
||||
|
||||
To open a new Terminal, use <i>File/New</i>.
|
||||
|
||||
<b>Viewing Options (<i>View</i> Menu)</b>
|
||||
<i>Plain Text and Hexadecimal Display Mode</i>
|
||||
The display mode of the terminal window can be switched between plain text and hexadecimal via the <i>View Hex/View ASCII</i> toolbar button. Hex mode is particularly useful when characters are received that can not be displayed in plain text.
|
||||
Characters to be sent can be typed via the keyboard, independent of the current display mode.
|
||||
|
||||
<i>Autoscroll</i>
|
||||
If enabled, the data display (ASCII and Hex mode) is automatically scrolled to the bottom when new data is received to show the new data. If disabled, the data display is not automatically scrolled.
|
||||
|
||||
<i>Clear Data</i>
|
||||
Clears the data display (ASCII and Hex).
|
||||
|
||||
<i>Status LEDs</i>
|
||||
The status LEDs display the line states of various serial port signals. A lit LED indicates the "active" state of a signal. An unlit LED indicates that the signal is "inactive".
|
||||
|
||||
|
||||
<b><font size="14">CoolTerm Menus</font></b>
|
||||
|
||||
<b><u><font size="13">File</font></u></b>
|
||||
<i><b>New:</b></i> Open a new terminal window.
|
||||
<i><b>Open…:</b></i> Load connection settings.
|
||||
<i><b>Close:</b></i> Close the terminal window.
|
||||
<i><b>Save…:</b></i> Save the current connection settings.
|
||||
<i><b>Save As…:</b></i> Save the current connection settings using the file save dialog.
|
||||
<i><b>Save As Default:</b></i> Save the current connection settings as default.stc into the CoolTerm application directory.
|
||||
<i><b>Preferences…:</b></i> Open the preferences dialog.
|
||||
<i><b>Quit:</b></i> Quit CoolTerm.
|
||||
|
||||
<b><u><font size="13">Connection</font></u></b>
|
||||
<i><b>Connect/Disconnect:</b></i> Open/Close the serial port.
|
||||
<i><b>Options…:</b></i> Open the connection settings window.
|
||||
<i><b>Reset Port:</b></i> Reset the serial port. Unlock the port if XOFF is active.
|
||||
<i><b>Send Break:</b></i> Send a break signal.
|
||||
<i><b>Flush Serial Port:</b></i> Flush the serial port buffers.
|
||||
<i><b>Send String…:</b></i> Open a "Send String" window.
|
||||
<i><b>Send Textfile…:</b></i> Select a textile to send via a file open dialog.
|
||||
<i><b>Capture to Textfile:</b></i> Start/Stop/Pause/Resume capture of received data to a text file.
|
||||
|
||||
<b><u><font size="13">View</font></u></b>
|
||||
<i><b>View Hex/Plain:</b></i> Switch to Hex or Plain text view.
|
||||
<i><b>Autoscroll:</b></i> Enable/Disable automatic scrolling.
|
||||
<i><b>Clear Data:</b></i> Clear the CoolTerm receive data buffer.
|
||||
|
||||
|
||||
<b><font size="14">Connection Options</font></b>
|
||||
|
||||
Connection options can be saved and retrieved via the <i>File/Save</i> and <i>File/Open</i> menu items.
|
||||
It is possible to define the default connection options that are applied each time a new terminal window is opened. To create customized default connection options, use "File/Save As Default" to save the current settings to a 'default.stc' file which will be placed in the same folder in which the CoolTerm application resides. The settings in this file will be applied as default to new terminal windows.
|
||||
|
||||
To modify the <i>Connection Options</i>, click the <i>Options</i> in the toolbar or use the <i>Connection/Options...</i> menu to open the Connection Options Window. The options are divided into the following categories:
|
||||
|
||||
<b><u><font size="13">Serial Port</font></u></b>
|
||||
Serial port specific options can be adjusted here. The port can not be changed while the connection is open. Close the connection first to change the port. All other settings can be changed while the connection is open.
|
||||
|
||||
<i><b>Serial Port Options</b></i>
|
||||
Select the serial port from the popup menu and configure its settings according to the requirements (Baudrate, Data Bits, Parity, etc.) of the connected hardware.
|
||||
If the serial port to be used is not listed in the popup menu (e.g. in case it is a USB to Serial port adapter that was connected after CoolTerm was started) push the <i>Re-Scan Serial Ports</i> button. Should the serial port still not be available for selection, ensure that the proper drivers for the serial port are installed.
|
||||
Additional information (such as driver names and rated speeds) about the selected port can be displayed by clicking the bevel button to the right side of the <i>Port:</i> popup menu.
|
||||
|
||||
<i>Initial Line States when Port opens</i>
|
||||
This can be used to set the initial state of the RTS and DTR status lines when the respective hardware flowcontrol options are not enabled.
|
||||
|
||||
|
||||
<b><u><font size="13">Terminal</font></u></b>
|
||||
Options related to terminal behavior are adjusted here. These options are accessible regardless of the connection state of the serial port.
|
||||
|
||||
<i><b>Terminal Options</b></i>
|
||||
<i>Terminal Mode</i>
|
||||
Sets the operating mode of the terminal. In <i>Raw Mode</i> every key is sent via the serial port immediately as it is pressed. When in <i>Line Mode</i>, a command line field is visible in the terminal window. Characters typed in this field are added to a send buffer. The contents of the send buffer (i.e. one line of text) are sent when the enter key is pressed.
|
||||
<i>Line Mode</i> supports History. I.e. the up and down arrow keys can be used to send previously typed lines. Alternatively, the square button to the right of the command line field can be pressed to show a history of previously sent lines. Select any line to add it to the send buffer.
|
||||
|
||||
<i>Enter Key Emulation</i>
|
||||
Defines what character(s) to send when the Enter key is pressed. When in <i>Line Mode</i>, the contents of the send buffer are terminated with the character(s) selected here before they are sent.
|
||||
|
||||
<i>Local Echo</i>
|
||||
If checked, locally entered data will be echoed in the terminal window.
|
||||
|
||||
<i>Replace TAB key with spaces</i>
|
||||
If checked, TAB key presses are replaced with the number of spaces specified in the field below. Default is 4, with a maximum of 32.
|
||||
|
||||
<i><b>Special Character Handling</b></i>
|
||||
<i>Filter ASCII Escape Sequences (ASCII View)</i>
|
||||
If checked, ASCII Escape Sequences will be removed from the received data in ASCII view mode.
|
||||
|
||||
<i>Convert Non-printable Characters (ASCII View)</i>
|
||||
If checked, non-printable characters (ASCII codes 0 to 31) will be displayed as a period character in ASCII View mode.
|
||||
|
||||
<i>Handle BS and DEL Characters</i>
|
||||
If checked, Backspace (BS, ASCII code 0x08) and Delete (DEL, ASCII 0x7f) characters will be visually handled in ASCII View mode. When either character is received (or typed with local echo enabled) the previous character in the ASCII viewer is deleted.
|
||||
|
||||
<i>Handle Bell Character</i>
|
||||
If checked, received bell characters (ASCII code 7) will play a terminal beep.
|
||||
|
||||
<i>Handle Form Feed Character</i>
|
||||
If checked, the reception of a FF character (ASCII code 12) will clear previously received characters from the receive buffer and thus clear the screen.
|
||||
|
||||
<i>Handle End Of Text Character</i>
|
||||
Enabling this feature will prevent the display from updating until a EOT (ASCII code 4) character is received, at which time the display is updated with the contents from the receive buffer.
|
||||
If Local Echo is enabled while this feature is enabled as well, locally echoed characters will cause the display to refresh immediately.
|
||||
|
||||
<i>Use UTF-8 to display plain text</i>
|
||||
Enables displaying plain text using UTF-8 encoding for received data in UTF-8 format.
|
||||
Note that UTF-8 may not be supported for all platforms and/or font selection. Other special character handling may also impact UTF-8 display.
|
||||
|
||||
<b><u><font size="13">Receive</font></u></b>
|
||||
Settings with regard to received data can be adjusted here. These options are accessible regardless of the connection state of the serial port.
|
||||
|
||||
<i><b>Receive Options</b></i>
|
||||
<i>Loop back received data</i>
|
||||
If checked, all received data will be echoed back to the sender. This is a useful feature e.g. when working with hardware that has a built-in selftest which requires a loopback adapter. CoolTerm can act as such a loopback adapter and it allows for the data to be observed in the terminal window.
|
||||
|
||||
<i>Ignore receive signal errors</i>
|
||||
If un-checked, CoolTerm will notify the users of signal errors (e.g. an attached device toggles a line state unexpectedly) and close the serial port. If checked, such errors will be ignored and the serial port will remain open.
|
||||
|
||||
<i>Receive Buffer Size</i>
|
||||
The receive buffer, i.e. the amount of data being retained by the terminal window at any given time, is limited to the number of characters specified by this value. To avoid slow performance as the receive buffer fills up, this number should be kept small. The receive buffer size is limited to 2,147,483,647 (2GB) Bytes or less on systems with less available memory.
|
||||
For use cases where CoolTerm is operated on a battery powered computer, it is also recommended to keep the receive buffer as small as possible in order to reduce strain on the CPU.
|
||||
|
||||
<i><b>Capture Text Options</b></i>
|
||||
The <i>Capture raw data</i> and <i>Capture data in Hex format</i> selections determine how received data is stored in the capture file. Raw data capture is suitable when a true representation of the received date is to be captured. Capturing data Hex format provides a way of recording binary data in a more human readable form.
|
||||
|
||||
<i>Add timestamps to received data</i>
|
||||
This option is suited for data logging applications. Timestamps are added whenever new data is available, i.e. a new <i>DataAvailable</i> events generated by the serial port API.
|
||||
|
||||
<i>Wait for termination string</i>
|
||||
If enabled, CoolTerm will inspect received data for the specified termination string and only generate a timestamp and capture the data to file when such a string is received. This is useful for datalogging equipment that terminate their data with specific characters such as CR+LF. Enabling this option will log one line of data each time the termination string is received.
|
||||
|
||||
<i>Termination String</i>
|
||||
This specifies the termination string CoolTerm expects to receive before capturing data to file, if <i>Wait for termination string</i> is enabled.
|
||||
|
||||
<i>Type</i>
|
||||
This specifies the timestamp type. The following types are available:
|
||||
- Absolute Date and Time: The current date and time. The format is per the CoolTerm preferences setting.
|
||||
- Absolute Time: The current time only. The format is per the CoolTerm preferences setting.
|
||||
- Relative Time: The time that has passed since the start of capture, with millisecond resolution. The format is as follows: HH:MM:SS.sss, where sss denotes milliseconds.
|
||||
|
||||
<i>Capture Local Echo</i>
|
||||
If checked, the local echo (if enabled in the <i>Terminal Options</i>) of transmitted data will be captured in addition to the received data.
|
||||
|
||||
<i>Leave File open while capturing</i>
|
||||
If checked (default), CoolTerm will maintain a lock on the capture file by leaving it open as long as capturing is in progress.
|
||||
If unchecked, the file will be closed each time after writing to it, and reopened when new data arrives. This allows other applications to read the contents of the capture file while capturing is in progress. This can be useful in automated environments where received data needs to be available to other applications.
|
||||
NOTE: This option should be used with caution. The capture file should only be opened "read-only" by other applications so that CoolTerm can write new data to it.
|
||||
|
||||
<i>Autostart on open</i>
|
||||
If enabled, capturing to text file is started automatically after the connection settings are loaded. The path to where the data is stored can be set via the <i>Capture File Location</i> field below.
|
||||
|
||||
<i>Append to auto capture file</i>
|
||||
If disabled (default), a new auto capture file is created each time auto capture is started (i.e. each time the connection settings are loaded). A new auto capture file name will be time stamped with the time at which the file was created.
|
||||
If this option is enabled and a capture file already exists, CoolTerm will append new data to the existing file.
|
||||
If this option is enabled and a capture file does not already exist, CoolTerm will create one in the specified location.
|
||||
NOTE: This option should not be enabled for connection settings that are saved as default.
|
||||
|
||||
|
||||
<b><u><font size="13">Transmit</font></u></b>
|
||||
Settings with regard to transmission of data can be adjusted here. These options are accessible regardless of the connection state of the serial port.
|
||||
|
||||
<i><b>Transmit Options</b></i>
|
||||
<i>Use transmit character delay</i>
|
||||
Checking this option enables a character delay specified by the value (in milliseconds) in the <i>Delay</i> text field below. This option guarantees a minimum time between characters to support targets with limited or no receive buffering in order to avoid data loss during transmission. This option is also recommended for targets that employ CTS flow control. At least 3ms delay between characters should be allowed for software and hardware latency on the PC side to shut off data flow when using a CTS command. The maximum character delay that can be specified is 10,000ms.
|
||||
|
||||
<i>Use transmit line delay</i>
|
||||
Checking this option enables a delay specified by the value (in milliseconds) in the <i>Delay</i> text field below. This option guarantees a minimum time after certain characters which are specified in the <i>Delay characters</i> text field below. The default is the Line Feed character (ASCII 10, or 0A hex). This supports targets that execute commands upon receipt of such a character and won't be able to process new data for a certain amount of time. The maximum line delay that can be specified is 10,000ms.
|
||||
|
||||
<i><b>Send String Options</b></i>
|
||||
<i>Terminate 'Send String' Data</i>
|
||||
Enables automatic termination of strings sent by <i>Send String</i> windows with a configurable <i>Termination String</i>. When pressing <i>Send</i> in any <i>Send String</i> window, the <i>Termination String</i> is automatically appended to the sent data.
|
||||
|
||||
<i>Termination String</i>
|
||||
If enabled, this String is automatically appended when sending data from <i>Send String</i> windows.
|
||||
|
||||
<i><b>Send Text Options</b></i>
|
||||
<i>Notify after sending text files</i>
|
||||
If enabled, a short notification sound will be played upon completion of sending a text file.
|
||||
|
||||
|
||||
<b><u><font size="13">Miscellaneous</font></u></b>
|
||||
<i><b>Misc. Options</b></i>
|
||||
<i>Automatically connect on open</i>
|
||||
If checked, the specified serial port will automatically open if these connection settings are loaded via the <i>File/Open</i> menu item. If this option is enabled in the 'default.stc' connection options file in the CoolTerm application directory, the serial port will be opened automatically whenever a new terminal is opened. Note, that each physical serial port can only be opened once, i.e. if a port is already opened, attempts to open the same port in another terminal window will cause a connection error.
|
||||
|
||||
<i>Automatically disconnect on close</i>
|
||||
If checked, the serial port is closed automatically when the terminal window is being closed. If unchecked, CoolTerm will warn the user if it is attempted to close the window while the connection is still open.
|
||||
|
||||
<i>Reduce Display Refresh Rate</i>
|
||||
If checked, this option reduces the terminal refresh rate to once per second, i.e. status texts, status LEDs, as well as displayed serial data are only refreshed once per second. This is useful to reduce strain on the CPU in setups where CoolTerm is operated on a battery powered computer. Note that this will not reduce the rate at which CoolTerm receives data, it only reduces the rate at which it is displayed.
|
||||
|
||||
|
||||
<b><font size="14">Sending Strings</font></b>
|
||||
|
||||
Strings of text can be sent via the <i>Send String</i> dialog windows which can be opened via the <i>Connection/Send String...</i> menu. Multiple <i>Send String</i> windows can be open at the same time. Strings can be entered in plain text as well as in hexadecimal mode. The modes can be switched between ASCII and Hex at any time. When entering data in hexadecimal mode, 2 hex-digits must be used for every character. It is not necessary to use spaces between characters. Press the <i>Send</i> button to send the string to the serial port. Pressing Shift+ENTER or Shift+RETURN will also invoke the "Send" button.
|
||||
NOTE: The serial port must be open to send strings. If the serial port is not open, the <i>Send</i> button is disabled.
|
||||
|
||||
|
||||
<b><font size="14">Sending Text Files</font></b>
|
||||
|
||||
Entire text files can be transmitted via the <i>Connection/Send Textfile...</i> menu. Transmitting text files is only possible when the serial port is open. Use the file dialog opened by <i>Connection/Send Textfile...</i> to navigate to the text file to be sent.
|
||||
Text files can also be sent via drag-and-drop. Drag the text file to be sent and drop it onto the terminal window with which to send the file.
|
||||
|
||||
|
||||
<b><font size="14">Capturing Received Data</font></b>
|
||||
|
||||
CoolTerm is capable of capturing received data to textfiles.
|
||||
- Use the <i>Connection/Capture to TextFile/Start...</i> menu to open a file dialog.
|
||||
- Specify the location and the name of the capture file and press <i>Save</i>. This will start the capture.
|
||||
- To pause capturing, use <i>Connection/Capture to TextFile/Pause</i>.
|
||||
- To resume capturing, use <i>Connection/Capture to TextFile/Resume</i>.
|
||||
- To pause capturing and close the capture file, use <i>Connection/Capture to TextFile/Stop</i>.
|
||||
|
||||
|
||||
<b><font size="14">Launching CoolTerm from the Command Line</font></b>
|
||||
|
||||
CoolTerm can be launched from the command line, using the paths to settings files as arguments. If launched without an argument, the 'default.stc' settings file will be loaded if it exists. If one or more settings file paths are passed as arguments (separated by spaces), each one will be opened when CoolTerm launches.
|
||||
|
||||
Examples:
|
||||
|
||||
Mac: <font font="Courier">open CoolTerm.app setting1.stc setting2.stc setting3.stc</font>
|
||||
Win: <font font="Courier">CoolTerm.exe setting1.stc setting2.stc setting3.stc</font>
|
||||
Linux: <font font="Courier">CoolTerm setting1.stc setting2.stc setting3.stc</font>
|
||||
|
||||
|
||||
|
||||
<b><font size="14">Configuration for Advanced Users</font></b>
|
||||
|
||||
<b><u><font size="13">Adding extra serial ports to the selection in Connection Options</font></u></b>
|
||||
|
||||
In case the system has serial ports that can not be discovered by CoolTerm, such as the /dev/tty.xxx devices on OS X, a text file named "ports.ini" can be placed inside the same directory in which the CoolTerm application resides. Additional ports can be added to this file, one per line. At startup, CoolTerm will read the contents of this file and attempt to obtain handles on the listed devices. Devices with valid handles will then be accessible via the Connection Settings.
|
||||
|
||||
|
||||
<b><u><font size="13">Adding extra baudrates to the selection in Connection Options</font></u></b>
|
||||
|
||||
CoolTerm only lists the baudrates that are guaranteed to work on all platforms. However, some USB adapter are knowns to work with higher/non-standard baudrates such as 128000, 153600, 256000, 460800, or even 921600 baud. Some users may have hardware that require lower baudrates, such as 150, 110, or 100 baud. To use such baudrates in CoolTerm, create and place a "baudrates.ini" file inside the same directory in which the CoolTerm application resides. Additional baudrates can be added to this file, one per line. At startup, CoolTerm will read the contents of this file and the additional baudrates will then be accessible via the Connection Settings. When selecting one of these additional baudrates, CoolTerm will attempt to pass the baudrates to the driver.
|
||||
|
||||
NOTE: There is no guarantee that setting the baudrate to one of these settings will produce the desired result. In case a value is not accepted by the driver, CoolTerm will generate an "Invalid Option" error message. But there are other cases where the driver will accept the value, but not actually generate the correct baudrate. Such cases include some of the lower baudrates like 150, 110, and 100 baud. Only Keyspan USB adapters have been found to support such settings reliably. Both FTDI and Prolific adapters produce baudrates around 30kBaud when set to one of these settings. The user is required to verify that the port is set to the correct baudrate when selecting a non-standard setting. Reports of adapters that reliably support the lower baudrates will be appreciated.
|
||||
|
||||
|
||||
<b><u><font size="13">Removing serial port names from connection settings</font></u></b>
|
||||
|
||||
When connection settings are saved, the name of the selected serial port is stored in the settings file to ensure that the specified port is selected the next time the connection settings are loaded. However, there are times or situations when this may not be desired, such as systems where serial port adapters are only temporarily plugged in or where such adapters are changed frequently.
|
||||
The settings files are human readable and can be openend with a text editor. To prevent CoolTerm from selecting the port specified in the settings, simply remove the line of text that specifies the port name (the first line) from the settings file. This will cause CoolTerm to select the first available serial port instead of selecting a specified one. This will also prevent the <i>"The serial port XXX is not available"</i> warning when the settings file is loaded and the specified port can't be found. It is recommended use this technique for default (default.stc) settings on systems where it is not guaranteed that the specified port is always available.
|
||||
|
||||
Example:
|
||||
|
||||
turn this:
|
||||
<font font="Courier"><i>Port = KeySerial1
|
||||
BaudRate = 115200
|
||||
DataBits = 8
|
||||
...</i></font>
|
||||
|
||||
into this:
|
||||
<font font="Courier"><i>BaudRate = 115200
|
||||
DataBits = 8
|
||||
...</i></font>
|
||||
|
||||
It is also possible to make CoolTerm prompt the user to select a serial port when a settings file is loaded. This may useful for generic settings files for specific use cases or hardware devices where the name of the serial port is not known beforehand. To achieve this, delete the serial port name from the settings file but otherwise leave the <font font="Courier"><i>Port = </i></font> line intact.
|
||||
|
||||
Example:
|
||||
|
||||
turn this:
|
||||
<font font="Courier"><i>Port = KeySerial1
|
||||
BaudRate = 115200
|
||||
DataBits = 8
|
||||
...</i></font>
|
||||
|
||||
into this:
|
||||
<font font="Courier"><i>Port =
|
||||
BaudRate = 115200
|
||||
DataBits = 8
|
||||
...</i></font>
|
||||
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 890 B |
|
After Width: | Height: | Size: 2.2 KiB |
|
After Width: | Height: | Size: 845 B |
|
After Width: | Height: | Size: 2.0 KiB |
|
After Width: | Height: | Size: 800 B |
|
After Width: | Height: | Size: 1.8 KiB |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 811 B |
@@ -0,0 +1,143 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE dictionary SYSTEM "file://localhost/System/Library/DTDs/sdef.dtd">
|
||||
<dictionary title="Resources">
|
||||
<suite name="Message Suite" code="RBMS" description="v1.4.2">
|
||||
<command name="LoadSetting" code="RBMSload" description="Loads a settings file, returns ID of window if successful">
|
||||
<direct-parameter description="FilePath as string" type="text"/>
|
||||
<result description="ID as integer" type="integer"/>
|
||||
</command>
|
||||
<command name="CloseWindow" code="RBMSclos" description="Closes a terminal windows">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
</command>
|
||||
<command name="Connect" code="RBMSconn" description="Opens the serial port, returns true on success">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
<result description="success as boolean" type="boolean"/>
|
||||
</command>
|
||||
<command name="Disconnect" code="RBMSdisc" description="Closes the serial port">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
</command>
|
||||
<command name="Write" code="RBMSwrit" description="Writes Data to the serial port">
|
||||
<direct-parameter description="ID as integer, Data as string" type="text"/>
|
||||
</command>
|
||||
<command name="WriteLine" code="RBMSwrtl" description="Writes a line of text, terminated by the end of line character specified in the connection settings">
|
||||
<direct-parameter description="ID as integer, Data as string" type="text"/>
|
||||
</command>
|
||||
<command name="Read" code="RBMSread" description="Reads a specified number of characters from the ReceiveBuffer">
|
||||
<direct-parameter description="ID as integer, NumChar as integer" type="text"/>
|
||||
<result description="Data as string" type="text"/>
|
||||
</command>
|
||||
<command name="ReadAll" code="RBMSrdal" description="Reads all data from the receive buffer">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
<result description="Data as string" type="text"/>
|
||||
</command>
|
||||
<command name="BytesAvailable" code="RBMSbtav" description="Returns the number of bytes currently in the receive buffer">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
<result description="NumBytes as integer" type="integer"/>
|
||||
</command>
|
||||
<command name="LookAhead" code="RBMSlook" description="Returns the receive buffer contents without removing them">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
<result description="Data as string" type="text"/>
|
||||
</command>
|
||||
<command name="ClearBuffer" code="RBMSclrb" description="Clears the Receive Buffer">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
</command>
|
||||
<command name="Hex2Str" code="RBMShx2s" description="Converts a hex string to a plain string">
|
||||
<direct-parameter description="HexStr as String" type="text"/>
|
||||
<result description="PlainStr as string" type="text"/>
|
||||
</command>
|
||||
<command name="Str2Hex" code="RBMSs2hx" description="Converts a plain string to a hex string">
|
||||
<direct-parameter description="PlainStr as string" type="text"/>
|
||||
<result description="HexStr as string" type="text"/>
|
||||
</command>
|
||||
<command name="Poll" code="RBMSpoll" description="Polls the serial port and copies the data from the serial port receive buffer to the CoolTerm receive buffer">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
</command>
|
||||
<command name="WindowCount" code="RBMSwcnt" description="Returns the number of terminal windows">
|
||||
<result description="NumWindows as integer" type="integer"/>
|
||||
</command>
|
||||
<command name="WindowName" code="RBMSwnme" description="Returns the name of the window with the specified index">
|
||||
<direct-parameter description="index as integer" type="text"/>
|
||||
<result description="WinName as string" type="text"/>
|
||||
</command>
|
||||
<command name="SendTextFile" code="RBMSsend" description="Sends the textfile with the given path">
|
||||
<direct-parameter description="ID as integer, FilePath as string" type="text"/>
|
||||
<result description="success as boolean" type="boolean"/>
|
||||
</command>
|
||||
<command name="LastErrorCode" code="RBMSlerr" description="Returns the last error code occured in the specfied window">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
<result description="ErrorCode as integer" type="integer"/>
|
||||
</command>
|
||||
<command name="Quit" code="RBMSquit" description="Quits CoolTerm"/>
|
||||
<command name="CaptureStart" code="RBMScpst" description="Captures received data into a text file with the specified Path">
|
||||
<direct-parameter description="ID as integer, FilePath as integer" type="text"/>
|
||||
<result description="success as boolean" type="boolean"/>
|
||||
</command>
|
||||
<command name="CapturePause" code="RBMScpps" description="Pauses the current Capture">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
</command>
|
||||
<command name="CaptureStop" code="RBMScpsp" description="Stops the current capture">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
</command>
|
||||
<command name="CaptureResume" code="RBMScprs" description="Resumes the current capture">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
</command>
|
||||
<command name="SendBreak" code="RBMSsbrk" description="Sends the break signal">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
</command>
|
||||
<command name="SetDTR" code="RBMSsdtr" description="Sets the value of the DTR status signal">
|
||||
<direct-parameter description="ID as integer, value as boolean" type="text"/>
|
||||
</command>
|
||||
<command name="GetDTR" code="RBMSgdtr" description="Retrieves the value of the DTR status signal">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
<result description="value as boolean" type="boolean"/>
|
||||
</command>
|
||||
<command name="SetRTS" code="RBMSsrts" description="Sets the value of the RTS status signal">
|
||||
<direct-parameter description="ID as integer, value as boolean" type="text"/>
|
||||
</command>
|
||||
<command name="GetRTS" code="RBMSgrts" description="Retrieves the value of the RTS status signal">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
<result description="value as boolean" type="boolean"/>
|
||||
</command>
|
||||
<command name="IsConnected" code="RBMSisco" description="Checks the connection state of the serial port, returns true on success">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
<result description="success as boolean" type="boolean"/>
|
||||
</command>
|
||||
<command name="ResetPort" code="RBMSrset" description="Resets the port">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
</command>
|
||||
<command name="FlushPort" code="RBMSflsh" description="Flushes the port">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
</command>
|
||||
<command name="WindowID" code="RBMSwnid" description="Returns the ID of the window with the specified index">
|
||||
<direct-parameter description="index as integer" type="text"/>
|
||||
<result description="ID as integer" type="integer"/>
|
||||
</command>
|
||||
<command name="BytesLeftToSend" code="RBMSblts" description="Returns the number of byte left to send">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
<result description="NumBytes as integer" type="integer"/>
|
||||
</command>
|
||||
<command name="IndexOfWindowID" code="RBMSindx" description="Returns the index of the passed ID">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
<result description="index as integer" type="integer"/>
|
||||
</command>
|
||||
<command name="NewWindow" code="RBMSneww" description="Opens a new window">
|
||||
<result description="ID as integer" type="integer"/>
|
||||
</command>
|
||||
<command name="GetCTS" code="RBMSgcts" description="Retrieves the value of the CTS status signal">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
<result description="value as boolean" type="boolean"/>
|
||||
</command>
|
||||
<command name="GetDSR" code="RBMSgdsr" description="Retrieves the value of the DSR status signal">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
<result description="value as boolean" type="boolean"/>
|
||||
</command>
|
||||
<command name="GetDCD" code="RBMSgdcd" description="Retrieves the value of the DCD status signal">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
<result description="value as boolean" type="boolean"/>
|
||||
</command>
|
||||
<command name="GetRI" code="RBMSgris" description="Retrieves the value of the RI status signal">
|
||||
<direct-parameter description="ID as integer" type="text"/>
|
||||
<result description="value as boolean" type="boolean"/>
|
||||
</command>
|
||||
</suite>
|
||||
</dictionary>
|
||||
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 895 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 23 KiB |
|
After Width: | Height: | Size: 81 KiB |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 822 B |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 3.1 KiB |
|
After Width: | Height: | Size: 2.7 KiB |
|
After Width: | Height: | Size: 6.4 KiB |
@@ -0,0 +1,317 @@
|
||||
|
||||
CoolTerm
|
||||
|
||||
Copyright (c) 2007-2015 Roger Meier,
|
||||
All rights reserved
|
||||
|
||||
http://freeware.the-meiers.org
|
||||
|
||||
|
||||
|
||||
WHAT IS IT?
|
||||
===========
|
||||
|
||||
CoolTerm is an easy-to-use terminal for communication with hardware connected to serial ports.
|
||||
|
||||
CoolTerm is a simple serial port terminal application (no terminal emulation) that is geared towards hobbyists and professionals with a need to exchange data with hardware connected to serial ports such as servo controllers, robotic kits, GPS receivers, microcontrollers, etc.
|
||||
The features of CoolTerm include:
|
||||
- Capability of multiple concurrent connections if multiple serial ports are available.
|
||||
- Display of received data in plain text or hexadecimal format.
|
||||
- Sending data via keypresses as well as a "Send String" dialog that supports data entry in plain text or hexadecimal format.
|
||||
- Sending data via copy-paste of text into the terminal window.
|
||||
- Sending of text files.
|
||||
- Capability of capturing received data to text files.
|
||||
- Local echo of transmitted data.
|
||||
- Local echo of received data (loop back to sender).
|
||||
- Hardware (CTS, DTR) and software flow control (XON).
|
||||
- Visual line status indicators.
|
||||
- Capability of manually toggling line states of certain handshaking signals when hardware flow control is disabled.
|
||||
- Configurable character and line delays.
|
||||
- Capability of saving and retrieving connection options.
|
||||
- and more...
|
||||
|
||||
|
||||
|
||||
INSTALLATION
|
||||
============
|
||||
CoolTerm comes without an installer and can be placed anywhere on the harddrive as long as the correct folder structure is maintained. I.e. for the Windows version the "CoolTerm Libs" folder must reside in the same location as the "CoolTerm.exe" executable.
|
||||
|
||||
|
||||
|
||||
HOW TO USE IT
|
||||
=============
|
||||
Please refer to the built-in help.
|
||||
|
||||
|
||||
|
||||
VERSION HISTORY
|
||||
===============
|
||||
|
||||
1.4.6: 02/16/16
|
||||
---------------
|
||||
NEW/CHANGED FEATURES:
|
||||
- Added the option to automatically start file capture upon loading connection settings.
|
||||
- Added option to append new data to auto capture files.
|
||||
- Added option to filter ANSI escape sequences. If this option is enabled, ANSI sequence characters will be filtered in ASCII view mode.
|
||||
- Added preference option to enable condensing the line spaces in plain text view mode (not available in Universal Binary builds).
|
||||
- [Win][Linux] Added code to ensure that only one instance of CoolTerm is running on the system at the same time
|
||||
- Added code to ensure that a connection settings file can only be opened once.
|
||||
- Added preference option to show or hide the toolbar.
|
||||
- Added UTF-8 support for plain text view.
|
||||
- Updated preferences dialog to display extended character set.
|
||||
- [Win] Added support for AltGr key combinations on certain international keyboards.
|
||||
- Added shortcut (Mac: CMD-I, Win/Linux: CTRL-I) to Connection/Options... menu.
|
||||
- Changed relative timestamp format from HH:MM:SS:sss to HH:MM:SS.sss to be consistent with established timestamp conventions.
|
||||
IMPROVEMENTS:
|
||||
- Removed CTRL+Alt+S short cut for "File/Save as default" to avoid AltGr+S triggering the short cut.
|
||||
- [Win][Linux] Changed code to use platform specific default text encoding for the plain text window to allow displaying bytes larger than 0x7f.
|
||||
- UI Tweaks to harmonize the look of the GUI between platforms.
|
||||
- Updated Help Text with instructions on how to remove the serial port name from settings files.
|
||||
BUG FIXES AND STABILITY IMRPOVEMENTS
|
||||
- [Linux] Updated AutoScroll code to behave the same as it does on Mac and Windows.
|
||||
- Fixed bug that didn't properly update the text of the Connection/Connect_Disconnect menu when switching between terminal windows.
|
||||
- [Mac] Fixed bug where the text encoding of strings returned from AppleScript commands was not defined.
|
||||
|
||||
|
||||
1.4.5: 02/14/15
|
||||
---------------
|
||||
NEW/CHANGED FEATURES:
|
||||
- Added new option to handle Form Feed (FF, ASCII code 12) characters. When enabled, the reception of a FF character will clear the receive buffer and thus clear the screen.
|
||||
- Added new option to handle End Of Text (EOT, ASCII code 4) characters. Enabling this feature will prevent the display from updating until a EOT character is received, at which time the display is updated with the contents from the receive buffer.
|
||||
- Added code to present the user with the option to select a serial port if a loaded settings file includes an empty string for the port name. This allows the creation of generic settings files.
|
||||
- [MAC] Additional retina support.
|
||||
BUG FIXES AND STABILITY IMRPOVEMENTS
|
||||
- Code improvement to avoid ThreadAccessingUIException
|
||||
|
||||
NOTE TO MAC USERS:
|
||||
Version 1.4.x will be the last release of CoolTerm available as Universal Binary. Starting with version 1.5.x, CoolTerm will only be deployed for Intel based Macs.
|
||||
|
||||
|
||||
1.4.4: 09/21/14
|
||||
---------------
|
||||
NEW/CHANGED FEATURES:
|
||||
- Added feature that shows the path to the current capture file (if a capture is currently active) when the mouse is hovered over the serial port status label at the bottom left of the CoolTerm window.
|
||||
- changed Enter key emulation settings to use popup menu and added the option use a custom sequence to emulate the enter key.
|
||||
- Added additional font sizes to preferences dialog.
|
||||
- Added option to reduce the terminal refresh rate to once per second in order to reduce the CPU load on systems where power consumption is critical.
|
||||
- Added text the the built in help to explain that reducing the size of the receive buffer can be used to reduce CPU power consumption.
|
||||
- [MAC] Compiling for Cocoa from now on (intel based Macs only). The universal binary still uses Carbon.
|
||||
- [MAC] Added basic retina support.
|
||||
IMPROVEMENTS
|
||||
- CoolTerm now properly remembers the last used folders (individually) for opening connection settings, capturing to text files, as well as sending text files.
|
||||
- Added DEL character (ASCII 127) to the routine that handles BS characters in ASCII view.
|
||||
- optimized code to reduce CPU load while sending text files.
|
||||
- stability improvement to the code of the circular receive buffer.
|
||||
BUG FIXES AND STABILITY IMRPOVEMENTS
|
||||
- fixed code that could cause extended ASCII characters to sometimes be incorrectly translated from hexadecimal format to plain text.
|
||||
|
||||
|
||||
|
||||
1.4.3: 09/02/2013
|
||||
-----------------
|
||||
NEW/CHANGED FEATURES:
|
||||
- Added preference setting to select the date and time format used for timestamps. The user can select between the SQL Date/Time format (YYYY-MM-DD HH:MM:SS) or the format determined by the users local system settings.
|
||||
- Added options to choose the timestamp type and modified the code to fix an bug where the millisecond count and the Date/Time timestamp could get out of sync. It is now only possible to capture timestamps with millisecond resolution when selecting the relative timestamp format.
|
||||
BUG FIXES AND STABILITY IMPROVEMENTS:
|
||||
- Made various stability improvements to the code that updates the GUI while data is being sent and received.
|
||||
|
||||
|
||||
1.4.2: 02/17/2013
|
||||
-----------------
|
||||
NEW/CHANGED FEATURES:
|
||||
- Added options to set the initial state of RTS and DTR when the serial port opens. These options will only have an effect if the respective hardware flow control is not enabled.
|
||||
- Changed the behavior of capturing received data to file when timestamps are enabled. Instead of appending a time stamp at every occurrence of CR and/or LF characters by default, it is now possible to specify the termination string at which to split the data. Furthermore, CoolTerm will now wait until the specified termination string is received until the data is captured to file.
|
||||
- Added option to convert received data to hex before capturing to a capture file.
|
||||
- Enabled the "Close Window" short cut for the "Send String" window.
|
||||
- Added Alt+ENTER short cut for toggling between ASCII and Hex mode in "Send String"
|
||||
- Added Connection/Reset menu item to provide a way to reset the port and unlock it if XOFF is active.
|
||||
- Changed the behavior of the text file capturing with regards to the state of the port. It is now possible to start capturing before the port is opened. In addition, capturing is no longer stopped automatically when the port is closed. This allows for capturing to remain enabled even when the connection state of the port changes.
|
||||
- Added code to allow canceling of a text file transmission in progress if XOFF is active.
|
||||
- Added option to the connection settings (Misc. Options) to automatically close the serial port when the window is being closed without showing a warning if the port is still open.
|
||||
- Updated the built-in help with information on all menu items.
|
||||
|
||||
BUG FIXES AND STABILITY IMPROVEMENTS:
|
||||
- fixed bug that would cause a NilObjectException in the Xmit routine in cases where the serial port is still transmitting or is hung while the port goes out of scope. This hopefully fixes the crash bug some users have experienced on occasion.
|
||||
- Fixed bug that caused the transmit line delay setting to not properly be saved to connection settings files.
|
||||
- Made improvements to receive buffer code to avoid resource conflicts.
|
||||
Windows only:
|
||||
- Changed file association on windows to work even on systems where the current user may not have administrative privileges.
|
||||
|
||||
APPLESCRIPT:
|
||||
- Changed AppleScript commands to use unique terminal window IDs instead of the names when addressing windows.
|
||||
- Added the following AppleScript commands
|
||||
- WindowCount as integer
|
||||
- WindowID(Index as integer) as integer
|
||||
- WindowName(index as integer) as String
|
||||
- IndexOfWindowID(ID as integer) as integer
|
||||
- NewWindow as integer
|
||||
- Quit
|
||||
- ResetPort(ID as integer)
|
||||
- FlushPort(ID as integer)
|
||||
- BytesLeftToSend(ID as integer) as integer
|
||||
- LastErrorCode(ID as integer) as integer
|
||||
- GetCTS(ID as integer) as boolean
|
||||
- GetDSR(ID as integer) as boolean
|
||||
- GetDCD(ID as integer) as boolean
|
||||
- GetRI(ID as integer) as boolean
|
||||
- CaptureStart(ID as integer, FilePath as string) as boolean
|
||||
- CapturePause(ID as integer)
|
||||
- CaptureResume(ID as integer)
|
||||
- CaptureStop(ID as integer)
|
||||
- SendTextFile(ID as integer, FilePath as string) as boolean
|
||||
- SendBreak(ID as integer)
|
||||
- SetDTR(ID as integer, Value as boolean)
|
||||
- GetDTR(ID as integer) as boolean
|
||||
- SetRTS(ID as integer, Value as boolean)
|
||||
- GetRTS(ID as integer) as boolean
|
||||
- Added code to suppress error messages when CoolTerm is controlled by an AppleScript.
|
||||
- Updated AppleScriptReadme.txt to reflect latest changes.
|
||||
|
||||
|
||||
1.4.1: 11/21/2011
|
||||
-----------------
|
||||
- Improved handling of exceptions if preferences or connection settings can not be read or written.
|
||||
- Checking serial port for nil in the transmit thread to avoid NilObjectException exceptions. Not clear if this fixes the issue a few users have seen.
|
||||
- Improved exception handling when serial port adapters are added or removed from the system while CoolTerm is running.
|
||||
- Fixed a bug in the circular receive buffer that could cause an OutOfBoundsException when reading data.
|
||||
- Improved handing of OutOfMemoryExceptions when attempting to set the receive buffer size to a value larger than the amount of memory available on the user's system.
|
||||
|
||||
|
||||
1.4.0: 9/12/2011
|
||||
----------------
|
||||
NEW FEATURES:
|
||||
- New Connection options window with multiple pages.
|
||||
- The connection options now display port information for the selected port.
|
||||
- It is now possible to change baudrate, byte format settings, and flow control settings while the port is open.
|
||||
- Added the option to specify additional baud rates via a "baudrates.ini" file. E.g. any baud rates that are known to be supported by the hardware that are not listed in the popup menu in the connection settings dialog can be added to a "baudrate.ini" file that resides in the same directory as CoolTerm.
|
||||
- Added the option to specify additional serial ports via a "ports.ini" file. E.g. any devices such as /dev/tty.xxx devices on OSX and Linux that CoolTerm can not enumerate can be added to a "ports.ini" file that resides in the same directory as CoolTerm.
|
||||
- Added the option to add timestamps to data captured to text files.
|
||||
- Added a keyboard shortcut to connect/disconnect.
|
||||
- Added option to replace TAB key presses with a configurable number of spaces (default = 4).
|
||||
- Added option to enable/disable capturing of local echo of transmitted data in capture files.
|
||||
- Added an option to keep the capture file open while capturing is in progress (default) or close it after writing and re-opening when new data arrives. This allows other applications to read the capture file while capturing is in progress.
|
||||
- Added status LEDs for TX and RX to indicate activity related to sending and receiving data.
|
||||
- Added preferences option to disable all menu shortcuts (on Windows and Linux only) in order to allow sending CTRL characters via the terminal. On Mac, the keyboard shortcuts use the Command key and thus don't interfere with CTRL characters.
|
||||
- [MAC] AppleScript BETA: Added basic AppleScript handling for the most important terminal operations such as loading a settings file, opening/closing ports, and reading/writing data. The AppleScript functionality, while included in CoolTerm 1.4.0, is currently in public BETA , to allow a broader audience to beta test this feature and provide feedback. Refer to the attached "AppleScript ReadMe.txt" file for more details.
|
||||
- [LINUX] Making LINUX version (unsupported) available.
|
||||
|
||||
IMPROVEMENTS:
|
||||
- Made significant improvements to the code that processes received data, including changing architecture of the receive buffer to a circular buffer to improve efficiency and stability.
|
||||
- Made significant improvements to the code that transmits data, including changing the architecture of the data transmission to be more asynchronous in nature to improve the responsiveness of CoolTerm during transmission of large text files, particularly with XON/XOFF flow control enabled
|
||||
- CoolTerm now opens a progress window whenever the length of the text to be transmitted exceeds a certain threshold, and not only when text files are sent.
|
||||
- Flow control settings are now displayed in the terminal window as part of the port configuration string. For XON/XOFF the state is displayed, i.e. XON or XOFF.
|
||||
- Added error messages to alert the user of errors that occur while attempting to open the serial port.
|
||||
- Added check to warn the user if multiple files are dropped onto the CoolTerm window.
|
||||
- "Send String" windows can now be resized.
|
||||
- It is now possible to send CTRL characters when the terminal is set to Line Mode.
|
||||
- Improved code for Line Mode to ensure that a pressed key is captured even if the command line didn't have the focus.
|
||||
- Changed behavior of the status LEDs to better reflect the state of the signals. A green LED turned on now means that a signal is "active", the LED turned off means that it is "inactive".
|
||||
- Changed the default state of DTR when a port is opened to "active" to conform with common practice, with the exception of Windows platforms when DTR flow control is enabled, in which case the default is "inactive" in order to avoid serial port errors.
|
||||
- Improved handling of file IO errors when sending textile or capturing received data to textiles.
|
||||
- Improved handling of file IO errors when reading and writing settings files.
|
||||
- Improved error reporting. Crash reports will now include information about all open terminals.
|
||||
- Slight change to the behavior during setting the break signal in that no characters are being read from the receive buffer. Received characters will be read after the break signal has been cleared.
|
||||
|
||||
BUG FIXES:
|
||||
- Fixed a bug that would show an error message when the user chooses cancel in the capture file save dialog.
|
||||
- Fixed a bug that threw an exception when opening the connection settings on a system without serial ports installed.
|
||||
- Fixed a bug the displayed an error message when the user cancelled out of the "Send Textfile" dialog.
|
||||
- [WIN] Fixed a bug where the removal of a serial port adapter could cause an exception when starting a connection.
|
||||
- [MAC] Implemented a workaround for a known RB bug where the baudrates 3600, 7200, 14400, and 28800 baud would not be set correctly and default to 57600 baud instead.
|
||||
|
||||
|
||||
1.3.1: 1/11/2011
|
||||
----------------
|
||||
Improvements:
|
||||
- Added a preferences option to automatically check for updates at startup.
|
||||
|
||||
Fixes:
|
||||
- Fixed a bug that caused a StackOverFlowException when serial port devices were unexpectedly removed from the system, e.g. when a USB serial adapter was unplugged while the terminal was connected to that device. The error handling for this situation has been improved.
|
||||
- Fixed a bug that caused an OutOfBoundsException when a serial port device failure occurred during enumeration.
|
||||
- Fixed a bug that resulted in incorrect formatting of long crash reports.
|
||||
|
||||
|
||||
1.3.0: 10/28/2010
|
||||
-----------------
|
||||
New features:
|
||||
- Added a transmit line delay option which adds a specified delay after certain characters such as new line characters (configurable).
|
||||
- Added a transmit character delay option (configurable).
|
||||
- Added a "Connection/Send Break" menu item for sending serial breaks.
|
||||
- Added the option to play a notification sound after a text file has been sent.
|
||||
- Added auto-connect feature.
|
||||
- Added the .hex file extension to the "Text Files" file type set (for the "Send Text File" dialog).
|
||||
- It is now possible to have default settings loaded at startup and when a new terminal window is opened. If a default.stc settings file exists in the application folder of CoolTerm, it will be applied to new terminal windows.
|
||||
- Added a menu item to save current settings as default settings.
|
||||
|
||||
Improvements:
|
||||
- Pressing ENTER or RETURN in the connection settings dialog now envokes the "Ok" button, even if a textfield is currently selected.
|
||||
- Pressing ESC in the connection settings dialog now invokes the "Cancel" button, even if a textfield is currently selected.
|
||||
- Pressing Shift+ENTER or Shift+RETURN now invokes the "Send" button in "Send String" windows.
|
||||
- Improved handling of command line arguments.
|
||||
- The values for "Receive Buffer Size" and the character and line delays are now limited to a range from 0 to a maximum value (2,147,483,647 and 10,000, respectively).
|
||||
- When a "Send String" window is opened, the text field now receives focus automatically.
|
||||
- Improved exception handling and error reporting.
|
||||
- Improved behavior of the command history buffer and menu.
|
||||
- GUI improvements.
|
||||
|
||||
Fixes:
|
||||
- Fixed a bug that allowed opening multiple "Save As..." for the same Terminal window dialogs on Windows.
|
||||
- Fixed a bug that could cause a StackOverflow on serial port errors due to calling port.flush
|
||||
- Fixed bug that could cause a crash when sending empty strings via a "Send String" window.
|
||||
- (Win) Fixed issue that would allow the terminal window to be activated via the taskbar when the connection options window is open.
|
||||
- Several minor bug fixes.
|
||||
|
||||
|
||||
1.2.0: 2/19/2010
|
||||
----------------
|
||||
- Added "Line Mode" to the communication settings. In "Line Mode" a line of typed text will not be sent to the serial port until the Enter key is pressed.
|
||||
- Added "History" which is available in "Line Mode" the up and down arrow keys can be used to select previously typed lines.
|
||||
- Added a receive buffer size limit option.
|
||||
- Added handling of the bell character (ASCII code 7), which can be enabled through the communication settings.
|
||||
- It is now possible to open the communication settings and edit certain options while the serial port is open.
|
||||
- The viewer mode (plain or hex) is now saved as parameter in connection settings files.
|
||||
- The size and position of terminal windows is now saved with connection settings.
|
||||
- Fixed bug that converted occurrences CR+CR+LF strings to single spaces on Windows.
|
||||
|
||||
|
||||
1.1.2: 7/17/2009
|
||||
----------------
|
||||
- Separated option to handle backspace characters in ASCII view from option to convert non-printable characters.
|
||||
- Changed character used to display non-printable characters to a period (ASCII code 46) for better compatibility and consistency across platforms.
|
||||
- Changed short cuts for "View/Autoscroll" and View Mode menu items to avoid conflict with other menu items such as "Edit/Select All".
|
||||
- Windows build now associates .stc files with CoolTerm.
|
||||
- Minor bug fixes.
|
||||
|
||||
|
||||
1.1.1: 6/29/2009
|
||||
----------------
|
||||
- Added option to handle backspace characters in ASCII view to Connection Settings.
|
||||
- Fixed bug in SendString that prevented typing 8 in hex mode.
|
||||
- Fixed bug that printed the wrong character for cursor down key when ConvertNonPrint was enabled.
|
||||
- Added a "Check for Updates" Menu item.
|
||||
|
||||
|
||||
1.1.0: 6/18/2009
|
||||
----------------
|
||||
- Added an option to the connection settings to automatically terminate string sent from "Send String" windows with a configurable "Termination String", such as e.g. a linefeed etc.
|
||||
- In ASCII view mode, all incoming "New Line" such as CR, LF, CR+LF, are now properly displayed as line breaks.
|
||||
- Added an option to the connection settings to convert non-printable characters to generic dot characters in ASCII view.
|
||||
- Added 'View' menu with menu item to switch between Hex and ASCII viewing.
|
||||
- Moved 'Clear Data' menu item to 'View' menu.
|
||||
- Added an 'Autoscroll' feature, accessible via the 'View' menu to enable/disable automatic scrolling of received data.
|
||||
- Changed menu shortcut key for "Cycle through windows" from "0" to "`".
|
||||
- Added code to produce an audible alert (system beep) when characters are typed while the serial port is not connected.
|
||||
- Added a 'Help' button to the toolbar
|
||||
|
||||
|
||||
1.0.0: 5/19/2009
|
||||
----------------
|
||||
- Initial Release
|
||||
|
||||
|
||||
|
||||
|
||||
LICENSE
|
||||
=======
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||
@@ -0,0 +1,81 @@
|
||||
AT
|
||||
OK
|
||||
AT+CWJAP_CUR="YV","1234123412"
|
||||
WIFI CONNECTED
|
||||
WIFI GOT IP
|
||||
|
||||
OK
|
||||
AT+CIPSTART="TCP","zxart.ee",80
|
||||
busy p...
|
||||
CONNECT
|
||||
|
||||
OK
|
||||
AT+CIPSEND=105
|
||||
OK
|
||||
>
|
||||
Recv 104 bytes
|
||||
|
||||
SEND OK
|
||||
|
||||
+IPD,504:HTTP/1.1 301 Moved Permanently
|
||||
Date: Sun, 27 Mar 2016 08:29:50 GMT
|
||||
Server: Apache / DataZone
|
||||
Location: http://zxart.ee/
|
||||
Content-Length: 293
|
||||
Connection: close
|
||||
Content-Type: text/html; charset=iso-8859-1
|
||||
|
||||
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 2.0//EN">
|
||||
<html><head>
|
||||
<title>301 Moved Permanently</title>
|
||||
</head><body>
|
||||
<h1>Moved Permanently</h1>
|
||||
<p>The document has moved <a href="http://zxart.ee/">here</a>.</p>
|
||||
<hr>
|
||||
<address>Apache / DataZone Server at zxart.ee Port 80</address>
|
||||
</body></html>
|
||||
CLOSED
|
||||
|
||||
|
||||
|
||||
|
||||
AT
|
||||
OK
|
||||
AT+GMR
|
||||
AT version:0.60.0.0(Jan 29 2016 15:10:17)
|
||||
SDK version:1.5.2(80914727)
|
||||
compile time:Jan 29 2016 19:06:50
|
||||
OK
|
||||
AT+CWMODE_DEF? busy p...
|
||||
+CWMODE_DEF:1
|
||||
|
||||
OK
|
||||
AT+CWLAP busy p...
|
||||
+CWLAP:(3,"win",-77,"08:60:6e:24:89:70",13,85,0)
|
||||
+CWLAP:(4,"YV",-38,"08:60:6e:d2:f7:58",13,86,0)
|
||||
|
||||
OK
|
||||
AT+CWJAP_CUR="YV","1234123412" WIFI CONNECTED
|
||||
WIFI GOT IP
|
||||
|
||||
OK
|
||||
AT+CIPSTA? +CIPSTA:ip:"192.168.1.248"
|
||||
+CIPSTA:gateway:"192.168.1.1"
|
||||
+CIPSTA:netmask:"255.255.255.0"
|
||||
|
||||
OK
|
||||
AT+PING="google.com" +24
|
||||
|
||||
OK
|
||||
AT+CIPSTART="TCP","zxart.ee",80
|
||||
busy p...
|
||||
CONNECT
|
||||
|
||||
AT+CIPSEND=104
|
||||
GET /index.php HTTP/1.0
|
||||
Host: zxart.ee
|
||||
User-Agent: ZiFi (ZX Evo)
|
||||
Accept: */*
|
||||
Connection: close
|
||||
|
||||
|
||||