Remove this copy of the apple include file - a copy was added to asminc

[cc65] / include / dio.h

diff --git a/include/dio.h b/include/dio.h
index 284eb0addf677766a9cc38a43ab0c7e02c9506eb..5303c949abb0c7dc28e3faf3d91d0242d3642418 100644 (file)
--- a/include/dio.h
+++ b/include/dio.h
@@ -1,12 +1,12 @@
 /*****************************************************************************/
 /*                                                                           */
-/*                                  dio.h                                   */
+/*                                   dio.h                                   */
 /*                                                                           */
-/*                      Low-Level diskette I/O functions                    */
+/*                       Low-Level diskette I/O functions                    */
 /*                                                                           */
 /*                                                                           */
 /*                                                                           */
-/* (C) 2000 Christian Groessler <cpg@aladdin.de>                             */
+/* (C) 2005 Christian Groessler <cpg@aladdin.de>                             */
 /*                                                                           */
 /*                                                                           */
 /* This software is provided 'as-is', without any expressed or implied       */
@@ -28,32 +28,90 @@
 /*                                                                           */
 /*****************************************************************************/
 
+
+
 #ifndef _DIO_H
 #define _DIO_H
 
-typedef unsigned char _driveid_t;
-typedef unsigned int  _sectnum_t;
 
 
-#ifdef __ATARI__
-#define _dio_query_sectsize(x) ((unsigned int)128)
-#else
-#define _dio_query_sectsize(x) ((unsigned int)256)
-#endif
+/* Please note: All functions in this file will set _oserror *and* return its
+ * value. The only exception is dio_open, which will return NULL, but _oserror
+ * will be set. All function will also set _oserror in case of successful
+ * execution, effectively clearing it.
+ */
+
+
+
+/*****************************************************************************/
+/*                                   Data                                   */
+/*****************************************************************************/
+
+
+
+typedef unsigned char       driveid_t;
+typedef unsigned int        sectnum_t;
+typedef unsigned int        sectsize_t;
+typedef struct __dhandle_t *dhandle_t;
+
+typedef struct {
+  unsigned char  head;
+  unsigned       track;
+  unsigned       sector;
+} dio_phys_pos;
+
+
+
+/*****************************************************************************/
+/*                                   Code                                   */
+/*****************************************************************************/
+
+
+
+sectsize_t __fastcall__ dio_query_sectsize(dhandle_t handle);
+/* queries sector size, currently hardcoded */
+
+sectnum_t __fastcall__ dio_query_sectcount(dhandle_t handle);
+/* Return the sector count for a disk. */
+
+dhandle_t __fastcall__ dio_open(driveid_t drive_id);
+/* open drive for subsequent dio access */
+
+unsigned char __fastcall__ dio_close(dhandle_t handle);
+/* close drive, returns oserror (0 for success) */
+
+unsigned char __fastcall__ dio_read(dhandle_t handle,
+                                    sectnum_t sect_num,
+                                    void *buffer);
+/* read sector <sect_num> from drive <handle> to memory at <buffer> */
+/* the number of bytes transferred depends on the sector size */
+/* returns oserror (0 for success) */
+
+unsigned char __fastcall__ dio_write(dhandle_t handle,
+                                     sectnum_t sect_num,
+                                     const void *buffer);
+/* write memory at <buffer> to sector <sect_num> on drive <handle>, no verify */
+/* the number of bytes transferred depends on the sector size */
+/* returns oserror (0 for success) */
 
-extern unsigned char __fastcall__ _dio_setup       (_driveid_t drive_id);
-extern unsigned char __fastcall__ _dio_finish      (_driveid_t drive_id);
+unsigned char __fastcall__ dio_write_verify(dhandle_t handle,
+                                            sectnum_t sect_num,
+                                            const void *buffer);
+/* write memory at <buffer> to sector <sect_num> on drive <handle>, verify after write */
+/* the number of bytes transferred depends on the sector size */
+/* returns oserror (0 for success) */
 
-extern unsigned char __fastcall__ _dio_format      (_driveid_t drive_id, unsigned int format);
-extern unsigned char __fastcall__ _dio_read        (_driveid_t drive_id, _sectnum_t sect_num, void *buffer);
-extern unsigned char __fastcall__ _dio_write       (_driveid_t drive_id, _sectnum_t sect_num, void *buffer);
-extern unsigned char __fastcall__ _dio_write_verify(_driveid_t drive_id, _sectnum_t sect_num, void *buffer);
 
+unsigned char __fastcall__ dio_phys_to_log(dhandle_t handle,
+                                           const dio_phys_pos *physpos, /* input */
+                                           sectnum_t *sectnum);         /* output */
+/* convert physical sector address (head/track/sector) to logical sector number */
+/* returns oserror (0 for success) */
 
-extern _sectnum_t __fastcall__ _dio_chs_to_snum(unsigned int cyl, unsigned int head, unsigned int sector);
-extern void       __fastcall__ _dio_snum_to_chs(_sectnum_t sect_num,
-                                                unsigned int *cyl,
-                                                unsigned int *head,
-                                                unsigned int *sector);
+unsigned char __fastcall__ dio_log_to_phys(dhandle_t handle,
+                                           const sectnum_t *sectnum, /* input */
+                                           dio_phys_pos *physpos);   /* output */
+/* convert logical sector number to physical sector address (head/track/sector) */
+/* returns oserror (0 for success) */
 
 #endif /* #ifndef _DIO_H */