msxdsk/msxdsk.h at main · algodesigner/msxdsk · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
/*
 * Copyright (c) 2026, Vlad Shurupov
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 * 1. Redistributions of source code must retain the above copyright notice,
 *    this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright notice,
 *    this list of conditions and the following disclaimer in the documentation
 *    and/or other materials provided with the distribution.
 *
 * 3. Neither the name of the copyright holder nor the names of its
 *    contributors may be used to endorse or promote products derived from
 *    this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef MSXDISK_H
#define MSXDISK_H

#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>

#define MSX_SECTOR_SIZE 512
#define MSX_DIR_ENTRIES 112
#define MSX_MAX_FILENAME 8
#define MSX_MAX_EXTENSION 3
#define MSX_FAT_ENTRIES 2070
#define MSX_TRACK_SIZE 16
#define MSX_SECTORS_PER_TRACK 16
#define MSX_NUM_HEADS 2

#define FAT12_FREE 0x000
#define FAT12_BAD 0xFF7
#define FAT12_EOF_MIN 0xFF8
#define FAT12_EOF 0xFFF

typedef struct {
    uint8_t track;
    uint8_t sector;
} MsxSectorLink;

typedef struct {
    char name[8];
    char ext[3];
    uint8_t attributes;
    uint8_t reserved[10];
    uint16_t time;
    uint16_t date;
    uint16_t start_cluster;
    uint32_t size;
} __attribute__((packed)) MsxDirEntry;

typedef struct {
    FILE *fp;
    char *filename;
    uint8_t *sector_cache;
    uint32_t sector_count;
    uint32_t fat_start;
    uint32_t fat_sectors;
    uint32_t dir_start;
    uint32_t dir_sectors;
    uint32_t data_start;
    uint16_t sectors_per_cluster;
    uint8_t dirty;
} MsxDisk;

typedef struct {
    char name[MSX_MAX_FILENAME + 1];
    char ext[MSX_MAX_EXTENSION + 1];
    uint32_t size;
    uint16_t start_cluster;
    uint8_t attributes;
} MsxFile;

int msx_disk_open(MsxDisk *disk, const char *filename, int writable);
void msx_disk_close(MsxDisk *disk);
int msx_disk_read_sector(MsxDisk *disk, uint32_t sector, uint8_t *buffer);
int msx_disk_write_sector(
        MsxDisk *disk, uint32_t sector, const uint8_t *buffer);
int msx_disk_flush(MsxDisk *disk);
int msx_disk_get_info(
        MsxDisk *disk, uint32_t *total_sectors, uint32_t *free_sectors);
int msx_disk_list_files(MsxDisk *disk, MsxFile **files, int *count);
int msx_disk_extract_file(
        MsxDisk *disk, const char *filename, const char *output_path);
int msx_disk_add_file(MsxDisk *disk, const char *host_path,
        const char *msx_name, const char *msx_ext);
int msx_disk_delete_file(MsxDisk *disk, const char *filename);
int msx_disk_create(const char *filename, const char *label);

#endif