Potgo Resource - Revision history

Steven Solie at 22:07, 9 May 2012

2012-05-09T22:07:22Z

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

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

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

Steven Solie at 16:39, 2 May 2012

2012-05-02T16:39:58Z

← Older revision		Revision as of 16:39, 2 May 2012
Line 3:		Line 3:
	The potgo resource provides three functions for working with the POTGO hardware.		The potgo resource provides three functions for working with the POTGO hardware.

	'''Potgo Resource Functions'''~~<br />~~		'''Potgo Resource Functions'''
⚫	AllocPotBits() ~~&~~ ~~8.7cmAllocate~~ bits in the POTGO register.~~<br />~~
⚫	FreePotBits() ~~&~~ ~~8.7cmFree~~ previously allocated bits in the POTGO register.~~<br />~~
⚫	WritePotgo() ~~&~~ ~~8.7cmSet~~ and clear bits in the POTGO register. The bits must have been allocated before calling this function.~~<br />~~

			{\| class="wikitable"
		⚫	\| AllocPotBits() \|\| Allocate bits in the POTGO register.
			\|-
		⚫	\| FreePotBits() \|\| Free previously allocated bits in the POTGO register.
			\|-
		⚫	\| WritePotgo() \|\| Set and clear bits in the POTGO register. The bits must have been allocated before calling this function.
			\|}

	The example program shown below demonstrates how to use the ptogo resource to track mouse button presses on port 1.		The example program shown below demonstrates how to use the ptogo resource to track mouse button presses on port 1.

	<pre>/*		<pre>
			/*
	* Read_Potinp.c		* Read_Potinp.c
	*		*
Line 92:		Line 97:

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

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

	2c'''Potgo Resource Information'''<br />		'''Potgo Resource Information'''<br />
	Includes & resources/potgo.h<br />		Includes & resources/potgo.h<br />
	& resources/potgo.i<br />		& resources/potgo.i<br />

Steven Solie: Created page with "The potgo resource is used to get control of the hardware POTGO register connected to the proportional I/O pins on the game controller ports. There are two registers, POTGO (w..."

2012-04-16T21:30:30Z

Created page with "The potgo resource is used to get control of the hardware POTGO register connected to the proportional I/O pins on the game controller ports. There are two registers, POTGO (w..."

New page

The potgo resource is used to get control of the hardware POTGO register connected to the proportional I/O pins on the game controller ports. There are two registers, POTGO (write-only) and POTINP (read-only). These pins could also be used for digital I/O.

The potgo resource provides three functions for working with the POTGO hardware.

'''Potgo Resource Functions''' 
AllocPotBits() & 8.7cmAllocate bits in the POTGO register. 
FreePotBits() & 8.7cmFree previously allocated bits in the POTGO register. 
WritePotgo() & 8.7cmSet and clear bits in the POTGO register. The bits must have been allocated before calling this function. 

The example program shown below demonstrates how to use the ptogo resource to track mouse button presses on port 1.

<pre>/*
* Read_Potinp.c
*
* An example of using the potgo.resource to read pins 9 and 5 of
* port 1 (the non-mouse port). This bypasses the gameport.device.
* When the right or middle button on a mouse plugged into port 1 is pressed,
* the read value will change.
*
* Use of port 0 (mouse) is unaffected.
*
* 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/potgo.h>
#include <hardware/custom.h>

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

#include <stdio.h>

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

struct PotgoBase *PotgoBase;
ULONG potbits;
UWORD value;

#define UNLESS(x) if(!(x))
#define UNTIL(x) while(!(x))

#define OUTRY 1L<<15
#define DATRY 1L<<14
#define OUTRX 1L<<13
#define DATRX 1L<<12

extern struct Custom far custom;

void main(int argc,char **argv)
{
UNLESS (PotgoBase=(struct PotgoBase *)OpenResource("potgo.resource"))
return;

potbits=AllocPotBits(OUTRY|DATRY|OUTRX|DATRX);

/* Get the bits for the right and middle mouse buttons on the alternate mouse port. */

if (potbits != (OUTRY|DATRY|OUTRX|DATRX))
{
printf("Pot bits are already allocated! %lx\n",potbits);
FreePotBits(potbits);
return;
}

/* Set all ones in the register (masked by potbits) */
WritePotgo(0xFFFFFFFFL,potbits);

printf("\nPlug a mouse into the second port. This program will indicate when\n");
printf("the right or middle button (if the mouse is so equipped) is pressed.\n");
printf("Stop the program with Control-C. Press return now to begin.\n");

getchar();

UNTIL (SIGBREAKF_CTRL_C & SetSignal(0L,0L))
/* until CTRL-C is pressed */
{
/* Read word at $DFF016 */
value = custom.potinp;

/* Show what was read (restricted to our allocated bits) */
printf("POTINP = $%lx\n",value & potbits);
}

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

|ll|

2c'''Potgo Resource Information''' 
Includes & resources/potgo.h 
& resources/potgo.i 
& utility/hooks.h 
& utility/hooks.i 
AutoDocs & potgo.doc