Wnk.asm - Revision history

Mr z: Protected "Wnk.asm" ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite))

2010-12-04T09:43:36Z

Protected "Wnk.asm" ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite))

Mr z: /* Functions Provided */

2008-09-12T04:10:03Z

‎Functions Provided

Mr z: /* Examples */

2008-09-12T04:09:28Z

‎Examples

Mr z: /* Examples */

2008-09-12T04:08:38Z

‎Examples

Mr z: /* Notes */

2008-09-12T03:44:10Z

‎Notes

Mr z: /* Functions Provided */

2008-09-12T03:40:36Z

‎Functions Provided

Mr z at 03:40, 12 September 2008

2008-09-12T03:40:05Z

New page

[[Category:Programming]] [[Category:Library]]

= Functions Provided =

<CENTER><TABLE BORDER><TR><TH>Entry point</TH><TH>Function provided</TH><TH>Notes</TH></TR>
<TR><TD>WAITKEY</TD><TD>Waits for a tap on either controller</TD><TD>Specifically, waits for there to be no input on either controller, then any input on either controller, and then no input again. Debounces the input to avoid glitches.</TD></TR>
<TR><TD>WAITNOKEY</TD><TD>Waits for there to be no input on either controller.</TD><TD>Debounced to avoid glitches.</TD></TR></TABLE></CENTER>
<br /><br />
See source code below for calling convention.<br /><br />

= Examples =

(todo... please contribute!)

= Notes =

= Source Code =

<pre>
;* ======================================================================== *;
;* These routines are placed into the public domain by their author. All *;
;* copyright rights are hereby relinquished on the routines and data in *;
;* this file. -- Joseph Zbiciak, 2008 *;
;* ======================================================================== *;

;; ======================================================================== ;;
;; WAITKEY Wait for release/press/release ;;
;; WAITNOKEY Wait for key release ;;
;; ======================================================================== ;;
WAITKEY PROC
PSHR R5
@@1: CALL WAITNOKEY ; Wait for release-press-release
@@wk MVI $1FE, R0
XOR $1FF, R0
BEQ @@wk
INCR PC ; skip PSHR R5
WAITNOKEY PSHR R5

@@waitnokey MVII #200, R1 ; Debounce counter

@@stillnk MVI $1FE, R0
XOR $1FF, R0
BNEQ @@waitnokey

DECR R1 ; Avoid glitches: Make sure it's good and gone
BPL @@stillnk

PULR PC
ENDP

;; ======================================================================== ;;
;; End of File: wnk.asm ;;
;; ======================================================================== ;;
</pre>

← Older revision		Revision as of 04:09, 12 September 2008
Line 11:		Line 11:
	= Examples =		= Examples =

−	The following example program counts the number of taps of the controller one has made and displays that count on screen.	+	The following example program counts the number of taps of the controller one has made and displays that count on screen. It uses several library files in addition to this one, including [[gimini.asm]], [[print.asm]], [[prnum16.asm]], [[prnum32.asm]], and [[fillmem.asm]].

← Older revision		Revision as of 03:44, 12 September 2008
Line 15:		Line 15:
	= Notes =		= Notes =

		+	The code reads both controllers by [[XOR]]ing the inputs of the two together. Thus, it is possible to fool this code into thinking nothing is pressed if the exact same thing is pressed on both controllers. This isn't seen as a big deal.
		+
		+	Despite "key" appearing in their name, WAITKEY and WAITNOKEY really look for <I>any</I> input. Disc, action buttons and keypad all have the same effect to this code.

	= Source Code =		= Source Code =

← Older revision	Revision as of 09:43, 4 December 2010
(No difference)

@@ Line 7: / Line 7: @@
 <TR><TD>WAITNOKEY</TD><TD>Waits for there to be no input on either controller.</TD><TD>Debounced to avoid glitches.</TD></TR></TABLE></CENTER>
 <br /><br />
-See source code below for calling convention.<br /><br />
+These functions take no arguments.
 = Examples =

@@ Line 11: / Line 11: @@
 = Examples =
-(todo... please contribute!)
+The following example program counts the number of taps of the controller one has made and displays that count on screen.
 = Notes =

@@ Line 4: / Line 4: @@
 <CENTER><TABLE BORDER><TR><TH>Entry point</TH><TH>Function provided</TH><TH>Notes</TH></TR>
-<TR><TD>WAITKEY</TD><TD>Waits for a tap on either controller</TD><TD>Specifically, waits for there to be no input on either controller, then any input on either controller, and then no input again.  Debounces the input to avoid glitches.</TD></TR>
+<TR><TD>WAITKEY</TD><TD>Waits for a tap on either controller</TD><TD>Specifically, waits for there to be no input on either controller, followed by an input from either controller, and then no input again.  Debounces the input to avoid glitches.</TD></TR>
 <TR><TD>WAITNOKEY</TD><TD>Waits for there to be no input on either controller.</TD><TD>Debounced to avoid glitches.</TD></TR></TABLE></CENTER>
 <br /><br />