Misc Resource - Revision history

Janne Peräaho at 02:13, 24 June 2020

2020-06-24T02:13:29Z

← Older revision		Revision as of 02:13, 24 June 2020
Line 14:		Line 14:
	Once you’ve successfully allocated one of the misc resources, you are free to write directly to its hardware locations. Information on the serial and parallel hardware can be found in the ''Amiga Hardware Reference Manual'' and the hardware/custom.h include file.		Once you’ve successfully allocated one of the misc resources, you are free to write directly to its hardware locations. Information on the serial and parallel hardware can be found in the ''Amiga Hardware Reference Manual'' and the hardware/custom.h include file.

			The two examples below are assembly and ’C’ versions of the same code for locking the serial misc resources and waiting for <kbd class="keyboard-key nowrap" style="border: 1px solid #aaa; border-radius: 0.2em; box-shadow: 0.1em 0.2em 0.2em #ddd; background-color: #f9f9f9; background-image: -moz-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -o-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -webkit-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: linear-gradient(to bottom, #eee, #f9f9f9, #eee); padding: 0.1em 0.3em; font-family: inherit; font-size: 0.85em;">Ctrl</kbd> + <kbd class="keyboard-key nowrap" style="border: 1px solid #aaa; border-radius: 0.2em; box-shadow: 0.1em 0.2em 0.2em #ddd; background-color: #f9f9f9; background-image: -moz-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -o-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: -webkit-linear-gradient(top, #eee, #f9f9f9, #eee); background-image: linear-gradient(to bottom, #eee, #f9f9f9, #eee); padding: 0.1em 0.3em; font-family: inherit; font-size: 0.85em;">c</kbd> to be pressed before releasing them.
	The two examples below are assembly and ’C’ versions of the same code for locking the serial misc resources and waiting for CTRL-C to be pressed before releasing them.

	=== Assembly Example of Allocating Misc Resources ===		=== Assembly Example of Allocating Misc Resources ===

Janne Peräaho: Added code review request

2018-09-20T14:08:49Z

Added code review request

← Older revision		Revision as of 14:08, 20 September 2018
Line 1:		Line 1:
			{{CodeReview}}
	The misc resource oversees usage of the serial data port, the serial communication bits, the parallel data and handshake port, and the parallel communication bits. Before using serial or parallel port hardware, it first must be acquired from the misc resource.		The misc resource oversees usage of the serial data port, the serial communication bits, the parallel data and handshake port, and the parallel communication bits. Before using serial or parallel port hardware, it first must be acquired from the misc resource.

Steven Solie at 22:09, 9 May 2012

2012-05-09T22:09:27Z

← Older revision		Revision as of 22:09, 9 May 2012
Line 213:		Line 213:
	Additional programming information on the misc resource can be found in the include files and the Autodocs for the misc resource.		Additional programming information on the misc resource can be found in the include files and the Autodocs for the misc resource.

	'''Misc Resource Information'''~~<br />~~		'''Misc Resource Information'''
			{\| class="wikitable"
⚫	~~Includes &~~ resources/misc.h~~<br />~~
			! Includes
⚫	~~&~~ resources/misc.i~~<br />~~
			\|-
	AutoDocs & misc.doc<br />
		⚫	\| resources/misc.h
			\|-
		⚫	\| resources/misc.i
			\|}

			{\| class="wikitable"
			! AutoDocs
			\|-
			\| misc.doc
			\|}

Steven Solie at 16:39, 2 May 2012

2012-05-02T16:39:01Z

← Older revision		Revision as of 16:39, 2 May 2012
Line 3:		Line 3:
	The misc resource provides two functions for allocating and freeing the serial and parallel hardware.		The misc resource provides two functions for allocating and freeing the serial and parallel hardware.

	'''Misc Resource Functions'''~~<br />~~		'''Misc Resource Functions'''
⚫	AllocMiscResource() ~~&~~ ~~7.8cmAllocate~~ one of the serial or parallel misc resources.~~<br />~~
⚫	FreeMiscResource() ~~&~~ ~~7.8cmDeallocate~~ one of the serial or parallel misc resources.~~<br />~~

			{\| class="wikitable"
		⚫	\| AllocMiscResource() \|\| Allocate one of the serial or parallel misc resources.
			\|-
		⚫	\| FreeMiscResource() \|\| Deallocate one of the serial or parallel misc resources.
			\|}

	Once you’ve successfully allocated one of the misc resources, you are free to write directly to its hardware locations. Information on the serial and parallel hardware can be found in the ''Amiga Hardware Reference Manual'' and the hardware/custom.h include file.		Once you’ve successfully allocated one of the misc resources, you are free to write directly to its hardware locations. Information on the serial and parallel hardware can be found in the ''Amiga Hardware Reference Manual'' and the hardware/custom.h include file.
