Trackdisk Device - Revision history

Costel Mincea: Text replacement - "" to ""

2025-01-26T19:27:56Z

Text replacement - "<syntaxhighlight>" to "<syntaxhighlight lang="C" line>"

Steven Solie: /* Device Interface */

2015-11-06T19:28:15Z

Device Interface

← Older revision		Revision as of 19:28, 6 November 2015
Line 68:		Line 68:
	The trackdisk device operates like other Amiga devices. To use it, you must first open the device, then send I/O requests to it, and then close it when finished. See [[Exec_Device_I/O\|Exec Device I/O]] for general information on device usage.		The trackdisk device operates like other Amiga devices. To use it, you must first open the device, then send I/O requests to it, and then close it when finished. See [[Exec_Device_I/O\|Exec Device I/O]] for general information on device usage.

	The trackdisk device uses two different types of I/O request blocks, IOStdReq and IOExtTD and two types of commands, standard and extended. An IOExtTD is required for the extended trackdisk commands (those beginning with “ETD_”), but can be used for both types of commands. Thus, the IOExtTD is the type of I/O request that will be used in this ~~chapter~~.		The trackdisk device uses two different types of I/O request blocks, IOStdReq and IOExtTD and two types of commands, standard and extended. An IOExtTD is required for the extended trackdisk commands (those beginning with “ETD_”), but can be used for both types of commands. Thus, the IOExtTD is the type of I/O request that will be used in this article.

	<syntaxhighlight>		<syntaxhighlight>

Steven Solie: /* Removing a Diskchange Software Interrupt Handler */

2015-10-29T19:31:58Z

Removing a Diskchange Software Interrupt Handler

← Older revision		Revision as of 19:31, 29 October 2015
Line 449:		Line 449:
	=== Removing a Diskchange Software Interrupt Handler ===		=== Removing a Diskchange Software Interrupt Handler ===

	You remove a software interrupt handler by passing an IOExtTD to the device ~~with~~ a ~~pointer~~ to an ~~Interrupt structure set in io_Data,~~ the ~~length of the structure~~ set ~~in io_Length and~~ TD_REMCHANGEINT ~~set in io_Command~~. You ''must'' pass it the same Interrupt structure used to add the handler.		You remove a software interrupt handler by passing the same IOExtTD to the device you used with TD_ADDCHANGEINT but with the io_Command set to TD_REMCHANGEINT. You ''must'' pass it the same Interrupt structure used to add the handler.

	For maximum compatibility, when you remove the change interrupt handler with the TD_REMCHANGEINT command you must make sure that the TD_ADDCHANGEINT command was successful, and if not, then you will have to remove the IOExtTD as shown below:		For maximum compatibility, when you remove the change interrupt handler with the TD_REMCHANGEINT command you must make sure that the TD_ADDCHANGEINT command was successful, and if not, then you will have to remove the IOExtTD as shown below:
