v86 0.4.0 → 0.5.11

package/bios/seabios/src/hw/pvscsi.c

@@ -1,333 +0,0 @@
-// QEMU VMWARE Paravirtualized SCSI boot support.
-//
-// Copyright (c) 2013 Ravello Systems LTD (http://ravellosystems.com)
-//
-// Authors:
-//  Evgeny Budilovsky <evgeny.budilovsky@ravellosystems.com>
-//
-// This file may be distributed under the terms of the GNU LGPLv3 license.
-
-#include "block.h" // struct drive_s
-#include "blockcmd.h" // scsi_drive_setup
-#include "config.h" // CONFIG_*
-#include "malloc.h" // free
-#include "memmap.h" // PAGE_SHIFT, virt_to_phys
-#include "output.h" // dprintf
-#include "pcidevice.h" // foreachpci
-#include "pci_ids.h" // PCI_DEVICE_ID_VMWARE_PVSCSI
-#include "pci_regs.h" // PCI_VENDOR_ID
-#include "pvscsi.h" // pvscsi_setup
-#include "stacks.h" // run_thread
-#include "std/disk.h" // DISK_RET_SUCCESS
-#include "string.h" // memset
-#include "util.h" // usleep
-#include "x86.h" // writel
-
-#define MASK(n) ((1 << (n)) - 1)
-
-#define SIMPLE_QUEUE_TAG 0x20
-
-#define PVSCSI_INTR_CMPL_0                 (1 << 0)
-#define PVSCSI_INTR_CMPL_1                 (1 << 1)
-#define PVSCSI_INTR_CMPL_MASK              MASK(2)
-
-#define PVSCSI_INTR_MSG_0                  (1 << 2)
-#define PVSCSI_INTR_MSG_1                  (1 << 3)
-#define PVSCSI_INTR_MSG_MASK               (MASK(2) << 2)
-#define PVSCSI_INTR_ALL_SUPPORTED          MASK(4)
-
-#define PVSCSI_FLAG_CMD_WITH_SG_LIST       (1 << 0)
-#define PVSCSI_FLAG_CMD_OUT_OF_BAND_CDB    (1 << 1)
-#define PVSCSI_FLAG_CMD_DIR_NONE           (1 << 2)
-#define PVSCSI_FLAG_CMD_DIR_TOHOST         (1 << 3)
-#define PVSCSI_FLAG_CMD_DIR_TODEVICE       (1 << 4)
-
-enum PVSCSIRegOffset {
-    PVSCSI_REG_OFFSET_COMMAND        =    0x0,
-    PVSCSI_REG_OFFSET_COMMAND_DATA   =    0x4,
-    PVSCSI_REG_OFFSET_COMMAND_STATUS =    0x8,
-    PVSCSI_REG_OFFSET_LAST_STS_0     =  0x100,
-    PVSCSI_REG_OFFSET_LAST_STS_1     =  0x104,
-    PVSCSI_REG_OFFSET_LAST_STS_2     =  0x108,
-    PVSCSI_REG_OFFSET_LAST_STS_3     =  0x10c,
-    PVSCSI_REG_OFFSET_INTR_STATUS    = 0x100c,
-    PVSCSI_REG_OFFSET_INTR_MASK      = 0x2010,
-    PVSCSI_REG_OFFSET_KICK_NON_RW_IO = 0x3014,
-    PVSCSI_REG_OFFSET_DEBUG          = 0x3018,
-    PVSCSI_REG_OFFSET_KICK_RW_IO     = 0x4018,
-};
-
-enum PVSCSICommands {
-    PVSCSI_CMD_FIRST             = 0,
-    PVSCSI_CMD_ADAPTER_RESET     = 1,
-    PVSCSI_CMD_ISSUE_SCSI        = 2,
-    PVSCSI_CMD_SETUP_RINGS       = 3,
-    PVSCSI_CMD_RESET_BUS         = 4,
-    PVSCSI_CMD_RESET_DEVICE      = 5,
-    PVSCSI_CMD_ABORT_CMD         = 6,
-    PVSCSI_CMD_CONFIG            = 7,
-    PVSCSI_CMD_SETUP_MSG_RING    = 8,
-    PVSCSI_CMD_DEVICE_UNPLUG     = 9,
-    PVSCSI_CMD_LAST              = 10
-};
-
-#define PVSCSI_SETUP_RINGS_MAX_NUM_PAGES        32
-struct PVSCSICmdDescSetupRings {
-    u32    reqRingNumPages;
-    u32    cmpRingNumPages;
-    u64    ringsStatePPN;
-    u64    reqRingPPNs[PVSCSI_SETUP_RINGS_MAX_NUM_PAGES];
-    u64    cmpRingPPNs[PVSCSI_SETUP_RINGS_MAX_NUM_PAGES];
-} PACKED;
-
-struct PVSCSIRingCmpDesc {
-    u64    context;
-    u64    dataLen;
-    u32    senseLen;
-    u16    hostStatus;
-    u16    scsiStatus;
-    u32    pad[2];
-} PACKED;
-
-struct PVSCSIRingsState {
-    u32    reqProdIdx;
-    u32    reqConsIdx;
-    u32    reqNumEntriesLog2;
-
-    u32    cmpProdIdx;
-    u32    cmpConsIdx;
-    u32    cmpNumEntriesLog2;
-
-    u8     pad[104];
-
-    u32    msgProdIdx;
-    u32    msgConsIdx;
-    u32    msgNumEntriesLog2;
-} PACKED;
-
-struct PVSCSIRingReqDesc {
-    u64    context;
-    u64    dataAddr;
-    u64    dataLen;
-    u64    senseAddr;
-    u32    senseLen;
-    u32    flags;
-    u8     cdb[16];
-    u8     cdbLen;
-    u8     lun[8];
-    u8     tag;
-    u8     bus;
-    u8     target;
-    u8     vcpuHint;
-    u8     unused[59];
-} PACKED;
-
-struct pvscsi_ring_dsc_s {
-    struct PVSCSIRingsState *ring_state;
-    struct PVSCSIRingReqDesc *ring_reqs;
-    struct PVSCSIRingCmpDesc *ring_cmps;
-};
-
-struct pvscsi_lun_s {
-    struct drive_s drive;
-    void *iobase;
-    u8 target;
-    u8 lun;
-    struct pvscsi_ring_dsc_s *ring_dsc;
-};
-
-static void
-pvscsi_write_cmd_desc(void *iobase, u32 cmd, const void *desc, size_t len)
-{
-    const u32 *ptr = desc;
-    size_t i;
-
-    len /= sizeof(*ptr);
-    writel(iobase + PVSCSI_REG_OFFSET_COMMAND, cmd);
-    for (i = 0; i < len; i++)
-        writel(iobase + PVSCSI_REG_OFFSET_COMMAND_DATA, ptr[i]);
-}
-
-static void
-pvscsi_kick_rw_io(void *iobase)
-{
-    writel(iobase + PVSCSI_REG_OFFSET_KICK_RW_IO, 0);
-}
-
-static void
-pvscsi_wait_intr_cmpl(void *iobase)
-{
-    while (!(readl(iobase + PVSCSI_REG_OFFSET_INTR_STATUS) & PVSCSI_INTR_CMPL_MASK))
-        usleep(5);
-    writel(iobase + PVSCSI_REG_OFFSET_INTR_STATUS, PVSCSI_INTR_CMPL_MASK);
-}
-
-static void
-pvscsi_init_rings(void *iobase, struct pvscsi_ring_dsc_s **ring_dsc)
-{
-    struct PVSCSICmdDescSetupRings cmd = {0,};
-
-    struct pvscsi_ring_dsc_s *dsc = memalign_high(PAGE_SIZE, sizeof(*dsc));
-    if (!dsc) {
-        warn_noalloc();
-        return;
-    }
-
-    dsc->ring_state =
-        (struct PVSCSIRingsState *)memalign_high(PAGE_SIZE, PAGE_SIZE);
-    dsc->ring_reqs =
-        (struct PVSCSIRingReqDesc *)memalign_high(PAGE_SIZE, PAGE_SIZE);
-    dsc->ring_cmps =
-        (struct PVSCSIRingCmpDesc *)memalign_high(PAGE_SIZE, PAGE_SIZE);
-    if (!dsc->ring_state || !dsc->ring_reqs || !dsc->ring_cmps) {
-        warn_noalloc();
-        return;
-    }
-    memset(dsc->ring_state, 0, PAGE_SIZE);
-    memset(dsc->ring_reqs, 0, PAGE_SIZE);
-    memset(dsc->ring_cmps, 0, PAGE_SIZE);
-
-    cmd.reqRingNumPages = 1;
-    cmd.cmpRingNumPages = 1;
-    cmd.ringsStatePPN = virt_to_phys(dsc->ring_state) >> PAGE_SHIFT;
-    cmd.reqRingPPNs[0] = virt_to_phys(dsc->ring_reqs) >> PAGE_SHIFT;
-    cmd.cmpRingPPNs[0] = virt_to_phys(dsc->ring_cmps) >> PAGE_SHIFT;
-
-    pvscsi_write_cmd_desc(iobase, PVSCSI_CMD_SETUP_RINGS,
-                          &cmd, sizeof(cmd));
-    *ring_dsc = dsc;
-}
-
-static u32
-pvscsi_get_rsp(struct PVSCSIRingsState *s,
-               struct PVSCSIRingCmpDesc *rsp)
-{
-    u32 status = rsp->hostStatus;
-    s->cmpConsIdx = s->cmpConsIdx + 1;
-    return status;
-}
-
-int
-pvscsi_process_op(struct disk_op_s *op)
-{
-    if (!CONFIG_PVSCSI)
-        return DISK_RET_EBADTRACK;
-    struct pvscsi_lun_s *plun =
-        container_of(op->drive_fl, struct pvscsi_lun_s, drive);
-    struct pvscsi_ring_dsc_s *ring_dsc = plun->ring_dsc;
-    struct PVSCSIRingsState *s = ring_dsc->ring_state;
-    u32 req_entries = s->reqNumEntriesLog2;
-    u32 cmp_entries = s->cmpNumEntriesLog2;
-    struct PVSCSIRingReqDesc *req;
-    struct PVSCSIRingCmpDesc *rsp;
-    u32 status;
-
-    if (s->reqProdIdx - s->cmpConsIdx >= 1 << req_entries) {
-        dprintf(1, "pvscsi: ring full: reqProdIdx=%d cmpConsIdx=%d\n",
-                s->reqProdIdx, s->cmpConsIdx);
-        return DISK_RET_EBADTRACK;
-    }
-
-    req = ring_dsc->ring_reqs + (s->reqProdIdx & MASK(req_entries));
-    int blocksize = scsi_fill_cmd(op, req->cdb, 16);
-    if (blocksize < 0)
-        return default_process_op(op);
-    req->bus = 0;
-    req->target = plun->target;
-    memset(req->lun, 0, sizeof(req->lun));
-    req->lun[1] = plun->lun;
-    req->senseLen = 0;
-    req->senseAddr = 0;
-    req->cdbLen = 16;
-    req->vcpuHint = 0;
-    req->tag = SIMPLE_QUEUE_TAG;
-    req->flags = scsi_is_read(op) ?
-        PVSCSI_FLAG_CMD_DIR_TOHOST : PVSCSI_FLAG_CMD_DIR_TODEVICE;
-    req->dataLen = op->count * blocksize;
-    req->dataAddr = (u32)op->buf_fl;
-    s->reqProdIdx = s->reqProdIdx + 1;
-
-    pvscsi_kick_rw_io(plun->iobase);
-    pvscsi_wait_intr_cmpl(plun->iobase);
-
-    rsp = ring_dsc->ring_cmps + (s->cmpConsIdx & MASK(cmp_entries));
-    status = pvscsi_get_rsp(s, rsp);
-
-    return status == 0 ? DISK_RET_SUCCESS : DISK_RET_EBADTRACK;
-}
-
-static int
-pvscsi_add_lun(struct pci_device *pci, void *iobase,
-               struct pvscsi_ring_dsc_s *ring_dsc, u8 target, u8 lun)
-{
-    struct pvscsi_lun_s *plun = malloc_fseg(sizeof(*plun));
-    if (!plun) {
-        warn_noalloc();
-        return -1;
-    }
-    memset(plun, 0, sizeof(*plun));
-    plun->drive.type = DTYPE_PVSCSI;
-    plun->drive.cntl_id = pci->bdf;
-    plun->target = target;
-    plun->lun = lun;
-    plun->iobase = iobase;
-    plun->ring_dsc = ring_dsc;
-
-    char *name = znprintf(MAXDESCSIZE, "pvscsi %pP %d:%d", pci, target, lun);
-    int prio = bootprio_find_scsi_device(pci, target, lun);
-    int ret = scsi_drive_setup(&plun->drive, name, prio);
-    free(name);
-    if (ret)
-        goto fail;
-    return 0;
-
-fail:
-    free(plun);
-    return -1;
-}
-
-static void
-pvscsi_scan_target(struct pci_device *pci, void *iobase,
-                   struct pvscsi_ring_dsc_s *ring_dsc, u8 target)
-{
-    /* pvscsi has no more than a single lun per target */
-    pvscsi_add_lun(pci, iobase, ring_dsc, target, 0);
-}
-
-static void
-init_pvscsi(void *data)
-{
-    struct pci_device *pci = data;
-    void *iobase = pci_enable_membar(pci, PCI_BASE_ADDRESS_0);
-    if (!iobase)
-        return;
-    pci_enable_busmaster(pci);
-
-    dprintf(1, "found pvscsi at %pP, io @ %p\n", pci, iobase);
-
-    pvscsi_write_cmd_desc(iobase, PVSCSI_CMD_ADAPTER_RESET, NULL, 0);
-
-    struct pvscsi_ring_dsc_s *ring_dsc = NULL;
-    pvscsi_init_rings(iobase, &ring_dsc);
-    int i;
-    for (i = 0; i < 64; i++)
-        pvscsi_scan_target(pci, iobase, ring_dsc, i);
-}
-
-void
-pvscsi_setup(void)
-{
-    ASSERT32FLAT();
-    if (! CONFIG_PVSCSI)
-        return;
-
-    dprintf(3, "init pvscsi\n");
-
-    struct pci_device *pci;
-    foreachpci(pci) {
-        if (pci->vendor != PCI_VENDOR_ID_VMWARE
-            || pci->device != PCI_DEVICE_ID_VMWARE_PVSCSI)
-            continue;
-        run_thread(init_pvscsi, pci);
-    }
-}

