Copyright: Made with Shalom Help Maker www.danish-shareware.dk/soft/shelpm/


Configure AsmIDE

1. Install AsmIDE on your computer.
Extract the files from the ZIP archive.

Now start AsmIDE.

2. COM Port Selection.
Now it asks if you want to select your COM port. Say Yes.

This configuration item is used to select the COM port that you will use with the Terminal window, and with the Download function.
Pick your port in the dropdown box. It defaults to 9600 baud, which is normally correct.

NOTE: If you will be using the Wytec 68hc11 Tools, then you won't be able to use them same COM port with both the terminal window and the Wytec Tools. It's best to disable the terminal window if you will be using the Wytec Tools, unless you will be using a different COM port.

3. Assembler
Before you press OK, switch to the Assembler tab in this dialog.  (If you pressed OK before coming here, then select "View..Options, Assembler" to return here.

The main configuration item you need to select here is the type of processor you want to use. You must select either 68hc11 or 68hc12 as your Currently Selected Chip Family. This is used to select which Assembler will be executed to assemble your programs. This is also used to select your Assembler helpfile.

This configuration tab also shows the path names of your assembler executables and help files. These will normally be correctly set up for you, but you may need to change them in special situations.

4. Wytec 68hc11 Tools
The Wytec company has a couple proprietary programs used to download .s19 files, and to interact with the debugger on their 68hc11 EVB boards. These tools are only used with the Wytec 68hc11 Phantom monitor. If you have the Buffalo monitor, then you don't need these tools.

If you have the Wytec software loaded on your computer (in the default directories), then the pathnames for the Wytec tools will be setup for you automatically. If you don't have the Wytec tools, then leave these pathnames blank.

You must disable the Wytec tools if you want to use the Terminal window on the same COM port. For obvious reasons, you can't have 2 programs using the same COM port at the same time. However, you can use both the Wytec tools and the Terminal window at the same time if you are using different COM ports.


How to Assemble a sample source file

1. Open the project.
Choose File..Open from the main menu, or else press the Open button on the toolbar (second button from the left).

If you selected the 68hc11 as your current chip family in View..Options, then open file: Ex2-hc11.asm.

If you selected the 68hc12, then open file: Ex2-hc12.asm.

2.  Assemble the file.
When you assemble a source file, it creates a .s19 file that can later be downloaded to your board.

You can assemble the file by selecting Build..Assemble from the main menu, or by clicking on the Assemble button (it has a picture of a gear).


How to create a new Assembler Source file

Select File..New from the main menu, or press the New button (the first button).

This lets you enter the text for your new program.

When you are done, you should remember to Save the file (File..Save, or use the Save button (third button).


How to download an .S19 file to an embedded board

An .s19 file is generated by the assembler. This is the file you use to program your board.

You don't have to open an Assembler source file in order to do a download, but it might be handy for you if you want to open the source file first.

Make sure you Assemble the file if you have made any changes to it.

This function is not designed to be used with the Wytec hc11 Phantom monitor. Please see the special instructions for the Wytec hc11 tools.

Most people who use this function will use the Buffalo monitor with the 68hc11, or the D-bug12 monitor with the 68hc12.

IMPORTANT!  This download function will send the .s19 file directly to your board through the COM port. You have to tell your board to prepare to receive the file BEFORE you actually start the download. This is normally done by giving commands to the monitor on your board by using the terminal window. The actual commands to do this will vary depending on your monitor.

For the D-bug12 monitor:
1) Reset the board by pressing the reset button
2) In the Terminal window, issue the LOAD command

You can do a download by selecting Build..Download from the main menu, or by pressing the Download button (it has a picture of lightning on it). Once you select this function, it lets you pick the file you want to download. Select the file and press Open to begin the download.


How to use the Wytec 68hc11 Tools

The Wytec 68hc11 Tools are proprietary programs developed by the Wytec company. I do not distribute these tools with AsmIDE. You must get the programs with a Wytec board that you purchase.

Their are two Wytec Tools that can be used directly from AsmIDE: the debugger, and the 68hc711 programmer.

These tools should ONLY be used if you have a Wytec 68hc11 board with a Phantom monitor. If you have any other board, or if you are using a Buffalo monitor, then you must not enable the Wytec tools.