Line 460:		Line 460:
	if (IExec->CheckIO((struct IORequest *)DiskIO) == NULL)		if (IExec->CheckIO((struct IORequest *)DiskIO) == NULL)
	{		{
	DiskIO->iotd_Req.io_Length = sizeof(struct Interrupt)
	DiskIO->iotd_Req.io_Data = (APTR)Disk_Interrupt;
	DiskIO->io_Command = TD_REMCHANGEINT;		DiskIO->io_Command = TD_REMCHANGEINT;
	IExec->DoIO((struct IORequest *)DiskIO);		IExec->DoIO((struct IORequest *)DiskIO);

Steven Solie: /* Removing a Diskchange Software Interrupt Handler */

2015-10-29T19:24:36Z

Removing a Diskchange Software Interrupt Handler

@@ Line 450: / Line 450: @@
 You remove a software interrupt handler by passing an IOExtTD to the device with a pointer to an Interrupt structure set in io_Data, the length of the structure set in io_Length and TD_REMCHANGEINT set in io_Command. You ''must'' pass it the same Interrupt structure used to add the handler.
 <syntaxhighlight>
 DiskIO->iotd_Req.io_Command = TD_REMCHANGEINT;
 IExec->DoIO((struct IORequest *)DiskIO);
 </syntaxhighlight>

Steven Solie at 18:41, 29 October 2015

2015-10-29T18:41:13Z

← Older revision		Revision as of 18:41, 29 October 2015
Line 484:		Line 484:
	</syntaxhighlight>		</syntaxhighlight>

	A raw read may be synched with the index pulse by setting the IOTDF_INDEXSYNC flag or synched with a $4489 sync pattern by setting the IOTDF_WORDSYNC flag. See the [[trackdisk.doc]] in the SDK for more information about these flags.		A raw read may be synched with the index pulse by setting the IOTDF_INDEXSYNC flag or synched with a $4489 sync pattern by setting the IOTDF_WORDSYNC flag. See the [http://wiki.amigaos.net/amiga/autodocs/trackdisk.doc.txt trackdisk.doc] in the SDK for more information about these flags.

	{{Note\|title=Forewarned is Forearmed\|text=The AmigaOS development team may make enhancements to the disk format in the future. The AmigaOS development team intends to provide compatibility within the trackdisk device. Anyone who uses these raw routines is bypassing this upward-compatibility and does so at her own risk.}}		{{Note\|title=Forewarned is Forearmed\|text=The AmigaOS development team may make enhancements to the disk format in the future. The AmigaOS development team intends to provide compatibility within the trackdisk device. Anyone who uses these raw routines is bypassing this upward-compatibility and does so at her own risk.}}
Line 510:		Line 510:
	</syntaxhighlight>		</syntaxhighlight>

	A raw write may be synched with the index pulse by setting the IOTDF_INDEXSYNC flag or synched with a $4489 sync pattern by setting the IOTDF_WORDSYNC flag. See the [[trackdisk.doc]] in the SDK for more information about these flags.		A raw write may be synched with the index pulse by setting the IOTDF_INDEXSYNC flag or synched with a $4489 sync pattern by setting the IOTDF_WORDSYNC flag. See the [http://wiki.amigaos.net/amiga/autodocs/trackdisk.doc.txt trackdisk.doc] in the SDK for more information about these flags.

	{{Note\|title=Beware The Synch On Write\|text=Synch on write will most likely destroy some of the bits following the synch before reliable writing begins. This is due to how the ''Paula'' chip implements this feature. Use synch on write very carefully if at all.}}		{{Note\|title=Beware The Synch On Write\|text=Synch on write will most likely destroy some of the bits following the synch before reliable writing begins. This is due to how the ''Paula'' chip implements this feature. Use synch on write very carefully if at all.}}
Line 912:		Line 912:
	\|devices/trackdisk.i		\|devices/trackdisk.i
	\|-		\|-
	\|[[Autodocs:Main\|Autodocs]]\|\|[[trackdisk.doc]]		\|[[Autodocs:Main\|Autodocs]]\|\|[http://wiki.amigaos.net/amiga/autodocs/trackdisk.doc.txt trackdisk.doc]
	\|}		\|}

Steven Solie: /* Example Trackdisk Program */

2015-10-29T17:12:07Z

Example Trackdisk Program

← Older revision		Revision as of 17:12, 29 October 2015
Line 859:		Line 859:
	return(OKAY);		return(OKAY);
	}		}


	int main(int argc, char **argv)		int main(int argc, char **argv)
	{		{
		⚫	int32 unit[2];
	struct IOExtTD *diskreq0;
	struct IOExtTD *diskreq1;
	struct MsgPort *diskPort;
⚫	int32 unit[2];

	if (ParseArgs(argc, argv, unit)) /* Check inputs */		if (ParseArgs(argc, argv, unit)) /* Check inputs */
	{		{
	if (diskPort=IExec->~~CreatePort~~(~~NULL~~,~~NULL)~~)		struct MsgPort *diskPort = IExec->AllocSysObjectTags(ASOT_PORT, TAG_END);
			if (diskPort != NULL)
	{		{
	~~if (diskreq0=(~~struct IOExtTD *)IExec->~~CreateExtIO~~(~~diskPort~~,		struct IOExtTD *diskreq0 = IExec->AllocSysObjectTags(ASOT_IOREQUEST,
	sizeof(struct IOExtTD)))		ASOIOR_Size, sizeof(struct IOExtTD),
			ASOIOR_ReplyPort, diskPort,
			TAG_END);

			if (diskreq0 != NULL)
	{		{
	~~if (diskreq1=(~~struct IOExtTD *)IExec->~~CreateExtIO~~(~~diskPort~~,		struct IOExtTD *diskreq1 = IExec->AllocSysObjectTags(ASOT_IOREQUEST,
	sizeof(struct IOExtTD)))		ASOIOR_Size, sizeof(struct IOExtTD),
			ASOIOR_ReplyPort, diskPort,
			TAG_END);

			if (diskreq1 != NULL)
	{		{
	Do_OpenDevice(diskreq0,diskreq1, unit);		Do_OpenDevice(diskreq0,diskreq1, unit);
	IExec->~~DeleteExtIO~~(~~(struct IORequest~~ *)diskreq1);		IExec->FreeSysObject(ASOT_IOREQUEST, diskreq1);
	}		}
	else IDOS->Printf("Out of memory\n");		else IDOS->Printf("Out of memory\n");
	IExec->~~DeleteExtIO~~(~~(struct IORequest~~ *)diskreq0);		IExec->FreeSysObject(ASOT_IOREQUEST, diskreq0);
	}		}
	else IDOS->Printf("Out of memory\n");		else IDOS->Printf("Out of memory\n");
	IExec->~~DeletePort~~(diskPort);		IExec->FreeSysObject(ASOT_PORT, diskPort);
	}		}
	else IDOS->Printf("Could not create diskReq port\n");		else IDOS->Printf("Could not create diskReq port\n");

Steven Solie at 17:05, 29 October 2015

2015-10-29T17:05:39Z

← Older revision		Revision as of 17:05, 29 October 2015
Line 1:		Line 1:
	[[Category:Devices\|Trackdisk]]{{CodeReview}}
	== Trackdisk Device ==		== Trackdisk Device ==

Steven Solie: /* Example Trackdisk Program */

2015-10-29T17:04:33Z

Example Trackdisk Program

@@ Line 615: / Line 615: @@
 VOID disk_busy(CONST_STRPTR drive, int32 onflag)
+{
+}

Steven Solie: /* Example Trackdisk Program */

2015-10-29T17:01:38Z

Example Trackdisk Program

Show changes

Steven Solie: /* Writing Raw Data to a Disk */

2015-10-28T22:12:05Z

Writing Raw Data to a Disk

← Older revision		Revision as of 22:12, 28 October 2015
Line 504:		Line 504:
	DiskIO->iotd_Req.io_Length = 1024; /* number of bytes to write */		DiskIO->iotd_Req.io_Length = 1024; /* number of bytes to write */
	DiskIO->iotd_Req.io_Data = (APTR)Writebuffer; /* pointer to buffer */		DiskIO->iotd_Req.io_Data = (APTR)Writebuffer; /* pointer to buffer */
	DiskIO->iotd_Req.io_Offset = (~~ULONG~~)(TRACK_SIZE * track); /* track number */		DiskIO->iotd_Req.io_Offset = (uint32)(TRACK_SIZE * track); /* track number */
	DiskIO->iotd_Req.io_Flags = IOTDF_INDEX /* Set for index sync */		DiskIO->iotd_Req.io_Flags = IOTDF_INDEX /* Set for index sync */
	DiskIO->iotd_Count = change_count; /* diskchange number */		DiskIO->iotd_Count = change_count; /* diskchange number */