package/bios/seabios/src/hw/pvscsi.h

@@ -1,8 +0,0 @@
-#ifndef _PVSCSI_H_
-#define _PVSCSI_H_
-
-struct disk_op_s;
-int pvscsi_process_op(struct disk_op_s *op);
-void pvscsi_setup(void);
-
-#endif /* _PVSCSI_H_ */

package/bios/seabios/src/hw/ramdisk.c

@@ -1,108 +0,0 @@
-// Code for emulating a drive via high-memory accesses.
-//
-// Copyright (C) 2009  Kevin O'Connor <kevin@koconnor.net>
-//
-// This file may be distributed under the terms of the GNU LGPLv3 license.
-
-#include "biosvar.h" // GET_GLOBALFLAT
-#include "block.h" // struct drive_s
-#include "bregs.h" // struct bregs
-#include "e820map.h" // e820_add
-#include "malloc.h" // memalign_tmphigh
-#include "memmap.h" // PAGE_SIZE
-#include "output.h" // dprintf
-#include "romfile.h" // romfile_findprefix
-#include "stacks.h" // call16_int
-#include "std/disk.h" // DISK_RET_SUCCESS
-#include "string.h" // memset
-#include "util.h" // process_ramdisk_op
-
-void
-ramdisk_setup(void)
-{
-    if (!CONFIG_FLASH_FLOPPY)
-        return;
-
-    // Find image.
-    struct romfile_s *file = romfile_findprefix("floppyimg/", NULL);
-    if (!file)
-        return;
-    const char *filename = file->name;
-    u32 size = file->size;
-    dprintf(3, "Found floppy file %s of size %d\n", filename, size);
-    int ftype = find_floppy_type(size);
-    if (ftype < 0) {
-        dprintf(3, "No floppy type found for ramdisk size\n");
-        return;
-    }
-
-    // Allocate ram for image.
-    void *pos = memalign_tmphigh(PAGE_SIZE, size);
-    if (!pos) {
-        warn_noalloc();
-        return;
-    }
-    e820_add((u32)pos, size, E820_RESERVED);
-
-    // Copy image into ram.
-    int ret = file->copy(file, pos, size);
-    if (ret < 0)
-        return;
-
-    // Setup driver.
-    struct drive_s *drive = init_floppy((u32)pos, ftype);
-    if (!drive)
-        return;
-    drive->type = DTYPE_RAMDISK;
-    dprintf(1, "Mapping floppy %s to addr %p\n", filename, pos);
-    char *desc = znprintf(MAXDESCSIZE, "Ramdisk [%s]", &filename[10]);
-    boot_add_floppy(drive, desc, bootprio_find_named_rom(filename, 0));
-}
-
-static int
-ramdisk_copy(struct disk_op_s *op, int iswrite)
-{
-    u32 offset = GET_GLOBALFLAT(op->drive_fl->cntl_id);
-    offset += (u32)op->lba * DISK_SECTOR_SIZE;
-    u64 opd = GDT_DATA | GDT_LIMIT(0xfffff) | GDT_BASE((u32)op->buf_fl);
-    u64 ramd = GDT_DATA | GDT_LIMIT(0xfffff) | GDT_BASE(offset);
-
-    u64 gdt[6];
-    if (iswrite) {
-        gdt[2] = opd;
-        gdt[3] = ramd;
-    } else {
-        gdt[2] = ramd;
-        gdt[3] = opd;
-    }
-
-    // Call int 1587 to copy data.
-    struct bregs br;
-    memset(&br, 0, sizeof(br));
-    br.flags = F_CF|F_IF;
-    br.ah = 0x87;
-    br.es = GET_SEG(SS);
-    br.si = (u32)gdt;
-    br.cx = op->count * DISK_SECTOR_SIZE / 2;
-    call16_int(0x15, &br);
-
-    if (br.flags & F_CF)
-        return DISK_RET_EBADTRACK;
-    return DISK_RET_SUCCESS;
-}
-
-int
-ramdisk_process_op(struct disk_op_s *op)
-{
-    if (!CONFIG_FLASH_FLOPPY)
-        return 0;
-
-    switch (op->command) {
-    case CMD_READ:
-        return ramdisk_copy(op, 0);
-    case CMD_WRITE:
-        return ramdisk_copy(op, 1);
-    default:
-        return default_process_op(op);
-    }
-}

