initial commit

atari800/src/cassette.h

@@ -0,0 +1,95 @@
+#ifndef CASSETTE_H_
+#define CASSETTE_H_
+
+#include <stdio.h>		/* for FILE and FILENAME_MAX */
+
+#include "atari.h"		/* for UBYTE */
+
+#define CASSETTE_DESCRIPTION_MAX 256
+
+extern char CASSETTE_filename[FILENAME_MAX];
+extern char CASSETTE_description[CASSETTE_DESCRIPTION_MAX];
+typedef enum {
+	CASSETTE_STATUS_NONE,
+	CASSETTE_STATUS_READ_ONLY,
+	CASSETTE_STATUS_READ_WRITE
+} CASSETTE_status_t;
+extern CASSETTE_status_t CASSETTE_status;
+
+/* Used in Atari800_Initialise during emulator initialisation */
+int CASSETTE_Initialise(int *argc, char *argv[]);
+void CASSETTE_Exit(void);
+/* Config file read/write */
+int CASSETTE_ReadConfig(char *string, char *ptr);
+void CASSETTE_WriteConfig(FILE *fp);
+
+/* Attaches a tape image. Also resets CASSETTE_write_protect to FALSE.
+   Returns TRUE on success, FALSE otherwise. */
+int CASSETTE_Insert(const char *filename);
+void CASSETTE_Remove(void);
+/* Creates a new file in CAS format. DESCRIPTION can be NULL.
+   Returns TRUE on success, FALSE otherwise. */
+int CASSETTE_CreateCAS(char const *filename, char const *description);
+
+extern int CASSETTE_hold_start;
+extern int CASSETTE_hold_start_on_reboot; /* preserve hold_start after reboot */
+extern int CASSETTE_press_space;
+
+/* Is cassette file write-protected? Don't change directly, use CASSETTE_ToggleWriteProtect(). */
+extern int CASSETTE_write_protect;
+/* Switches RO/RW. Fails with FALSE if the tape cannot be switched to RW. */
+int CASSETTE_ToggleWriteProtect(void);
+
+ /* Is cassette record button pressed? Don't change directly, use CASSETTE_ToggleRecord(). */
+extern int CASSETTE_record;
+/* If tape is mounted, switches recording on/off (otherwise return FALSE).
+   Recording operations would fail if the tape is read-only. In such
+   situation, when switching recording on the function returns FALSE. */
+int CASSETTE_ToggleRecord(void);
+
+void CASSETTE_Seek(unsigned int position);
+/* Returns status of the DATA IN line. */
+int CASSETTE_IOLineStatus(void);
+/* Get the byte which was recently loaded from tape. */
+int CASSETTE_GetByte(void);
+/* Put a byte into the cas file.
+   The block is being written at first putbyte of the subsequent block */
+void CASSETTE_PutByte(int byte);
+/* Set motor status: 1 - on, 0 - off */
+void CASSETTE_TapeMotor(int onoff);
+/* Advance the tape by a scanline. Return TRUE if a new byte has been loaded
+   and POKEY_SERIN must be updated. */
+int CASSETTE_AddScanLine(void);
+/* Reset cassette serial transmission; call when resseting POKEY by SKCTL. */
+void CASSETTE_ResetPOKEY(void);
+
+/* Return size in blocks of the currently-mounted tape file. */
+unsigned int CASSETTE_GetSize(void);
+/* Return current position (block number) of the mounted tape (counted from 1). */
+unsigned int CASSETTE_GetPosition(void);
+
+/* --- Functions used by patched SIO --- */
+/* -- SIO_Handler() -- */
+int CASSETTE_AddGap(int gaptime);
+/* Reads a record from tape and copies its contents (max. LENGTH bytes,
+   excluding the trailing checksum) to memory starting at address DEST_ADDR.
+   Returns FALSE if number of bytes in record doesn't equal LENGTH, or
+   checksum is incorrect, or there was a read error/end of file; otherwise
+   returns TRUE. */
+int CASSETTE_ReadToMemory(UWORD dest_addr, int length);
+/* Reads LENGTH bytes from memory starting at SRC_ADDR and writes them as
+   a record (with added checksum) to tape. Returns FALSE if there was a write
+   error, TRUE otherwise. */
+int CASSETTE_WriteFromMemory(UWORD src_addr, int length);
+/* -- Other -- */
+void CASSETTE_LeaderLoad(void);
+void CASSETTE_LeaderSave(void);
+
+/* Indicates whether the tape can be read from, ie. it's mounted and not on its
+   end. */
+extern int CASSETTE_readable;
+/* Indicates whether the tape can be written to, ie. it's mounted and not
+   read-only. */
+extern int CASSETTE_writable;
+
+#endif /* CASSETTE_H_ */