- Menu Bar
- Terminal Window
- Source Code Window
- Variables Window
- Registers Window
- Control Window
- HSW12 Macro Language
assembler which has been written in Perl as well. This document gives a quick overview on how to use this software.
Start the HSW12 IDE as follows:
The HSW12 GUI is split up into several windows to give you the freedom to place its components anywhere on the screen. When you launch "hsw12.pl" the six HSW12 windows will pop up on the screen:
There are four menu buttons in the menu bar:
The File Menu contains ten entries:
- New Session
- Starts a new HSW12 session.
- Restore Session
- Restores a previous HSW12 Session.
- Save Session
- Saves the current HSW12 Session.
- Save Session as...
- Saves the current HSW12 Session in a new file.
- Load Source Code
- Loads an assembler source code file.
- Recompile Source Code
- Recompiles the current assembler file.
- Save List File
- Dumps an assembler listing.
- Save Linear S-Record
- Dumps a linear S-Record file.
- Save Paged S-Record
- Dumps a paged S-Record file.
- Quits the HSW12 IDE.
The Preferences menu allows you to select:
The I/O parameters that need to be set are:
This menu selects the port that your D-Bug12 POD is connected to. (Be careful! Don't select the port that your mouse is connected to.)
This menu gives you a few choices to select the baud rate.
There are four setup options to select the S-Record format:
The D-Bug12 POD supports two address formats:
- S19: 16-Bit addresses
- S28: 24-Bit addresses
The number of data bytes per S-record can be selected in this menu.
S5-Records contain the number of S-Records that have already been transmitted. This menu determines how frequently S5-Records should be sent. "None" disables the insertion of S5-Records.
Most target devices only allow full words to be programmed into their flashes. The "Fill Bytes" ensures that all S-Records contain an even number of bytes by inserting $FF wherever necessary.
If this is disabled HSW12 will truncate all addresses down to 16-Bit. If it is enabled addresses in the range from $8000 to $C000 are 24-Bit wide.
The Window Menu lets you reopen or raise a particular HSW12 window. The "All Windows" function reopens or raises all of the HSW12 windows. If the "connect" checkbutton is set, then all the HSW12 windows are connected. Moving one window will make all of them move.
At the moment the Help Menu only consists of an "About" screen which contains the version numbers of the current HSW12 release.
The Terminal Window consists of:
The two entry fields in the Macro Editor let you modify the macro name and the macro sequence. Please find a description of the HSW12 Macro Language below
The Source Code Window has four elements:
- The $HSW12_EDITOR variable should contain a string to launch your favorite editor. It should contain the two symbols "%f" and "%l" which will be substituted by the file name and the line number, i.e.: "emacs +%l %f"
- If $HSW12_EDITOR isn't set HSW12 will look for the variable $WINEDITOR. This variable should only contain the plain editor call. The string "+%l %f" will be appended to the variable's contents automatically.
- If none of the above variables are set HSW12 will try to read the $EDITOR variable. This variable works just like $WINEDITOR except that the editor will be executed in a new "xterm" window. Other terminal windows can be selected through the variable $HSW12_TERMINAL.
HSW12 assembler expression.
The Variables Window contains:
- the start address of the memory range
- the data
- the number of bytes to modify
Each entry expects an HSW12 assembler expression.
The Edit Button opens an Editor for HSW12 Macros to modify the display format.
The Register Window lets you view and alter the MCU's register contents. Its window elements are:
The Control Window has three elements:
- Regular Output Text
- Macro Commands
- Updates all variable and register displays.(Not available for Variables Display macros)
- [upload linear] ([upload])
- Uploads the linear S-Record to the D-Bug12 POD.(Not available for Variables Display macros)
- [upload paged]
- Uploads the paged S-Record to the D-Bug12 POD. (Not available for Variables Display macros)
- Recompiles the current assembler file. (Not available for Variables Display macros)
- [evaluate <expression> <format>]
Evaluates an HSW12 assembler expression (first argument)
and outputs the result. The second argument determines the output format of the integer result.
Valid output formats are:
- nb: n byte integer in binary format
- nd: n byte integer in decimal format
- nh: n byte integer in hexadecimal format
- na: n character ASCII string
- [lookup <expression> <format>]
- Evaluates an HSW12 assembler expression (first argument) and reads the content of this memory address from the MCU. The output is formated as above. If this Macro Command is executed from a Terminal macro, no data will be read from the MCU; only cached data will be used.