package/bios/seabios/src/hw/rtc.c

@@ -1,100 +0,0 @@
-// Support for MC146818 Real Time Clock chip.
-//
-// Copyright (C) 2008-2013  Kevin O'Connor <kevin@koconnor.net>
-// Copyright (C) 2002  MandrakeSoft S.A.
-//
-// This file may be distributed under the terms of the GNU LGPLv3 license.
-
-#include "biosvar.h" // GET_LOW
-#include "rtc.h" // rtc_read
-#include "stacks.h" // yield
-#include "util.h" // timer_calc
-#include "x86.h" // inb
-
-u8
-rtc_read(u8 index)
-{
-    index |= NMI_DISABLE_BIT;
-    outb(index, PORT_CMOS_INDEX);
-    return inb(PORT_CMOS_DATA);
-}
-
-void
-rtc_write(u8 index, u8 val)
-{
-    index |= NMI_DISABLE_BIT;
-    outb(index, PORT_CMOS_INDEX);
-    outb(val, PORT_CMOS_DATA);
-}
-
-void
-rtc_mask(u8 index, u8 off, u8 on)
-{
-    index |= NMI_DISABLE_BIT;
-    outb(index, PORT_CMOS_INDEX);
-    u8 val = inb(PORT_CMOS_DATA);
-    outb((val & ~off) | on, PORT_CMOS_DATA);
-}
-
-int
-rtc_updating(void)
-{
-    // This function checks to see if the update-in-progress bit
-    // is set in CMOS Status Register A.  If not, it returns 0.
-    // If it is set, it tries to wait until there is a transition
-    // to 0, and will return 0 if such a transition occurs.  A -1
-    // is returned only after timing out.  The maximum period
-    // that this bit should be set is constrained to (1984+244)
-    // useconds, but we wait for longer just to be sure.
-
-    if ((rtc_read(CMOS_STATUS_A) & RTC_A_UIP) == 0)
-        return 0;
-    u32 end = timer_calc(15);
-    for (;;) {
-        if ((rtc_read(CMOS_STATUS_A) & RTC_A_UIP) == 0)
-            return 0;
-        if (timer_check(end))
-            // update-in-progress never transitioned to 0
-            return -1;
-        yield();
-    }
-}
-
-void
-rtc_setup(void)
-{
-    if (!CONFIG_RTC_TIMER)
-        return;
-    rtc_write(CMOS_STATUS_A, 0x26);    // 32,768Khz src, 976.5625us updates
-    rtc_mask(CMOS_STATUS_B, ~RTC_B_DSE, RTC_B_24HR);
-    rtc_read(CMOS_STATUS_C);
-    rtc_read(CMOS_STATUS_D);
-}
-
-int RTCusers VARLOW;
-
-void
-rtc_use(void)
-{
-    if (!CONFIG_RTC_TIMER)
-        return;
-    int count = GET_LOW(RTCusers);
-    SET_LOW(RTCusers, count+1);
-    if (count)
-        return;
-    // Turn on the Periodic Interrupt timer
-    rtc_mask(CMOS_STATUS_B, 0, RTC_B_PIE);
-}
-
-void
-rtc_release(void)
-{
-    if (!CONFIG_RTC_TIMER)
-        return;
-    int count = GET_LOW(RTCusers);
-    SET_LOW(RTCusers, count-1);
-    if (count != 1)
-        return;
-    // Clear the Periodic Interrupt.
-    rtc_mask(CMOS_STATUS_B, RTC_B_PIE, 0);
-}

