Development Env for Apps - FujiNetWIFI/fujinet-firmware GitHub Wiki
- clone cc65 repo:
-
https://github.com/cc65/cc65
- always check out HEAD don't use a release!
git clone https://github.com/cc65/cc65
-
https://github.com/cc65/cc65
- pull down FujiNet Apps repo:
git clone https://github.com/FujiNetWIFI/fujinet-apps- many of the most exciting apps have their own repos so check
- clone FujiNet Build tools repo:
git clone https://github.com/FujiNetWIFI/fujinet-build-tools- this contains tools to help make apple2 and atari disk images
Building works perfectly using a Linux based host. macOS should work but issues have been seen building cc65.
cd cc65
make clean
make
sudo make install
cc65 is most happy in /usr/local and that is where it will install with those defaults. Only change that if you know what you need or you don't have a /usr/local that you can use on your system.
$ cd /fujinet-apps/netcat/apple2
$ make
mkdir -p obj/apple2enh
cl65 -t apple2enh -c --create-dep obj/apple2enh/main.d -Os -DBUILD_APPLE2 -o obj/apple2enh/main.o src/main.c
cl65 -t apple2enh -c --create-dep obj/apple2enh/sp.d -Os -DBUILD_APPLE2 -o obj/apple2enh/sp.o src/sp.c
cl65 -t apple2enh -o netcat obj/apple2enh/main.o obj/apple2enh/sp.o
The binary is created as a file name netcat. Now we need to wrap that into a bootable .po image.
$ make dist
cp dist.apple2/bootable.po dist.apple2/dist.po
java -jar dist.apple2/ac.jar -as dist.apple2/dist.po netcat.system sys <netcat
Now the .po disk image is created, move it to a location where you can mount it on your FujiNet. I have a folder setup to hold the files till I push them over into my TNFS server...
$ cp dist.apple2/dist.po ~/scratch/fujinet-app-staging/netcat-ssh.po
To build apps and make disk images out of them the dir2atr tool is used. Here are some steps on building that system for a Unix based system (below are details for a Macintosh Apple Silicon ARM based system).
- there is a dep for atasm, which is easily installed via brew for Macintosh systems....
$ brew install atasm
$ git clone https://github.com/FujiNetWIFI/fujinet-build-tools
$ cd fujinet-build-tools/
$ cd AtariSIO/
$ cd tools
$ make -f Makefile.posix CXX=clang++
$ dir2atr
dir2atr 0.30-221009
(c) 2004-2022 Matthias Reichl <[email protected]>
usage: dir2atr [-admpSDEPQ] [-b <DOS>] [-B file] [sectors] atrfile directory
-d create double density image (default: single density)
-m create MyDOS image (default: DOS 2.x)
-S/E/D/Q create standard SD/ED/DD/QD image
-p create PICONAME.TXT (long filename description)
-P create PICONAME.TXT (with file extensions stripped)
-a enable MyPicoDos autorun mode
-b <DOS> create bootable disk for specified DOS
Supported DOS are: Dos20, Dos25, OSAplus210, DosXL230
MyDos4533, MyDos4534, MyDos455Beta4
TurboDos21, TurboDos21HS, XDos243F, XDos243N,
MyPicoDos403, MyPicoDos403HS,
MyPicoDos404, MyPicoDos404N, MyPicoDos404R, MyPicoDos404RN,
MyPicoDos404B,
MyPicoDos405, MyPicoDos405A, MyPicoDos405N,
MyPicoDos405R, MyPicoDos405RA, MyPicoDos405RN,
MyPicoDos405B, MyPicoDos405S0, MyPicoDos405S1, PicoBoot405
MyPicoDos406, MyPicoDos406A, MyPicoDos406N
MyPicoDos406R, MyPicoDos406RA, MyPicoDos406RN
MyPicoDos406B, MyPicoDos406S0, MyPicoDos406S1, PicoBoot406
-B <FILE> load boot sector data from <FILE>
Copy dir2atr into a directory in your $PATH:
cp dir2atr /usr/local/bin
Now you can use makefiles in this ecosystem that assume that dir2atr is on your system and read to create the .ATR disk images that Fujinet will use with the Atari computer.
Build an app for Atari is a one step process. make will build, link and create a XEX or ATR file for the Atari. There is no need to wrap this xex file into an ATR as the FujiNet does this dynamically at load & boot time.
MediaTypeXEX in FujiNet firmware builds a synthetic disk with a DOS 2 filesystem, puts picoboot.bin in the first three sectors, which loads the first file on the disk, which as part of the process, a quick set of directory sectors is built to do this. all in memory.
~/.../netcat/atari(master)]$ make
mkdir -p obj/atari
cl65 -t atari -c --create-dep obj/atari/conio.d -Oris -o obj/atari/conio.o src/conio.c
src/conio.c:11: Warning: Pointer conversion to 'void *' from 'const char *' discards qualifiers
cl65 -t atari -c --create-dep obj/atari/err.d -Oris -o obj/atari/err.o src/err.c
cl65 -t atari -c --create-dep obj/atari/main.d -Oris -o obj/atari/main.o src/main.c
src/main.c:150: Warning: Pointer conversion to 'char *' from 'unsigned char * const' changes pointee signedness
src/main.c:203: Warning: Pointer conversion to 'const char *' from 'unsigned char * const' changes pointee signedness
cl65 -t atari -c --create-dep obj/atari/nio.d -Oris -o obj/atari/nio.o src/nio.c
cl65 -t atari -Wa -DDYN_DRV=0 -c --create-dep obj/atari/cio.d -o obj/atari/cio.o src/cio.s
cl65 -t atari -Wa -DDYN_DRV=0 -c --create-dep obj/atari/intr.d -o obj/atari/intr.o src/intr.s
cl65 -t atari -Wa -DDYN_DRV=0 -c --create-dep obj/atari/sio.d -o obj/atari/sio.o src/sio.s
cl65 -t atari --mapfile netcat.map -o netcat.xex -C src/atari.cfg obj/atari/conio.o obj/atari/err.o obj/atari/main.o obj/atari/nio.o obj/atari/cio.o obj/atari/intr.o obj/atari/sio.o
$ cp netcat.xex ~/scratch/fujinet-app-staging/netcat-ssh.xex
Your methods will vary. But get these new files onto a TNFS server so you and other can use them...
$ cd ~/scratch/fujinet-app-staging
$ scp netcat-ssh.po 192.168.3.33:fujinet_tnfsd/server_root/APPLE/
$ scp netcat-ssh.xex 192.168.3.33:fujinet_tnfsd/server_root/ATARI/
More apps are available to hack on...