Line 14:		Line 17:
	=== Assembly Example of Allocating Misc Resources ===		=== Assembly Example of Allocating Misc Resources ===

	<pre>* Alloc_Misc.a		<pre>
			* Alloc_Misc.a
	*		*
	* Assembly language fragment that grabs the two parts of the serial		* Assembly language fragment that grabs the two parts of the serial
Line 96:		Line 100:
	MyName dc.b 'Serial Port Hog',0		MyName dc.b 'Serial Port Hog',0
	dc.w 0		dc.w 0
	END~~</pre>~~		END
		⚫	</pre>

	=== ’C’ Example of Allocating Misc Resources ===		=== ’C’ Example of Allocating Misc Resources ===

	<pre>/*		<pre>
			/*
	* Allocate_Misc.c		* Allocate_Misc.c
	*		*
Line 162:		Line 169:
	printf("\nUnable to allocate MR_SERIALPORT because %s owns it\n",owner);		printf("\nUnable to allocate MR_SERIALPORT because %s owns it\n",owner);
	}		}
			}
⚫	}</pre>
		⚫	</pre>

	The example below will try to open the serial device and execute the SDCMD_QUERY command. If it cannot open the serial device, it will do an AllocMiscResource() on the serial port and return the name of the owner.		The example below will try to open the serial device and execute the SDCMD_QUERY command. If it cannot open the serial device, it will do an AllocMiscResource() on the serial port and return the name of the owner.

Line 171:		Line 180:
	You do this by calling the function FlushDevice():		You do this by calling the function FlushDevice():

	<pre>/*		<pre>
			/*
	* A safe way to expunge ONLY a certain device. The serial.device holds		* A safe way to expunge ONLY a certain device. The serial.device holds
	* on to the misc serial resource until a general expunge occurs.		* on to the misc serial resource until a general expunge occurs.
Line 198:		Line 208:

	Permit();		Permit();
			}
⚫	}</pre>
			</pre>
⚫	Additional programming information on the misc resource can be found in the include files and the Autodocs for the misc resource.

		⚫	Additional programming information on the misc resource can be found in the include files and the Autodocs for the misc resource.
	\|ll\|

	2c'''Misc Resource Information'''<br />		'''Misc Resource Information'''<br />
	Includes & resources/misc.h<br />		Includes & resources/misc.h<br />
	& resources/misc.i<br />		& resources/misc.i<br />

Steven Solie: Created page with "The misc resource oversees usage of the serial data port, the serial communication bits, the parallel data and handshake port, and the parallel communication bits. Before usin..."

2012-04-16T21:30:05Z

Created page with "The misc resource oversees usage of the serial data port, the serial communication bits, the parallel data and handshake port, and the parallel communication bits. Before usin..."

New page

The misc resource oversees usage of the serial data port, the serial communication bits, the parallel data and handshake port, and the parallel communication bits. Before using serial or parallel port hardware, it first must be acquired from the misc resource.

The misc resource provides two functions for allocating and freeing the serial and parallel hardware.

'''Misc Resource Functions''' 
AllocMiscResource() & 7.8cmAllocate one of the serial or parallel misc resources. 
FreeMiscResource() & 7.8cmDeallocate one of the serial or parallel misc resources. 

Once you’ve successfully allocated one of the misc resources, you are free to write directly to its hardware locations. Information on the serial and parallel hardware can be found in the ''Amiga Hardware Reference Manual'' and the hardware/custom.h include file.

The two examples below are assembly and ’C’ versions of the same code for locking the serial misc resources and waiting for CTRL-C to be pressed before releasing them.

=== Assembly Example of Allocating Misc Resources ===

<pre>* Alloc_Misc.a
*
* Assembly language fragment that grabs the two parts of the serial
* resource (using misc.resource). If it gets the resource, it will
* wait for CTRL-C to be pressed before releasing.
*
* While we are waiting, the query_serial program should be run. It will try
* to open the serial device and if unsuccessful, will return the name of the
* owner. It will be us, Serial Port Hog!
*
* When a task has successfully obtained the serial resource, it "owns"
* the hardware registers that control the serial port. No other tasks
* are allowed to interfere.
*
* Assemble with Adapt
* HX68 Allocate_Misc.a to Allocate_Misc.o
*
* Link
* Blink FROM Allocate_Misc.o TO Allocate_Misc LIB LIB:amiga.lib
*

INCDIR "include:"
INCLUDE "exec/types.i"
INCLUDE "resources/misc.i"
INCLUDE "dos/dos.i"

xref _AbsExecBase ; We get this from outside...
xref _LVOOpenResource ; We get this from outside...
xref _LVOWait ; We get this from outside...

;
; Open Exec and the misc.resource, check for success
;
move.l _AbsExecBase,a6 ;Prepare to use exec
lea.l MiscName(pc),a1
jsr _LVOOpenResource(a6) ;Open "misc.resource"
move.l d0,d7 ;Stash resource base
bne.s resource_ok
moveq #RETURN_FAIL,d0
rts

resource_ok exg.l d7,a6 ;Put resource base in A6

;
; We now have a pointer to a resource.
; Call one of the resource's library-like vectors.
;
move.l #MR_SERIALBITS,d0 ;We want these bits
lea.l MyName(pc),a1 ;This is our name
jsr MR_ALLOCMISCRESOURCE(a6)
tst.l d0
bne.s no_bits ;Someone else has it...
move.l #MR_SERIALPORT,d0
lea.l MyName(pc),a1
jsr MR_ALLOCMISCRESOURCE(a6)
tst.l d0
bne.s no_port ;Someone else has it...
;
; We just stole the serial port registers; wait.
; Nobody else can use the serial port, including the serial.device!
;
exg.l d7,a6 ;use exec again
move.l #SIGBREAKF_CTRL_C,d0
jsr _LVOWait(a6) ;Wait for CTRL-C
exg.l d7,a6 ;Get resource base back
;
; Free 'em up
;
move.l #MR_SERIALPORT,d0
jsr MR_FREEMISCRESOURCE(a6)
no_port
move.l #MR_SERIALBITS,d0
jsr MR_FREEMISCRESOURCE(a6)
no_bits
moveq #RETURN_FAIL,d0
rts
;
; Text area
;
MiscName dc.b 'misc.resource',0
MyName dc.b 'Serial Port Hog',0
dc.w 0
END</pre>
=== ’C’ Example of Allocating Misc Resources ===

<pre>/*
* Allocate_Misc.c
*
* Example of allocating a miscellaneous resource
* We will allocate the serial resource and wait till
* CTRL-C is pressed. While we are waiting, the
* query_serial program should be run. It will try
* to open the serial device and if unsuccessful, will
* return the name of the owner. It will be us!
*
* Compile with SAS C 5.10 lc -b1 -cfistq -v -y -L
*
* Run from CLI only
*/

