Atari Lynx Programming Template (working as of January 11, 2023)

[OldAtAtari]

Hello, all.

 

The karri/nop90 template was no longer working, due to some changes in the cc65 tool.

 

I've uploaded a fixed template. It should work immediately with no bugs, assuming that cc65 has already been correctly installed in your environment.

 

If you see any problems with it, please let me know.

 

The directory is here:

https://github.com/OldAtAtari/template/

 

To clone it directly into your Linux workarea:

git clone https://github.com/oldatatari/template/

Edited January 18 by OldAtAtari

[pwwit1]

This works perfectly. Thank you!

Just in case anyone is trying to setup a Lynx build environment from a clean Ubuntu install, the full steps are:

 

Install requirements:

sudo apt-get install git build-essential checkinstall

 

Install the Atari Lynx tools and compiler:

git clone https://bitbucket.org/atarilynx/lynx.git
cd lynx/tools
make -f Makefile.deb

 

Check the installation worked:

$ cc65
cc65: No input files

 

Clone OldAtAtari's template:

git clone https://github.com/oldatatari/template/
cd template
make

 

This should create a 'game.lnx' in the template/game directory!

You can run game.lnx with an emulator, or on actual hardware.

 

For an emulator, you can use 'Mednafen', to set it up:

sudo apt-get install mednafen

 

Mednafen requires a lynx boot image called 'lynxboot.img', you can find it online easily. 

Once downloaded, copy 'lynxboot.img' to where Mednafen requires it:

cp ~/Downloads/lynxboot.img ~/.mednafen/firmware/

 

Now you can run your game.lnx with:

mednafen game.lnx

 

Hope this helps!

[OldAtAtari]

On 1/15/2023 at 1:25 AM, pwwit1 said:

This works perfectly. Thank you!

Just in case anyone is trying to setup a Lynx build environment from a clean Ubuntu install, the full steps are:

 

Install requirements:

sudo apt-get install git build-essential checkinstall

 

Install the Atari Lynx tools and compiler:

git clone https://bitbucket.org/atarilynx/lynx.git
cd lynx/tools
make -f Makefile.deb

 

Check the installation worked:

$ cc65
cc65: No input files

 

Clone OldAtAtari's template:

git clone https://github.com/oldatatari/template/
cd template
make

 

This should create a 'game.lnx' in the template/game directory!

You can run game.lnx with an emulator, or on actual hardware.

 

For an emulator, you can use 'Mednafen', to set it up:

sudo apt-get install mednafen

 

Mednafen requires a lynx boot image called 'lynxboot.img', you can find it online easily. 

Once downloaded, copy 'lynxboot.img' to where Mednafen requires it:

cp ~/Downloads/lynxboot.img ~/.mednafen/firmware/

 

Now you can run your game.lnx with:

mednafen game.lnx

 

Hope this helps!

 

Thank you! I'm so glad you tried it and got it working with no major issues. And your procedure write-up is terrific. I really appreciate that.

[42bs]

For non-linux, a slight change to Makefile.deb

 

.ONESHELL:
installcc65:
    cd cc65
ifeq ($(findstring linux, ($OSTYPE)),linux)
    sudo checkinstall --pkgname=cc65 \
        --pkgversion="14.09" --backup=no \
        --deldoc=yes --fstrans=no --default \
        make -f make/gcc.mak install
    sudo ldconfig
    cp cc65/cc65*.deb -t $(PKGS)
else
    make -f make/gcc.mak install
endif

 

Works on MacOS.