More documentation to be written as it takes shape.
This repo is the primary repo for the CONFIG application for every supported platform on FujiNet.
In the beginning there was only Atari. And so the CONFIG application was just called fujinet-config. Then came the ADAM and now common code for all the platforms began to take shape in this repo. Apple II soon joined, then RC2014 and soon C64. Atari was merged back in here in 2022 Fall by frachel so there is one place for all platform CONFIGs going forward.
CONFIG is the primary management application for the FujiNet device. It manages the WIFI connections and credentials, the SD card if one is inserted , and it traverses the HOSTS for images to mount in the Virtual SLOTS. The main page of CONFIG is the familiar HOSTS and SLOTS view that greets most people at boot with a FN device active on their system. CONFIG also can copy images to and from the SD card (Atari) and it has it's own configuration screen that shows the current network configuration of the ESP32 on your local network.
The CONFIG application must be coded and compiled to build a native binary application for each host platform. Then there are some scripts used to copy the CONFIG application to a bootable disk image for each platform. The process for those steps varies by platform. The final bootable disk image is then used in the main fujinet repo to flash the fs on the FN with the disk image, which is then loaded and mounted when you are booting the system without a virtual mounted disk.
To compile, currently requires:
For unix environments:
$ PREFIX=/usr/local/cc65 make
$ sudo PREFIX=/usr/local/cc65 make installFor MSYS2 environments, you must be in an MSYS2 shell, and then install with
$ PREFIX=/usr/local/cc65 make
$ PREFIX=/usr/local/cc65 make installNote the lack of sudo.
After this, you can use any subsystem shell (e.g. UCRT64) to run cc65 as normal.
WARNING: If you are in a MinGW shell or any other sub-environment, the install will work, but will not be able to find the installed cfg, lib etc files. You must be in the MSYS2 shell for compiling and installing cc65, but not to run it.
Building config also requires these additional tools:
-
dir2atr - https://www.horus.com/~hias/atari/atarisio/atarisio-221009.tar.gz
- download, build and install on your local build system
-
https://github.com/FujiNetWIFI/fujinet-config-tools
- clone that repo and then do a
make distin order to get the ftools built for atari - these are copied over to the FujiNet Atari Boot Disk to have available from DOS if needed
- clone that repo and then do a
Now with those prerequisites out of the way:
$ make -f Makefile.atari clean dist
Check for any errors. If sucessful there will be a log line:
created image "autorun.atr"
copy autorun.atr to ~//fujinet-platformio/data/BUILD_ATARI/ and then using PIO "Upload Filesystem Image" to load the new image onto the FujiNet. Your new CONFIG should be ready to test and use.
To compile, currently requires:
$ PREFIX=/usr/local/cc65 make
$ sudo PREFIX=/usr/local/cc65 make install
git clone https://github.com/FujiNetWIFI/fujinet-platformio.git
git clone https://github.com/FujiNetWIFI/fujinet-config.git
- You need the platformIO repo because the build script expects it to be in the same directory as CONFIG, so that it can push the completed Apple boot disk into the proper folder to be pushed to the FN device.
Now with those prerequisites out of the way:
cd fujinet-config-adam.git
$ make -f Makefile.apple2 clean dist
Check for any errors. If sucessful there will be logs that say:
...
java -jar dist.apple2/ac.jar -as dist.apple2/dist.po config.system sys <config
cp dist.apple2/dist.po ../fujinet-platformio/data/BUILD_APPLE/autorun.po
you will find your autorun.po in the directory indicated above. You can now flash this to the FN using the PIO's Upload Filesytem Image.
These instructions allow Apple IIgs users to build native GS/OS versions of CONFIG. Note that for generating the firmware version, instructions under Compiling on the Apple II above still apply.
Two makefiles allow building GS/OS versions of CONFIG:
- Makefile.apple2gs builds a standalone ORCA shell EXE which can then be installed in the Utilities folder.
- Makefile.apple2cda builds a Classic Desk Accessory (CDA) which allows configuring wifi and mounting/umounting images on the go under GS/OS or ProDOS 8, without need for rebooting.
To compile, currently requires:
Note: you'll have to buy GoldenGate before being able to build it. See the project page: https://goldengate.gitlab.io/.
A copy of the Byte Works ORCA/C and its libraries is also required. You can get it there: https://juiced.gs/store/opus-ii-software/.
Detailed instuctions for building the GoldenGate binaries are given in the project README.md. For installation of GoldenGate and ORCA/C components, see https://goldengate.gitlab.io/manual/#installation.
In addition, cc65 headers conio.h, apple2.h and peekpoke.h are necessary and should be present in ORCA/C include search path. You may copy them under ~/GoldenGate/Libraries/cc65. These are available here: https://github.com/cc65/cc65/tree/master/include.
Now with those prerequisites out of the way:
To build the ORCA shell EXE:
cd fujinet-config-adam.git
$ make -f Makefile.apple2gs clean dist
Check for any errors. If successful there will be logs that say:
...
cp dist.apple2/bootable.po dist.apple2/dist.po
java -jar dist.apple2/ac.jar -p dist.apple2/dist.po config exe <config
You will find the CONFIG shell EXE in the disp.po image. Just copy it under prefix #17, then add this to 15:SYSCMND:
CONFIG U configure Fujinet
Restart ORCA shell or issue a commands 15:syscmnd and you're ready.
To build the CDA:
cd fujinet-config-adam.git
$ make -f Makefile.apple2cda clean dist
Check for any errors. If successful there will be logs that say:
...
cp dist.apple2/bootable.po dist.apple2/dist.po
java -jar dist.apple2/ac.jar -p dist.apple2/dist.po fuji.da cda <config
You will find the FUJI.DA CDA in the disp.po image. Just copy it on your GS/OS boot disk under System/Desc.Accs and you'll have FujiNet Config in the Desk Accessories menu after a reboot.
To compile, currently requires:
- make
- Z88DK (http://github.com/z88dk/z88dk)
- eoslib (http://github.com/tschak909/eoslib)
- smartkeyslib (http://github.com/tschak909/smartkeyslib)
Make using 'make -f ' where file is Makefile.
To compiled, currently requires:
- make
- Z88DK (http://github.com/z88dk/z88dk)
- fujinet-rc2014 (https://github.com/juzzas/fujinet-rc2014)
Make using make -f Makefile.rc2014