#include <exec/types.h>
#include <exec/memory.h>
#include <dos/dos.h>
#include <resources/misc.h>

#include <clib/exec_protos.h>
#include <clib/misc_protos.h>

#include <stdio.h>

#ifdef LATTICE
int CXBRK(void) { return(0); } /* Disable SAS CTRL/C handling */
int chkabort(void) { return(0); } /* really */
#endif

struct Library *MiscBase = NULL;

void main(int argc, char **argv)
{
UBYTE *owner = NULL; /* owner of misc resource */

if (!(MiscBase= (struct Library *)OpenResource(MISCNAME)))
printf("Cannot open %s\n",MISCNAME);
else
{
/* Allocate both pieces of the serial hardware */
if ((owner = AllocMiscResource(MR_SERIALPORT,"Serial Port Hog")) == NULL)
{
if ((owner = AllocMiscResource(MR_SERIALBITS,"Serial Port Hog")) == NULL)
{
/* Wait for CTRL-C to be pressed */
printf("\nWaiting for CTRL-C...\n");
Wait(SIGBREAKF_CTRL_C);

/* We're back */

/* Deallocate the serial port register */
FreeMiscResource(MR_SERIALBITS);
}
else
printf("\nUnable to allocate MR_SERIALBITS because %s owns it\n",owner);

/* Deallocate the serial port */
FreeMiscResource(MR_SERIALPORT);
}
else
printf("\nUnable to allocate MR_SERIALPORT because %s owns it\n",owner);
}
}</pre>
The example below will try to open the serial device and execute the SDCMD_QUERY command. If it cannot open the serial device, it will do an AllocMiscResource() on the serial port and return the name of the owner.

boxTake Over Everything.There are two serial.device resources to take over, MR_SERIALBITS and MR_SERIALPORT. You should get both resources when you take over the serial port to prevent other tasks from using them. The parallel.device also has two resources to take over. See the resources/misc.h include file for the relevant definitions and structures.

Under V1.3 and earlier versions of the Amiga system software the MR_GETMISCRESOURCE routine will always fail if the serial device has been used at all by another task (even if that task has finished using the resource. In other words, once a printer driver or communication package has been activated, it will keep the associated resource locked up preventing your task from using it. Under these conditions, you must get the resource back from the system yourself.

You do this by calling the function FlushDevice():

<pre>/*
* A safe way to expunge ONLY a certain device. The serial.device holds
* on to the misc serial resource until a general expunge occurs.
* This code attempts to flush ONLY the named device out of memory and
* nothing else. If it fails, no status is returned since it would have
* no valid use after the Permit().
*/

#include <exec/types.h>
#include <exec/execbase.h>

#include <clib/exec_protos.h>

void FlushDevice(char *);

extern struct ExecBase *SysBase;

void FlushDevice(char *name)
{
struct Device *devpoint;

Forbid();

if (devpoint=(struct Device *)FindName(&SysBase->DeviceList,name) )
RemDevice(devpoint);

Permit();
}</pre>
Additional programming information on the misc resource can be found in the include files and the Autodocs for the misc resource.

|ll|

2c'''Misc Resource Information''' 
Includes & resources/misc.h 
& resources/misc.i 
AutoDocs & misc.doc