amforth-devel

[Amforth] Building AmForth using Atmel Studio 6.1 Components

[craig a. h. <ca...@gm...>]

I've written this technique up in the hope it will help others.

Instructions for Building amforth-5-1 using Atmel Studio 6.1 Components
Craig Lindley
November, 2013

Motivation

Building AmForth requires a compatible assembler. Atmel Studio 6.1 for
Windows includes avrasm2.exe
which works great for this process but using Atmel Studio is overkill in my
opinion. On my Mac
Atmel Studio 6.1 takes forever to load and execute (using the Parallel's
Desktop) plus it crashes half
the time when I try to make changes to my amforth project's configuration.

I wanted to be able to quickly make changes to AmForth and turn around new
hex and eep files for
downloading into an Arduino Uno. Note: the technique I discuss here can be
used for any Atmel target
hardware, not just an Arduino Uno.

Prerequisites

1. Download and installation of the free version of Atmel Studio 6.1 on a
Windows computer
2. Being comfortable running a command prompt in the Windows environment

Process

1. Create a project directory into which we are going to copy a bunch of
files
   I chose c:\amforth for my project directory.

2. Copy avrasm2.exe and the complete include directory from
   c:\Program Files\Atmel\Atmel Toolchain\AVR
Assembler\Native\2.1.39.1005\avrassembler
   into the project directory

3. Uncompress and un tar the amforth-5.1 distribution file
(amforth-5.1.tar.gz) into the project directory

4. Go into the amforth-5.1\appl\arduino directory of the distribution and
copy uno.asm, dict_appl_code.inc,
   dict_appl.inc and the words directory into the project directory.

5. Go into the amforth-5.1\core\devices directory and find the directory
named with the processor you are
   going to use (in my case atmega328p) and from that directory copy
device.asm and device.inc into the
   project directory.

6. Create a bat file in the project directory with the following content:

   REM batch file for assembling amforth on windows
   avrasm2.exe -fI -o uno.hex -e uno.eep -l uno.lst -I .\ -I
amforth-5.1\core -I include -v0 uno.asm

   I named my bat file make.bat.

When you have completed these steps you should have a directory structure
as follows:

c:\amforth          - your project directory
  amforth-5.1       - the uncompressed and untarred amforth-5.1 distribution
    appl
    core
    doc
    . . .
  include           - copied from c:\Program Files\Ateml\Atmel
Toolchain\AVR Assembler\Native\2.1.39.1005\avrassembler
  words
    applturnkey.asm
  avrasm2.exe       - copied from c:\Program Files\Ateml\Atmel
Toolchain\AVR Assembler\Native\2.1.39.1005\avrassembler
  device.asm
  device.inc
  dict_appl.inc
  dict_appl_core.inc
  make.bat

If all is well, change directory to your project directory and type make
from a command prompt. In less than a
second you will have the new amforth files (hex file and eep file) for
programming into you target hardware.
You could now uninstall Atmel Studio if you want as it is no longer
required.

Making changes to amforth is now very easy and turn around is very fast.

Cheers for AmForth!

-- 
Craig Lindley

If you’re one in a million, there are now seven thousand people exactly
like you.

Re: [Amforth] Building AmForth using Atmel Studio 6.1 Components

[craig a. h. <ca...@gm...>]

Posting of this mail message messed up the formatting. Send email to
ca...@gm... if you would like the original file.

CL


On Sat, Nov 16, 2013 at 11:24 AM, craig and heather <ca...@gm...>wrote:

