style update and add rp6502 doc

asminc/rp6502.inc

@@ -1,8 +1,4 @@
-; Copyright (c) 2023 Rumbledethumps
-;
-; SPDX-License-Identifier: Zlib
-; SPDX-License-Identifier: BSD-3-Clause
-; SPDX-License-Identifier: Unlicense
+; Picocomputer 6502 general defines
 
 ; RIA UART
 RIA_READY       := $FFE0 ; TX=$80 RX=$40

cfg/rp6502.cfg

@@ -1,11 +1,3 @@
-#
-# Copyright (c) 2023 Rumbledethumps
-#
-# SPDX-License-Identifier: Zlib
-# SPDX-License-Identifier: BSD-3-Clause
-# SPDX-License-Identifier: Unlicense
-#
-
 SYMBOLS {
     __STARTUP__:   type = import;
     __STACKSIZE__: type = weak, value = $0800;

doc/index.sgml

@@ -175,6 +175,9 @@
   <tag><htmlurl url="plus4.html" name="plus4.html"></tag>
   Topics specific to the Commodore Plus/4.
 
+  <tag><htmlurl url="rp6502.html" name="rp6502.html"></tag>
+  Topics specific to the Picocomputer 6502.
+
   <tag><htmlurl url="supervision.html" name="supervision.html"></tag>
   Topics specific to the Watara Supervision Console.
 

doc/rp6502.sgml

@@ -0,0 +1,96 @@
+<!doctype linuxdoc system>
+
+<article>
+<title>Picocomputer 6502 - specific information for cc65
+<author><url url="mailto:uz@cc65.org" name="Ullrich von Bassewitz">
+
+<abstract>
+An overview over the Picocomputer 6502 and its interfaces to the cc65 C
+compiler.
+</abstract>
+
+<!-- Table of contents -->
+<toc>
+
+<!-- Begin the document -->
+
+<sect>Overview<p>
+
+The Picocomputer 6502 is a modern W65C02S computer with a custom operating
+system designed to be POSIX-like. The reference design includes a W65C02S,
+W65C22S, RP6502-RIA, and optionally a RP6502-VGA. Peripheral devices like
+keyboards, mice, and flash storage are connected by USB to the RP6502-RIA.
+Audio is generated by the RP6502-RIA. Video is generated by the RP6502-VGA.
+
+
+
+<sect>Binary format<p>
+
+The standard binary output format generated by the linker for the RP6502 target
+is a plain machine language program without any prefix or postfix.
+
+The RP6502 Integrated Development Environment, based on Visual Studio Code,
+will convert the cc65 binary output into RP6502 ROM files that can be loaded
+directly from the RP6502 monitor or installed on the RIA to be loaded at boot.
+
+
+
+<sect>Memory layout<p>
+
+<descrip>
+  <tag/Stack/
+  The C run-time stack is located at &dollar;FEFF, and grows downward.
+
+  <tag/Heap/
+  The C heap is located at the end of the program, and grows toward the C
+  run-time stack.
+
+  <tag/RAM/
+  RAM is located at &dollar;0000 - &dollar;FEFF. Default binaries load and
+  start at &dollar;0200.
+
+  <tag/ROM/
+  The RP6502 is designed with no ROM in the 6502 address space.
+
+  <tag/VIA/
+  A Versatile Interface Adapter (6522) is 16 registers located
+  at &dollar;FFD0.
+
+  <tag/RIA/
+  The RP6502 Interface Adapter is 32 registers located at &dollar;FFE0.
+
+  <tag/User/
+  User I/O expansion is from &dollar;FF00 to &dollar;FFCF.
+
+</descrip><p>
+
+
+
+<sect>Platform-specific header files<p>
+
+Programs containing RP6502-specific code may use the <tt/rp6502.h/ or
+<tt/rp6502.inc/ include files.
+
+
+
+<sect>License<p>
+
+This software is provided "as-is", without any expressed or implied
+warranty.  In no event will the authors be held liable for any damages
+arising from the use of this software.
+
+Permission is granted to anyone to use this software for any purpose,
+including commercial applications, and to alter it and redistribute it
+freely, subject to the following restrictions:
+<enum>
+<item>  The origin of this software must not be misrepresented; you must not
+        claim that you wrote the original software. If you use this software
+        in a product, an acknowledgment in the product documentation would be
+        appreciated, but is not required.
+<item>  Altered source versions must be plainly marked as such, and must not
+        be misrepresented as being the original software.
+<item>  This notice may not be removed or altered from any source
+        distribution.
+</enum>
+
+</article>

include/rp6502.h

@@ -1,10 +1,28 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
+/*****************************************************************************/
+/*                                                                           */
+/*                                 rp6502.h                                  */
+/*                                                                           */
+/*                            Picocomputer 6502                              */
+/*                                                                           */
+/*                                                                           */
+/* This software is provided 'as-is', without any expressed or implied       */
+/* warranty.  In no event will the authors be held liable for any damages    */
+/* arising from the use of this software.                                    */
+/*                                                                           */
+/* Permission is granted to anyone to use this software for any purpose,     */
+/* including commercial applications, and to alter it and redistribute it    */
+/* freely, subject to the following restrictions:                            */
+/*                                                                           */
+/* 1. The origin of this software must not be misrepresented; you must not   */
+/*    claim that you wrote the original software. If you use this software   */
+/*    in a product, an acknowledgment in the product documentation would be  */
+/*    appreciated but is not required.                                       */
+/* 2. Altered source versions must be plainly marked as such, and must not   */
+/*    be misrepresented as being the original software.                      */
+/* 3. This notice may not be removed or altered from any source              */
+/*    distribution.                                                          */
+/*                                                                           */
+/*****************************************************************************/
 
 #ifndef _RP6502_H
 #define _RP6502_H

libsrc/rp6502/close.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 #include <errno.h>
 

libsrc/rp6502/codepage.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 
 int __fastcall__ codepage (void)

libsrc/rp6502/crt0.s

@@ -1,10 +1,7 @@
-; Copyright (c) 2023 Rumbledethumps
 ;
-; SPDX-License-Identifier: Zlib
-; SPDX-License-Identifier: BSD-3-Clause
-; SPDX-License-Identifier: Unlicense
-
-; Boilerplate crt0.s
+; 2023, Rumbledethumps
+;
+; crt0.s
 
 .export _init, _exit
 .import _main

libsrc/rp6502/getres.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 #include <time.h>
 

libsrc/rp6502/gettime.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 #include <time.h>
 

libsrc/rp6502/gettimespec.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 #include <time.h>
 
@@ -13,8 +5,7 @@ int __clock_gettimespec(struct timespec *ts, unsigned char op)
 /* Internal method shared by clock_getres and clock_gettime. */
 {
     int ax = ria_call_int_errno (op);
-    if (ax >= 0)
-    {
+    if (ax >= 0) {
         ts->tv_sec = ria_pop_long ();
         ts->tv_nsec = ria_pop_long ();
     }

libsrc/rp6502/gettimezone.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 #include <time.h>
 
@@ -14,8 +6,7 @@ int clock_gettimezone(clockid_t clock_id, struct _timezone *tz)
     int ax;
     ria_set_ax (clock_id);
     ax = ria_call_int_errno (RIA_OP_CLOCK_GETTIMEZONE);
-    if (ax >= 0)
-    {
+    if (ax >= 0) {
         char i;
         for (i = 0; i < sizeof (struct _timezone); i++)
             ((char*)tz)[i] = ria_pop_char ();

libsrc/rp6502/initenv.s

@@ -1,8 +1,6 @@
-; Copyright (c) 2023 Rumbledethumps
 ;
-; SPDX-License-Identifier: Zlib
-; SPDX-License-Identifier: BSD-3-Clause
-; SPDX-License-Identifier: Unlicense
+; 2023, Rumbledethumps
+;
 
 .constructor initenv, 24
 .import __environ, __envcount, __envsize

libsrc/rp6502/irq.s

@@ -1,8 +1,7 @@
-; Copyright (c) 2023 Rumbledethumps
 ;
-; SPDX-License-Identifier: Zlib
-; SPDX-License-Identifier: BSD-3-Clause
-; SPDX-License-Identifier: Unlicense
+; 2023, Rumbledethumps
+;
+; Enables the C IRQ tools
 
 .export initirq, doneirq
 .import callirq, _exit

libsrc/rp6502/lrand.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 
 long __fastcall__ lrand (void)

libsrc/rp6502/lseek.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 #include <unistd.h>
 

libsrc/rp6502/mainargs.s

@@ -1,8 +1,7 @@
-; Copyright (c) 2023 Rumbledethumps
 ;
-; SPDX-License-Identifier: Zlib
-; SPDX-License-Identifier: BSD-3-Clause
-; SPDX-License-Identifier: Unlicense
+; 2023, Rumbledethumps
+;
+; No arguments
 
 .constructor initmainargs, 24
 .import __argc, __argv

libsrc/rp6502/open.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 #include <errno.h>
 #include <string.h>
@@ -13,12 +5,10 @@
 int __cdecl__ open (const char* name, int flags, ...)
 {
     size_t namelen = strlen (name);
-    if (namelen > 255)
-    {
+    if (namelen > 255) {
         return _mappederrno (EINVAL);
     }
-    while (namelen)
-    {
+    while (namelen) {
         ria_push_char (name[--namelen]);
     }
     ria_set_ax (flags);

libsrc/rp6502/phi2.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 
 int __fastcall__ phi2 (void)

libsrc/rp6502/randomize.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 #include <stdlib.h>
 

libsrc/rp6502/read.c

@@ -1,29 +1,18 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 #include <unistd.h>
 
 int __fastcall__ read (int fildes, void* buf, unsigned count)
 {
     int total = 0;
-    while (count)
-    {
+    while (count) {
         unsigned blockcount = (count > 256) ? 256 : count;
         int bytes_read = read_xstack (&((char*)buf)[total], blockcount, fildes);
-        if (bytes_read < 0)
-        {
+        if (bytes_read < 0) {
             return bytes_read;
         }
         total += bytes_read;
         count -= bytes_read;
-        if (bytes_read < blockcount)
-        {
+        if (bytes_read < blockcount) {
             break;
         }
     }

libsrc/rp6502/read_xram.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 
 int __fastcall__ read_xram (unsigned buf, unsigned count, int fildes)

libsrc/rp6502/read_xstack.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 
 int __fastcall__ read_xstack (void* buf, unsigned count, int fildes)
@@ -14,8 +6,7 @@ int __fastcall__ read_xstack(void *buf, unsigned count, int fildes)
     ria_push_int (count);
     ria_set_ax (fildes);
     ax = ria_call_int_errno (RIA_OP_READ_XSTACK);
-    for (i = 0; i < ax; i++)
-    {
+    for (i = 0; i < ax; i++) {
         ((char*)buf)[i] = ria_pop_char ();
     }
     return ax;

libsrc/rp6502/ria.s

@@ -1,8 +1,7 @@
-; Copyright (c) 2023 Rumbledethumps
 ;
-; SPDX-License-Identifier: Zlib
-; SPDX-License-Identifier: BSD-3-Clause
-; SPDX-License-Identifier: Unlicense
+; 2023, Rumbledethumps
+;
+; Helpers for building API shims
 
 .include "rp6502.inc"
 

libsrc/rp6502/settime.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 #include <time.h>
 

libsrc/rp6502/stdin_opt.c

@@ -1,10 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
 
 #include <rp6502.h>
 

libsrc/rp6502/sysremove.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 #include <errno.h>
 #include <string.h>
@@ -14,12 +6,10 @@ unsigned char __fastcall__ _sysremove(const char *name)
 {
     size_t namelen;
     namelen = strlen (name);
-    if (namelen > 255)
-    {
+    if (namelen > 255) {
         return _mappederrno (EINVAL);
     }
-    while (namelen)
-    {
+    while (namelen) {
         ria_push_char (name[--namelen]);
     }
     return ria_call_int_errno (RIA_OP_UNLINK);

libsrc/rp6502/sysrename.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 #include <errno.h>
 #include <string.h>
@@ -15,17 +7,14 @@ unsigned char __fastcall__ _sysrename(const char *oldpath, const char *newpath)
     size_t oldpathlen, newpathlen;
     oldpathlen = strlen (oldpath);
     newpathlen = strlen (newpath);
-    if (oldpathlen + newpathlen > 254)
-    {
+    if (oldpathlen + newpathlen > 254) {
         return _mappederrno (EINVAL);
     }
-    while (oldpathlen)
-    {
+    while (oldpathlen) {
         ria_push_char (oldpath[--oldpathlen]);
     }
     ria_push_char (0);
-    while (newpathlen)
-    {
+    while (newpathlen) {
         ria_push_char (newpath[--newpathlen]);
     }
     return ria_call_int_errno (RIA_OP_RENAME);

libsrc/rp6502/write.c

@@ -1,29 +1,18 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 #include <unistd.h>
 
 int __fastcall__ write (int fildes, const void* buf, unsigned count)
 {
     int ax, total = 0;
-    while (count)
-    {
+    while (count) {
         int blockcount = (count > 256) ? 256 : count;
         ax = write_xstack (&((char*)buf)[total], blockcount, fildes);
-        if (ax < 0)
-        {
+        if (ax < 0) {
             return ax;
         }
         total += ax;
         count -= ax;
-        if (ax < blockcount)
-        {
+        if (ax < blockcount) {
             break;
         }
     }

libsrc/rp6502/write_xram.c

@@ -1,11 +1,3 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 
 int __fastcall__ write_xram (unsigned buf, unsigned count, int fildes)

libsrc/rp6502/write_xstack.c

@@ -1,18 +1,9 @@
-/*
- * Copyright (c) 2023 Rumbledethumps
- *
- * SPDX-License-Identifier: Zlib
- * SPDX-License-Identifier: BSD-3-Clause
- * SPDX-License-Identifier: Unlicense
- */
-
 #include <rp6502.h>
 
 int __fastcall__ write_xstack (const void* buf, unsigned count, int fildes)
 {
     unsigned i;
-    for (i = count; i;)
-    {
+    for (i = count; i;) {
         ria_push_char (((char*)buf)[--i]);
     }
     ria_set_ax (fildes);

libsrc/rp6502/xreg.s

@@ -1,9 +1,6 @@
-; Copyright (c) 2023 Rumbledethumps
 ;
-; SPDX-License-Identifier: Zlib
-; SPDX-License-Identifier: BSD-3-Clause
-; SPDX-License-Identifier: Unlicense
-
+; 2023, Rumbledethumps
+;
 ; CC65 will promote variadic char arguments to int. It will not demote longs.
 ; int __cdecl__ xreg(char device, char channel, unsigned char address, ...);