Difference between revisions of "API"

From SpecNext official Wiki
Jump to: navigation, search
m
 
(4 intermediate revisions by the same user not shown)
Line 5: Line 5:
 
The esxDOS API is compatible with [https://www.esxdos.org/ esxDOS] 0.8.x, but contains several enhancements.
 
The esxDOS API is compatible with [https://www.esxdos.org/ esxDOS] 0.8.x, but contains several enhancements.
  
The latest reference documentation for the APIs is on the distro and Next SD card at <tt>c:/docs/NextZXOS</tt>, and [https://gitlab.com/thesmog358/tbblue/-/raw/master/docs/nextzxos/NextZXOS_and_esxDOS_APIs.pdf?ref_type=heads online at gitlab].
+
The canonical reference documentation for the APIs is on the distro and Next SD card at <tt>c:/docs/NextZXOS/NextZXOS_and_esxDOS_APIs.pdf</tt>, and [https://gitlab.com/thesmog358/tbblue/-/raw/master/docs/nextzxos/NextZXOS_and_esxDOS_APIs.pdf?ref_type=heads online at gitlab].  
  
The APIs are published and kept up to date for each new [[NextZXOS]] and [[NextBASIC]] release, and in Next-specific program, all ROM calls should be made through the APIs. Other code inside the ROM is not documented, and may (and does) move around between releases.
+
The APIs are published and kept up to date for each new [[NextZXOS]] and [[NextBASIC]] release. In Next-specific programs, all ROM calls should be made through the APIs, so that your code continues to work in future versions. Other code inside the ROM is not documented, and may (and does) move around between releases.
 +
 
 +
As well as the API calls, the document also discusses writing dot commands and drivers in detail, and the use of <tt>rst $18</tt> to call any routine in the standard [https://skoolkid.github.io/rom/maps/all.html 48K BASIC ROM].

Latest revision as of 17:11, 8 March 2024

NextZXOS has two APIs which can be used to make ROM calls.

The NextZXOS API directly descends from the +3DOS API present in the Sinclair ZX Spectrum +2A/+2B/+3, and the IDEDOS API additionally provided with the ZX Spectrum +3e ROMs.

The esxDOS API is compatible with esxDOS 0.8.x, but contains several enhancements.

The canonical reference documentation for the APIs is on the distro and Next SD card at c:/docs/NextZXOS/NextZXOS_and_esxDOS_APIs.pdf, and online at gitlab.

The APIs are published and kept up to date for each new NextZXOS and NextBASIC release. In Next-specific programs, all ROM calls should be made through the APIs, so that your code continues to work in future versions. Other code inside the ROM is not documented, and may (and does) move around between releases.

As well as the API calls, the document also discusses writing dot commands and drivers in detail, and the use of rst $18 to call any routine in the standard 48K BASIC ROM.