> I've written this technique up in the hope it will help others.
>
> Instructions for Building amforth-5-1 using Atmel Studio 6.1 Components
> Craig Lindley
> November, 2013
>
> Motivation
>
> Building AmForth requires a compatible assembler. Atmel Studio 6.1 for
> Windows includes avrasm2.exe
> which works great for this process but using Atmel Studio is overkill in
> my opinion. On my Mac
> Atmel Studio 6.1 takes forever to load and execute (using the Parallel's
> Desktop) plus it crashes half
> the time when I try to make changes to my amforth project's
> configuration.
>
> I wanted to be able to quickly make changes to AmForth and turn around new
> hex and eep files for
> downloading into an Arduino Uno. Note: the technique I discuss here can be
> used for any Atmel target
> hardware, not just an Arduino Uno.
>
> Prerequisites
>
> 1. Download and installation of the free version of Atmel Studio 6.1 on a
> Windows computer
> 2. Being comfortable running a command prompt in the Windows environment
>
> Process
>
> 1. Create a project directory into which we are going to copy a bunch of
> files
>    I chose c:\amforth for my project directory.
>
> 2. Copy avrasm2.exe and the complete include directory from
>    c:\Program Files\Atmel\Atmel Toolchain\AVR
> Assembler\Native\2.1.39.1005\avrassembler
>    into the project directory
>
> 3. Uncompress and un tar the amforth-5.1 distribution file
> (amforth-5.1.tar.gz) into the project directory
>
> 4. Go into the amforth-5.1\appl\arduino directory of the distribution and
> copy uno.asm, dict_appl_code.inc,
>    dict_appl.inc and the words directory into the project directory.
>
> 5. Go into the amforth-5.1\core\devices directory and find the directory
> named with the processor you are
>    going to use (in my case atmega328p) and from that directory copy
> device.asm and device.inc into the
>    project directory.
>
> 6. Create a bat file in the project directory with the following content:
>
>    REM batch file for assembling amforth on windows
>    avrasm2.exe -fI -o uno.hex -e uno.eep -l uno.lst -I .\ -I
> amforth-5.1\core -I include -v0 uno.asm
>
>    I named my bat file make.bat.
>
> When you have completed these steps you should have a directory structure
> as follows:
>
> c:\amforth          - your project directory
>   amforth-5.1       - the uncompressed and untarred amforth-5.1
> distribution
>     appl
>     core
>     doc
>     . . .
>   include           - copied from c:\Program Files\Ateml\Atmel
> Toolchain\AVR Assembler\Native\2.1.39.1005\avrassembler
>   words
>     applturnkey.asm
>   avrasm2.exe       - copied from c:\Program Files\Ateml\Atmel
> Toolchain\AVR Assembler\Native\2.1.39.1005\avrassembler
>   device.asm
>   device.inc
>   dict_appl.inc
>   dict_appl_core.inc
>   make.bat
>
> If all is well, change directory to your project directory and type make
> from a command prompt. In less than a
> second you will have the new amforth files (hex file and eep file) for
> programming into you target hardware.
> You could now uninstall Atmel Studio if you want as it is no longer
> required.
>
> Making changes to amforth is now very easy and turn around is very fast.
>
> Cheers for AmForth!
>
> --
> Craig Lindley
>
> If you’re one in a million, there are now seven thousand people exactly
> like you.
>



-- 
Craig Lindley / Heather Hubbard

New Recordings: craigandheather.net/cnmpage.html
Latest CD: craigandheather.net/songsilike2013cd.html

Personal Website: craigandheather.net
Business Website: clockwork.craigandheather.net
Phone: (719) 495-1873
Cell: (719) 502-7925

If you’re one in a million, there are now seven thousand people exactly
like you.

Re: [Amforth] Building AmForth using Atmel Studio 6.1 Components

