OSWORD &49
OSWORD &49 (73): Integra-B calls
All calls use a common control block layout:
XY?0 command
XY?1 format flag, returned data length/status
XY?2 format flag
XY?3 format flag
XY!4 data address or count
XY?8 century
XY?9 year
XY?10 month
XY?11 day of month
XY?12 day of week
XY?13 hours
XY?14 minutes
XY?15 seconds
The time and date values are always decimal, in contrast to the OSWORD &0E/&0F
calls which used BCD.
&60: Read RTC time and date as string
-------------------------------------
Does the equivalent of OSWORD &49,&61:OSWORD &49,&62
On entry:
XY?0 &60
XY?1 separators &84 gives "Tue,19 Nov 2022.00:55:42"
XY?2 day format &44 gives "Tue, "
XY?3 date format &EB gives "19 Nov 2022"
XY!4 data address to return string
On exit:
XY?1 length of returned string including CR
XY!4 &00008000
XY?8 century
XY?9 year
XY?10 month
XY?11 day of month
XY?12 day of week
XY?13 hours
XY?14 minutes
XY?15 seconds
The data block holds the returned string, terminated with CR.
&61: Read RTC time and date
---------------------------
On entry:
XY?0 &61
On exit:
XY?0 &00
XY?1 &00
XY?2 &00
XY?3 &00
XY?4 &00
XY?5 &00
XY?6 &00
XY?7 &00
XY?8 century
XY?9 year
XY?10 month
XY?11 day of month
XY?12 day of week
XY?13 hours
XY?14 minutes
XY?15 seconds
&62: Convert RTC time and date to string
----------------------------------------
On entry:
XY?0 &62
XY?1 separators &84 gives "Tue,19 Nov 2022.00:55:42"
XY?2 day format &44 gives "Tue, "
XY?3 date format &EB gives "19 Nov 2022"
XY!4 data address to return string
XY?8 century
XY?9 year
XY?10 month
XY?11 day of month
XY?12 day of week
XY?13 hours
XY?14 minutes
XY?15 seconds
On exit:
XY?1 length of returned string including CR
XY!4 &00008000
XY?8 century
XY?9 year
XY?10 month
XY?11 day of month
XY?12 day of week
XY?13 hours
XY?14 minutes
XY?15 seconds
The data block holds the returned string, terminated with CR.
&63: No operation, control block unchanged
-----------------------------------------
&64: Read Alarm
---------------
On entry:
XY?0=&64
On exit:
XY?0 &00
XY?1 RTC Alarm register b6=0 Off, b6=1 On
XY?2 &00
XY?3 &00
XY?4 &00
XY?5 &00
XY?6 &00
XY?7 &00
XY?8 &00
XY?9 &00
XY?10 &00
XY?11 &00
XY?12 &00
XY?13 alarm hours
XY?14 alarm minutes
XY?15 alarm seconds
&65: Set RTC time
-----------------
On entry:
XY?0 &65
XY?13 hours
XY?14 minutes
XY?15 seconds
&66: Set RTC date
-----------------
XY?0 &66
XY?8 century
XY?9 year
XY?10 month
XY?11 day of month
The day of the week is calculated from the date
&67: Set RTC Alarm
------------------
XY?0 &67
XY?1 Alarm enable b6=0 Off, b6=1 On
XY?13 alarm hours
XY?14 alarm minutes
XY?15 alarm seconds
&68: Validate date
------------------
On entry:
XY?0 &68
XY?8 &FF or century
XY?9 &FF or year
XY?10 &FF or month
XY?11 &FF or day of month
XY?12 &FF or day of week
On exit:
Any &FFs are replaced with the earliest date that would match.
If the year is &FF, it is replaced with this year.
&69: Generate calendar
----------------------
On entry:
XY?0 &69
XY!4 data address to return string
XY?8 century
XY?9 year
XY?10 month
XY?11 day of month
On exit:
XY?1 number of bytes returned
At the data address will be the calendar data. &00 indicates blanks in
the calendar, <>&00 is a number to display. The data is seven blocks of
six bytes, ordered 6 x {Sun}, 6 x {Mon}, etc.
&6A: Convert date to absolute day number
----------------------------------------
On entry:
XY?0 &6A
XY?8 century
XY?9 year
XY?10 month
XY?11 day of month
On exit:
XY?0 &00=Ok, &FF=invalid date
XY!4 count of number of days where 01-Jan-1900 = &0000
&6B: Convert absolute day number to date
----------------------------------------
On entry:
XY?0 &6A
XY!4 count of number of days where 01-Jan-1900 = &0000
On exit:
XY?8 century
XY?9 year
XY?10 month
XY?11 day of month
XY?12 day of week
All other calls are ignored and passed on to other ROMs. IBOS up
to version 1.20 have a bug in that subcalls &6C-&6F are claimed,
but there is no dispatch address, so they crash.
See Also
- OSWORD &49 - Integra-B shadow memory calls
- OSBYTE &49 - Check for Integra-B shadow memory
- http://mdfs.net/Docs/Comp/BBC/Oswords
Jgharston 13:37, 26 May 2009 (UTC) Jgharston (talk) 20:46, 29 November 2022 (CET)