package/bios/seabios/src/hw/rtc.h

@@ -1,75 +0,0 @@
-#ifndef __RTC_H
-#define __RTC_H
-
-#define PORT_CMOS_INDEX        0x0070
-#define PORT_CMOS_DATA         0x0071
-
-// PORT_CMOS_INDEX nmi disable bit
-#define NMI_DISABLE_BIT 0x80
-
-// Standard BIOS RTC chip entries
-#define CMOS_RTC_SECONDS         0x00
-#define CMOS_RTC_SECONDS_ALARM   0x01
-#define CMOS_RTC_MINUTES         0x02
-#define CMOS_RTC_MINUTES_ALARM   0x03
-#define CMOS_RTC_HOURS           0x04
-#define CMOS_RTC_HOURS_ALARM     0x05
-#define CMOS_RTC_DAY_WEEK        0x06
-#define CMOS_RTC_DAY_MONTH       0x07
-#define CMOS_RTC_MONTH           0x08
-#define CMOS_RTC_YEAR            0x09
-#define CMOS_STATUS_A            0x0a
-#define CMOS_STATUS_B            0x0b
-#define CMOS_STATUS_C            0x0c
-#define CMOS_STATUS_D            0x0d
-#define CMOS_RESET_CODE          0x0f
-
-// QEMU cmos config fields.  DO NOT ADD MORE.  (All new content should
-// be passed via the fw_cfg "file" interface.)
-#define CMOS_FLOPPY_DRIVE_TYPE   0x10
-#define CMOS_DISK_DATA           0x12
-#define CMOS_EQUIPMENT_INFO      0x14
-#define CMOS_DISK_DRIVE1_TYPE    0x19
-#define CMOS_DISK_DRIVE2_TYPE    0x1a
-#define CMOS_DISK_DRIVE1_CYL     0x1b
-#define CMOS_DISK_DRIVE2_CYL     0x24
-#define CMOS_MEM_EXTMEM_LOW      0x30
-#define CMOS_MEM_EXTMEM_HIGH     0x31
-#define CMOS_CENTURY             0x32
-#define CMOS_MEM_EXTMEM2_LOW     0x34
-#define CMOS_MEM_EXTMEM2_HIGH    0x35
-#define CMOS_BIOS_BOOTFLAG1      0x38
-#define CMOS_BIOS_DISKTRANSFLAG  0x39
-#define CMOS_BIOS_BOOTFLAG2      0x3d
-#define CMOS_MEM_HIGHMEM_LOW     0x5b
-#define CMOS_MEM_HIGHMEM_MID     0x5c
-#define CMOS_MEM_HIGHMEM_HIGH    0x5d
-#define CMOS_BIOS_SMP_COUNT      0x5f
-
-// RTC register flags
-#define RTC_A_UIP 0x80
-
-#define RTC_B_SET  0x80
-#define RTC_B_PIE  0x40
-#define RTC_B_AIE  0x20
-#define RTC_B_UIE  0x10
-#define RTC_B_BIN  0x04
-#define RTC_B_24HR 0x02
-#define RTC_B_DSE  0x01
-
-#ifndef __ASSEMBLY__
-
-#include "types.h" // u8
-
-// rtc.c
-u8 rtc_read(u8 index);
-void rtc_write(u8 index, u8 val);
-void rtc_mask(u8 index, u8 off, u8 on);
-int rtc_updating(void);
-void rtc_setup(void);
-void rtc_use(void);
-void rtc_release(void);
-
-#endif // !__ASSEMBLY__
-
-#endif // rtc.h