Admin: Created page with "= Action = Debounce a port pin connected to a switch. ..."

2013-02-08T17:19:28Z

Created page with "= Action = Debounce a port pin connected to a switch. ..."

New page

= Action =

Debounce a port pin connected to a switch.

 

 

= Syntax =

DEBOUNCE Px.y , state , label [ , SUB]

 

 

= Remarks =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="563" cellspacing="0" cellpadding="1" border="1" style="border: 2px solid rgb(0, 0, 0); border-spacing: 0px; border-collapse: collapse;"
|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 81px; height: 16px; border: 1px solid rgb(0, 0, 0);" |
Px.y

| valign="top" width="87%" style="width: 473px; height: 16px; border: 1px solid rgb(0, 0, 0);" |
A port pin like PINB.0 , to examine.

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 81px; border: 1px solid rgb(0, 0, 0);" |
State

| valign="top" width="87%" style="width: 473px; border: 1px solid rgb(0, 0, 0);" |
0 for jumping when PINx.y is low , 1 for jumping when PINx.y is high

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 81px; border: 1px solid rgb(0, 0, 0);" |
Label

| valign="top" width="87%" style="width: 473px; border: 1px solid rgb(0, 0, 0);" |
The label to GOTO when the specified state is detected

|- style="vertical-align: top;"
| valign="top" width="15%" style="width: 81px; border: 1px solid rgb(0, 0, 0);" |
SUB

| valign="top" width="87%" style="width: 473px; border: 1px solid rgb(0, 0, 0);" |
The label to GOSUB when the specified state is detected

|}
</div>
 

When you specify the optional parameter SUB, a GOSUB to label is performed instead of a GOTO.

 

The DEBOUNCE statement tests the condition of the specified pin and if true there will be a delay for 25 mS and the condition will be checked again. (eliminating bounce of a switch)

 

When the condition is still true and there was no branch before, it branches to specified the label.

 

When the condition is not true, or the logic level on the pin is not of the specified level, the code on the next line will be executed.

 

When DEBOUNCE is executed again, the state of the switch must have gone back in the original position before it can perform another branch. So if you are waiting for a pin to go low, and the pin goes low, the pin must change to high, before a new low level will result in another branch.

 

Each DEBOUNCE statement, which uses a different port, uses 1 BIT of the internal memory to hold its state. And as the bits are stored in SRAM, it means that even while you use only 1 pin/bit, a byte is used for storage of the bit.

 

DEBOUNCE will not wait for the input value to met the specified condition. You need to use BITWAIT if you want to wait until a bit will have a certain value.

 

So DEBOUNCE will not halt your program while a BITWAIT can halt your program if the bit will never have the specified value. You can combine BITWAIT and DEBOUNCE statements by preceding a DEBOUNCE with a BITWAIT statement.

 

 

= See also =

[[CONFIG DEBOUNCE|CONFIG DEBOUNCE]] , [[BITWAIT]]

 

 

= Example =

 <source lang="bascomavr">
'-----------------------------------------------------------------------------------------
'name : deboun.bas
'copyright : (c) 1995-2005, MCS Electronics
'purpose : demonstrates DEBOUNCE
'micro : Mega48
'suited for demo : yes
'commercial addon needed : no
'-----------------------------------------------------------------------------------------

$regfile = "m48def.dat" ' specify the used micro
$crystal = 4000000 ' used crystal frequency
$baud = 19200 ' use baud rate
$hwstack = 32 ' default use 32 for the hardware stack
$swstack = 10 ' default use 10 for the SW stack
$framesize = 40 ' default use 40 for the frame space

Config Debounce = 30 'when the config statement is not used a default of 25mS will be used but we override to use 30 mS

'Debounce Pind.0 , 1 , Pr 'try this for branching when high(1)
Debounce Pind.0 , 0 , Pr , Sub
Debounce Pind.0 , 0 , Pr , Sub
' ^----- label to branch to
' ^---------- Branch when P1.0 goes low(0)
' ^---------------- Examine P1.0

'When Pind.0 goes low jump to subroutine Pr
'Pind.0 must go high again before it jumps again
'to the label Pr when Pind.0 is low

Debounce Pind.0 , 1 , Pr 'no branch
Debounce Pind.0 , 1 , Pr 'will result in a return without gosub
End

Pr:
Print "PIND.0 was/is low"
Return
</source> {{Languages}}

[[Category:BASCOM Language Reference]]

DEBOUNCE - Revision history

Admin: Created page with "= Action = Debounce a port pin connected to a switch. ..."