HAM Tutorial :: HAM Install Guide :: HAM 2.7

INSTALL

The first thing you'll need, of course, is the install file. Download the latest full version from here. Save the file to your Desktop (or wherever you normally put your downloaded files).

Once it's finished, you'll have to extract the file before you can begin the install. Double-click the file you downloaded. Under Install to type ham_installer and then click the Install button. This will extract the file to
a directory called ham_installer.

Open the ham_installer folder and double-click setup.exe (or just setup if you have file extensions hidden).

Read the License Agreement and type ok in the box to agree.
Type c:\ham next to Installation Path. I recommend that you leave Create Start Menu Entries in folder called and Create Desktop Icons checked.
Click the Install button.

Wait a few minutes for the installer to finish.
If all goes well you'll get a installation successful notice.

If you left Create Start Menu Entries and Create Desktop Icons checked, you'll see two icons on your Desktop VisualHAM and HAM shell and a new group in your Start Menu called HAM Development Kit.

FIRST TEST COMPILE

Let's go ahead and try a test compile to make sure it's working okay.

Double-click the HAM shell icon.

Go into the helloworld directory in samples. cd samples\helloworld
Type make vba to compile the code and launch the rom in VBA.
Press the ESC key when you've seen enough.

That's it. If you see the image above then you have HAM installed and working properly!

VisualHAM SETUP

Now that we know we can compile from the shell, let's go ahead and setup and test VisualHAM. Double-click the VisualHAM icon on your Desktop (or click the one in your Start Menu). If this is the first time you are launching VisualHAM, a window will pop up telling you to restart VisualHAM before you start working with it. Click OK.

Exit VisualHAM and restart it.

Okay, let's open the helloworld project and compile it!

Click File -> Open Workspace.
Browse to c:\ham\samples\vham-samples\vham_c_helloworld.

Double-click project.vhw (or project if you have file extensions hidden).
You should now see the main.c file in the editor window.

Click Project -> Build + VBA (or just press F7).
It may take a minute or two to compile but soon enough Hello World will pop up on your screen. Press the ESC key when you've seen enough.

That's it. If you see the image above then you have VisualHAM installed and working properly!

One more thing: I find it useful to associate the .vhw file type with VisualHAM. (In VisualHAM) click Help -> Associate ".vhw" Filetype.