Merge pull request #1 from Ripjetski6502/FujiNet-and-APE

FujiNet, APE Time, and SIO

Author: Ripjetski6502

A8CLibReference_100.pdf renamed to A8CLibReference_120.pdf

@@ -3,13 +3,17 @@
 # A8 C Window Library
 Atari 8 Bit Text Mode Windowing Library written in C (CC65).
 
-This is a text mode windowing library complete with window controls and modern gadgets (widgets).  The gadgets allow you to build input forms that use buttons, radio buttons, input strings (with scrolled lengths and type restrictions), check boxes, progress bars, etc.  This allows you to build applications with "modern"-ish interfaces.  
+This is a text mode windowing library complete with window controls and modern gadgets (widgets).  The gadgets allow you to build input forms that use buttons, radio buttons, input strings (with scrolled lengths and type restrictions), check boxes, progress bars, etc.  This allows you to build applications with "modern"-ish interfaces.  I refer to this as a TUI - Text User Interface.  
 
 The windowing system preserves the contents under a window, but is not z-order based (by design).  It is up to you to open and close windows in the correct order.  Complete sample programs are included, as well as full API documentation.
 
 I originally wrote this in Action! language for the Atari 8 bit starting in 2015.  I added to it continually up through this year (2022).
 
-I ran into some limitations with the Action! version in a project regarding memory space and function paramater size when compiled into a standlone executable.  This prompted the conversion into C.   I considered several C implementations on the Atari 8 bit itself, then settled on CC65 to use modern development tools and target the A8 platform.
+I ran into some limitations with the Action! version in a project regarding memory space and function paramater size when compiled into a standlone executable.  This prompted the conversion into C.   I considered several C implementations on the Atari 8 bit itself, then settled on CC65 to use modern development tools and target the A8 platform.  The C version is now the primary version of the library, and has advanced beyond the Action! version.
+
+Version 1.1 brought the addition of APE Time bindings to the library, which allows the retrieval of the date and time from an APE Time compatible device or software.  This was unpublished because I was also working on the 1.2 release which I thought would be right on the APE bindings heals.  
+
+Version 1.2 brings the addition of FujiNet bindings to the library.  This consists of a core set of functions for communicating with the FujiNet (opening connections, reading from, writing to, and closing connections, etc).  It also includes Base64 encoding and decoding by means of the FujiNet, as well as hashing using SHA1, SHA256, and SHA512.  Offloading these compute intensive operations to the FujiNet, yet enabling the Atari to work with them!
 
 License: GNU General Public License v3.0
 

README.md

@@ -0,0 +1,28 @@
+// --------------------------------------------------
+// Library: a8defape.h
+// Desc...: Atari 8 Bit Library ApeTime definitions
+// Author.: Wade Ripkowski
+// Date...: 2023.02
+// License: GNU General Public License v3.0
+// Note...:
+// Revised:
+// --------------------------------------------------
+
+#ifndef A8DEFAPE_H
+#define A8DEFAPE_H
+
+// --------------------------------------------------
+// Definitions
+// --------------------------------------------------
+
+// APE Time
+#define APEDEVID 0x45
+#define APEGTIME 0x93
+
+
+// --------------------------------------------------
+// Function Prototypes
+// --------------------------------------------------
+void ApeTimeG(char *cB);
+
+#endif

bin/apedemo.xex

