uCon Frequently Asked Questions
This text provides a few quick pointers to uCon's capabilities. For more detailed information refer to uCon documentation/help. Check back regularly, this is a work in progress!
What is uCon?
Its
simply a terminal emulator, like HyperTerminal, but with a lot of
interesting/unusual added capabilities aimed at the needs of embedded
systems users and/or developers (but certainly not limited to that
space).
What host system does this run on?
uCon
was designed to run on a Windows PC. It has been used on all
versions from W98 up through and including Windows-8. Others have
used it with Windows virtual machine on Linux as well as WINE on Linux machines.
Can I program function keys?
Yes.
uCon has 8 programmable function keys and 16 programmable
buttons. The only difference between the two is that the function
keys can be activated by a keypress or a button click. Function
keys and buttons can be configured through scripts as well, so you can
have an endless set of predefined functions.
Can I configure the COM port to a non-standard baud rate?
Yes.
uCon allows the user to define the baud rate from within the
dialog box that opens under Config->Backends->COM Port..
Can I access my PC's COM port from a remote machine?
Yes. As of this writing, you have two options: telnet or http (web browser).
uCon's telnet server supports up to eight simultaneous clients; while http has been tested with just one.
uCon's telnet server supports up to eight simultaneous clients; while http has been tested with just one.
Can I connect to something other than a COM port?
Yes.
uCon provides several "backends": COM port, telnet client, SSH client,
and a connectionless UDP client (similar to netcat).
Go to menu item Config->Backend for these alternatives.
What actually gets installed?
The
installer doesn't do much, and that's on purpose... It just
creates a 'ucon' directory under your "program files" directory and
then under that, creates a few additional directories, along with the
executables (including an uninstaller) and a few other support files.
It asks if you want a desktop-icon, and also places uCon in the
startup "programs" list.
How do I log my target interaction to a file?
There are two ways to do this in uCon: standard and longterm...
Standard:
This is the typical logging mechanism that you would just turn on for the duration of the interaction you want to log, then turn it off and you'll have all that ineraction in a file. Just click on Logging->Standard to open the dialog, set the filename you want to log to and check the Enabled checkbox. Note that the standard logging can be quickly enabled/disabled through a toolbar button (the one that looks like a file folder with an arrow pointing into it).
LongTerm:
This feature supports the idea that you will have uCon attached to some device for a long duration (days/weeks/months) and you want to have the start of each day be the start of a new log file with some maximum amount of space allocated for this logging storage. Once the space allocation is reached, uCon will treat each of the files like a circular queue that has maxxed out. It will simply overwrite the oldest entry. This is handy for cases where you may end up logging so much data that your disk space will max out (not such a problem these days, but it was in the past!). To use this mechanism, click on Logging->Longterm, specify the directory into which you want the files to be placed. Provide a filename prefix (uCon will append a date timestamp to this), set the max size and then check the Enabled checkbox.
Standard:
This is the typical logging mechanism that you would just turn on for the duration of the interaction you want to log, then turn it off and you'll have all that ineraction in a file. Just click on Logging->Standard to open the dialog, set the filename you want to log to and check the Enabled checkbox. Note that the standard logging can be quickly enabled/disabled through a toolbar button (the one that looks like a file folder with an arrow pointing into it).
LongTerm:
This feature supports the idea that you will have uCon attached to some device for a long duration (days/weeks/months) and you want to have the start of each day be the start of a new log file with some maximum amount of space allocated for this logging storage. Once the space allocation is reached, uCon will treat each of the files like a circular queue that has maxxed out. It will simply overwrite the oldest entry. This is handy for cases where you may end up logging so much data that your disk space will max out (not such a problem these days, but it was in the past!). To use this mechanism, click on Logging->Longterm, specify the directory into which you want the files to be placed. Provide a filename prefix (uCon will append a date timestamp to this), set the max size and then check the Enabled checkbox.
I need to see what my target is sending in ASCII-coded hex..
No
problem!. Menu item Config->Miscellaneous has a group of
checkboxes that allow you to pick a few different options for this.
Can I automate custom command sequences and target interaction?
Yes.
uCon has a fairly complete scripting language that allows you to
interact with the target by sending command strings, wait for responses
and then branch in the script based on the content of the response.
There are a few dozen scripting commands ranging from target
interaction to TFTP transfers, file access, etc... Refer to
Help->Scripts for more information on that.
Can I include interaction with other programs in uCon scripts?
Yes.Refer to the SYSTEM and SHELLEXEC commands. These commands allow you to run other commands from within a uCon script.
I need a quick example on how to interact with a target in a script...
The main command used for this is SEND. This
script command allows you to send a string to the target, and then
either wait for a known response (typically some kind of
target-specific command line prompt), or just wait for some period of
time. Here are two quick examples:
Example 1:
Send the line "echo hello world" to the target, wait for 3 seconds, then send it again. The -n option tells the SEND command not to wait for anything. In this case, the wait is actually done using the SLEEP command...
Example 2:
Repeat the above example, but this time, send the command, and wait for the target to send back a prompt. In this case, the target's prompt is "uMON>"...
Notice in this case, there is no SLEEP 3000 command needed because the script will not complete the first SEND until it receives the string "uMON>" from the target. This ability to throttle each command based on the prompt returned from the target is quite handy when the commands have varying durations of execution time. There are many other options to the SEND command so refer to menu item Help->Scripts and then click on the SEND command for more information.
To create a new script, just go to menu item Scripts->New. It will open up an editor (of your choice) and you can then just start typing (the above lines for example). Then save the file to the scripts directory under your uCon installation. Then just click on Scripts->Run to start it up.
Example 1:
Send the line "echo hello world" to the target, wait for 3 seconds, then send it again. The -n option tells the SEND command not to wait for anything. In this case, the wait is actually done using the SLEEP command...
SEND -n "echo hello world"
SLEEP 3000
SEND -n "echo hello world again"
SLEEP 3000
SEND -n "echo hello world again"
Example 2:
Repeat the above example, but this time, send the command, and wait for the target to send back a prompt. In this case, the target's prompt is "uMON>"...
SEND -p uMON> "echo hello world"
SEND -p uMON> "echo hello world again"
SEND -p uMON> "echo hello world again"
Notice in this case, there is no SLEEP 3000 command needed because the script will not complete the first SEND until it receives the string "uMON>" from the target. This ability to throttle each command based on the prompt returned from the target is quite handy when the commands have varying durations of execution time. There are many other options to the SEND command so refer to menu item Help->Scripts and then click on the SEND command for more information.
To create a new script, just go to menu item Scripts->New. It will open up an editor (of your choice) and you can then just start typing (the above lines for example). Then save the file to the scripts directory under your uCon installation. Then just click on Scripts->Run to start it up.
I need to do some fairly complex target interaction with a script, can I?
Yes.
uCon's basic scripting primitives provide some flexibility for scripts;
but if you really need to get down and dirty then you can write your
scripts using Lua.
Can I start a script by clicking on a button or function key?
Yes.
In the configuration dialogs for buttons (menu item Config->Buttons)
and function keys (Config->Function Keys) there is a check box
column labeled "Script?". If this is checked, then the text for
that particular button/function-key is considered to be a path to a
filename which is then considered to be a script that will be started
when that particular button/key is activated.
I need more programmable buttons/function keys?
uCon
supports a total of 24 (8 funckeys, 16 buttons), but if you need more
than that, you can
allocate a few of the buttons/fkeys to be used to reload other presets.
One of the script commands is FKEY, this allows you to build a
script
to load up the function key (and button) settings. Also, you can
automatically create a script that will re-build your current
function-key/button setup by using the menu itemp
Scripts->Fkey2Script.
I need to insert a timestamp at the start of every line, can I do that?
Yes.
uCon allows you to specify one of several different timestamp
formats that will automatically be inserted at the beginning of each
line. To enable this, go to menu item Config->Timestamp
to open the timestamp dialog box. Pick the format you like
from the drop-down list, and then check the Enabled checkbox.
From then on you will see that each line of output from your
target connection will be preceded by a formatted timestamp.
Notice also that there is a toolbar button (the one with the icon
that looks like an old-style analog clock) that quickly
enables/disables timestamping based on the settings in the dialog.
Once I get all this stuff set up, can I save the configuration?
Yes.
Establish your buttons/function keys and environment and then
click on the Save button or menu item File->SaveAs. Then next
time you start uCon, use the "Pre-established Configuration" group to
browse for your configuration file.
What about help?
uCon
has an extensive set of built-in help information. The installation includes a
complete set html formatted documentation on the local machine;
thus allowing the user to access help information even if the PC is not
connected to the web.
Does uCon run on VISTA, Windows-7/8?
Yes in all cases.
What if I need uCon to do something kinda weird?
The
purpose of uCon's public availability is to interact with users and
hear about other ideas that may be applicable to a program like uCon.
As a result, the author (ed.sutter@nokia.com) is open for just about anything (within reason of course)!