The debugger is used to download programs to Wytec 68hc11 boards that have a Phantom monitor. For example, I have the EVBPlus2 board that uses the Phantom monitor. The debugger can also interact with the Phantom monitor to help you run and debug programs. Please see the Wytec documentation for details.

The 68hc711 programmer is used to program the onboard flash memory on the chip.

Before you use the Wytec Tools, make sure that your settings are correct in View..Options on the "Wytec hc11 Tools" tab.

NOTE: If you will be using the Wytec 68hc11 Tools, then you won't be able to use them same COM port with both the terminal window and the Wytec Tools. It's best to disable the terminal window if you will be using the Wytec Tools, unless you will by using a different COM port. To disable the Terminal Window, go to the General Options tab in View..Options, and uncheck the box that says "Enable the Terminal Window".

To download an .s19 file using the Wytec debugger:

You don't have to open an Assembler source file in order to do a download.

Start the Wytec tools by selecting "Build..Wytec hc11 Tools" from the main menu, or by pressing the "Wytec hc11 Tools" button.

Now you get the tools menu. This lets you select the name of the .s19 file you want to download. You can press the Browse button (with three dots) to bring up a dialog box that lets you select a filename.

The first time you select a filename you don't need to press the "Select this file" button. This button is only needed if you have already started the debugger and you want to change to a different filename.

Press the Debugger button to start the Wytec debugger. It will set up your COM port and automatically begin downloading the .s19 file to your board.

Use the "go" command to run your program. You can give it the starting address of your program, or the name of the label for this address.

See the Wytec documentation for details on the various commands.

How to change to another .s19 file while the debugger is running

The "Wytec hc11 Tools" dialog can be used to select a different filename while the debugger is still running. You can select a different filename and press the "Select this file" button. Then, the Wytec debugger can see the new filename and do another download if you press F10 then R from inside the debugger.


General Info

1) To see what function each toolbar button performs, just let your mouse hover over the top of the button.

2) The tabbed-windows along the bottom of the screen can be made larger by grabbing the separator horizontal line and dragging the window to  make it larger or smaller.


Keyboard Shortcuts in Editor

Keyboard Shortcuts

Cursor Position: change the position of the cursor

Left Arrow	Left one character
Right Arrow	Right one character
Up Arrow	Up one line
Down Arrow	Down one line
Control+Left	Left one word
Control+Right	Right one word
Home	Start of line
End	End of line
PgUp	Up one page
PgDn	Down one page
Control+PgUp	Top of page
Control+PgDn	Bottom of page
Control+Home	Begining of file
Control+End	End of file

Selection: control how the currently highlighted text behaves.

Shift+Left	Select left
Shift+Right	Select right
Shift+Up	Select up
Shift+Down	Select down
Control+Shift+Left	Select word left
Control+Shift+Right	Select word right
Shift+Home	Select line start
Shift+End	Select line end
Shift+PgUp	Select PgUp
Shift+PgDn	Select PgDn
Control+Shift+PgUp	Select page top
Control+Shift+PgDn	Select page bottom
Control+Shift+Home	Select editor top
Control+Shift+End	Select gotoxy
Control+A	Select All
Control+C	Copy selection to clipboard

Scrolling:  control everything to do with scrolling.

Scroll Up+Control	Go up one line
Scroll Down+Control	Go down one line
Scroll Left	Left one character
Scroll Right	Right one character

Actions: perform various actions.

Control+Shift+B	Go to matching bracket
Control+(number)	Move to marker (number)
Control+Shift+(number)	Set marker (number)
Enter	Line break at current position, move caret
Control+N	Line break at current position, no move caret
Alt+Backspace	Perform undo if available
Control+Z	Perform undo if available
Alt+Shift+Back	Perform redo if available
Control+Shift+Z	Perform redo if available
Shift+Delete	Remove selection place on clipboard
Control+X	Remove selection place on clipboard
Shift+Insert	Move clipboard contents to current position
Control+V	Move clipboard contents to current position
Control+Shift+I	Move selection to right
Control+Shift+U	Move selection to left
Tab	Tab key
Shift+Tab	Tab to left
Insert	Toggle between Insert and Overwrite mode

Delete:  commands having to do with deleting text.

Backspace	Character to left
Delete	Character to right
Control+T	Word to right
Control+Bkspc	Word to left
Control+Shift+Y	From cursor to end of line
Control+Y	Current line