[Matthias T. <mt...@we...>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi Craig,

> Posting of this mail message messed up the formatting. Send email
> to ca...@gm... if you would like the original file.

How about
http://amforth.sourceforge.net/UG/quick-windows.html ?

I Hope you like it. Your text is great, thank you for it.

Matthias

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iEYEARECAAYFAlKHxjoACgkQ9bEHdGEMFjMhOgCgk1SUiRRKtUIN7hMYknhhFb41
pXoAoO3ySq9lW/P5GzY0A4xVEF7se46e
=d332
-----END PGP SIGNATURE-----

Re: [Amforth] Building AmForth using Atmel Studio 6.1 Components

[craig a. h. <ca...@gm...>]

Matthias

The writeup looks great except all of the back slashes in the
directory paths are missing.

CL



On Sat, Nov 16, 2013 at 11:24 AM, craig and heather <ca...@gm...>wrote:

> I've written this technique up in the hope it will help others.
>
> Instructions for Building amforth-5-1 using Atmel Studio 6.1 Components
> Craig Lindley
> November, 2013
>
> Motivation
>
> Building AmForth requires a compatible assembler. Atmel Studio 6.1 for
> Windows includes avrasm2.exe
> which works great for this process but using Atmel Studio is overkill in
> my opinion. On my Mac
> Atmel Studio 6.1 takes forever to load and execute (using the Parallel's
> Desktop) plus it crashes half
> the time when I try to make changes to my amforth project's
> configuration.
>
> I wanted to be able to quickly make changes to AmForth and turn around new
> hex and eep files for
> downloading into an Arduino Uno. Note: the technique I discuss here can be
> used for any Atmel target
> hardware, not just an Arduino Uno.
>
> Prerequisites
>
> 1. Download and installation of the free version of Atmel Studio 6.1 on a
> Windows computer
> 2. Being comfortable running a command prompt in the Windows environment
>
> Process
>
> 1. Create a project directory into which we are going to copy a bunch of
> files
>    I chose c:\amforth for my project directory.
>
> 2. Copy avrasm2.exe and the complete include directory from
>    c:\Program Files\Atmel\Atmel Toolchain\AVR
> Assembler\Native\2.1.39.1005\avrassembler
>    into the project directory
>
> 3. Uncompress and un tar the amforth-5.1 distribution file
> (amforth-5.1.tar.gz) into the project directory
>
> 4. Go into the amforth-5.1\appl\arduino directory of the distribution and
> copy uno.asm, dict_appl_code.inc,
>    dict_appl.inc and the words directory into the project directory.
>
> 5. Go into the amforth-5.1\core\devices directory and find the directory
> named with the processor you are
>    going to use (in my case atmega328p) and from that directory copy
> device.asm and device.inc into the
>    project directory.
>
> 6. Create a bat file in the project directory with the following content:
>
>    REM batch file for assembling amforth on windows
>    avrasm2.exe -fI -o uno.hex -e uno.eep -l uno.lst -I .\ -I
> amforth-5.1\core -I include -v0 uno.asm
>
>    I named my bat file make.bat.
>
> When you have completed these steps you should have a directory structure
> as follows:
>
> c:\amforth          - your project directory
>   amforth-5.1       - the uncompressed and untarred amforth-5.1
> distribution
>     appl
>     core
>     doc
>     . . .
>   include           - copied from c:\Program Files\Ateml\Atmel
> Toolchain\AVR Assembler\Native\2.1.39.1005\avrassembler
>   words
>     applturnkey.asm
>   avrasm2.exe       - copied from c:\Program Files\Ateml\Atmel
> Toolchain\AVR Assembler\Native\2.1.39.1005\avrassembler
>   device.asm
>   device.inc
>   dict_appl.inc
>   dict_appl_core.inc
>   make.bat
>
> If all is well, change directory to your project directory and type make
> from a command prompt. In less than a
> second you will have the new amforth files (hex file and eep file) for
> programming into you target hardware.
> You could now uninstall Atmel Studio if you want as it is no longer
> required.
>
> Making changes to amforth is now very easy and turn around is very fast.
>
> Cheers for AmForth!
>
> --
> Craig Lindley
>
> If you’re one in a million, there are now seven thousand people exactly
> like you.
>



-- 
Craig Lindley / Heather Hubbard

New Recordings: craigandheather.net/cnmpage.html
Latest CD: craigandheather.net/songsilike2013cd.html

Personal Website: craigandheather.net
Business Website: clockwork.craigandheather.net
Phone: (719) 495-1873
Cell: (719) 502-7925

If you’re one in a million, there are now seven thousand people exactly
like you.