@@ -0,0 +1,99 @@
+// --------------------------------------------------
+// Library: a8deffuji.h
+// Desc...: Atari 8 Bit Library FujiNet definitions
+// Author.: Wade Ripkowski
+// Date...: 2023.02
+// License: GNU General Public License v3.0
+// Note...:
+// Revised:
+// --------------------------------------------------
+
+#ifndef A8DEFFUJI_H
+#define A8DEFFUJI_H
+
+// --------------------------------------------------
+// Definitions
+// --------------------------------------------------
+
+// FujiNet Devices
+#define FNRAWID 0x70
+#define FNDEVID 0x71
+
+// FujiNet Commands - Device $70 (raw)
+#define FNRWFSTAT  0xFA
+#define FNRGCONFIG 0xE8
+
+// FujiNet Commands - Device $71
+#define FNCCLOSE 'C'
+#define FNCHASH  'H'
+#define FNCOPEN  'O'
+#define FNCPARSE 'P'
+#define FNCQUERY 'Q'
+#define FNCREAD  'R'
+#define FNCSTAT  'S'
+#define FNCTRAN  'T'
+#define FNCWRITE 'W'
+#define FNCTIMER 'Z'
+
+// FujiNet Commands - TCP
+#define FNPACCEPT 'A'
+#define FNPCLOSE  'c'
+#define FNPUDP    'D'
+#define FNPHTTPCH 'M'
+
+// FujiNet Translation Modes
+#define FNTRNONE 0
+#define FNTRCR   1
+#define FNTRLF   2
+#define FNTRCRLF 3
+
+// FujiNet Aux Modes
+#define FNAXREAD    4
+#define FNAXWRITE   8
+#define FNAXUPDATE 12
+
+// FujiNet Device WiFi Status
+#define FNDSIDLE     0
+#define FNDSNOSSID   1
+#define FNDSSCANC    2
+#define FNDSACTIVE   3
+#define FNDSLCFAIL   4
+#define FNDSWIFILOST 5
+#define FNDSWIFIDISC 6
+
+// FujiNet Function Errors/Status
+#define FNSOK     1
+#define FNEDISCO -1
+
+// Library Encoding/Decoding parameter support
+#define FNLENCODE  'E'
+#define FNLDECODE  'D'
+
+// FujiNet Adapter Config structure
+#define FNCONFIGSZ 140
+typedef struct {
+    char ssid[33];
+    char hostname[64];
+    unsigned char ip[4];
+    unsigned char gateway[4];
+    unsigned char netmask[4];
+    unsigned char dns[4];
+    unsigned char mac[6];
+    unsigned char bssid[6];
+    char version[15];
+} td_fncfg;
+
+
+// --------------------------------------------------
+// Function Prototypes
+// --------------------------------------------------
+unsigned char FNStatus(void);
+void FNTrans(unsigned char bM, unsigned char bD);
+unsigned char FNOpen(char *cB);
+unsigned char FNClose(void);
+unsigned short FNCheck(void);
+unsigned char FNRead(unsigned short iS, unsigned char *cB);
+unsigned char FNWrite(unsigned char *cB);
+unsigned char FNGConfig(td_fncfg *sC);
+
+#endif

bin/appdemo.xex

@@ -0,0 +1,38 @@
+// --------------------------------------------------
+// Library: a8deffujib64.h
+// Desc...: Atari 8 Bit Library FujiNet Base64 definitions
+// Author.: Wade Ripkowski
+// Date...: 2023.08
+// License: GNU General Public License v3.0
+// Note...:
+// Revised:
+// --------------------------------------------------
+
+#ifndef A8DEFFUJIB64_H
+#define A8DEFFUJIB64_H
+
+// --------------------------------------------------
+// Definitions
+// --------------------------------------------------
+
+// FujiNet Commands - Device $70 (raw)
+// Base 64
+#define FNRB64ENCINP 0xD0
+#define FNRB64ENCCMP 0xCF
+#define FNRB64ENCLEN 0xCE
+#define FNRB64ENCOUT 0xCD
+#define FNRB64DECINP 0xCC
+#define FNRB64DECCMP 0xCB
+#define FNRB64DECLEN 0xCA
+#define FNRB64DECOUT 0xC9
+
+
+// --------------------------------------------------
+// Function Prototypes
+// --------------------------------------------------
+unsigned char FNB64Inp(char cT, char *cB, unsigned short iS);
+unsigned char FNB64Cmp(char cT);
+unsigned char FNB64Len(char cT, unsigned long *iS);
+unsigned char FNB64Out(char cT, char *cB, unsigned short iS);
+
+#endif