Stefanhamburg: /* Partial Example */

2013-03-17T22:57:27Z

Partial Example

Stefanhamburg: /* See Also */

2013-03-17T22:53:48Z

Stefanhamburg: /* Remarks */

2013-03-17T22:53:03Z

Remarks

Show changes

Stefanhamburg: /* (COPIED FROM ENGLISH PAGE) = */

2013-03-17T21:07:05Z

(**COPIED FROM ENGLISH PAGE**) =

Admin: 1 revision

2013-02-15T19:15:27Z

1 revision

Admin: Created page with "= Action = Execute subroutine when the specified interrupt occurs.
2013-02-11T20:50:05Z

Created page with "= Action = Execute subroutine when the specified interrupt occurs. Action =

Execute subroutine when the specified interrupt occurs.

 

 

= Syntax =

ON interrupt label [NOSAVE|SAVE|SAVEALL]

 

 

= Remarks =
<div style="padding: 0px; margin: 0px 0px 0px 4px;">
{| width="577" 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="13%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
Interrupt

| valign="top" style="border: 1px solid rgb(0, 0, 0);" |
INT0, INT1, INT2, INT3, INT4,INT5, TIMER0 ,TIMER1, TIMER2, ADC , EEPROM , CAPTURE1, COMPARE1A, COMPARE1B,COMPARE1. Or you can use the AVR

name convention:

 

OC2 , OVF2, ICP1, OC1A, OC1B, OVF1, OVF0, SPI, URXC,

UDRE, UTXC, ADCC, ERDY and ACI.

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

| valign="top" style="border: 1px solid rgb(0, 0, 0);" |
The label to jump to if the interrupt occurs.

|- style="vertical-align: top;"
| valign="top" width="13%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
NOSAVE

| valign="top" style="border: 1px solid rgb(0, 0, 0);" |
When you specify NOSAVE, no registers are saved and restored in the interrupt routine. So when you use this option make sure to save and restore all used registers.

 

When you omit NOSAVE all used registers will be saved. These are SREG , R31 to R16 and R11 to R0 with exception of R6,R8 and R9 .

 

R12 – R15 are not saved. When you use floating point math in the ISR(not recommended) you must save and restore R12-R15 yourself in the ISR.

My_Isr:

Push R12 ' save registers

Push R13

Push R14

Push R15

 

Single = single + 1 ' we use FP

 

Pop R15  ' restore registers

Pop R14

Pop R13

Pop R12

RETURN

 

 

[[File:Notice.jpg|left|Notice.jpg]]When the AVR has extended IO-space (for example ATMega48, 88 or 168, see datasheet at the end: Registersummary), the compiler uses R23for a number of operations.  So Push and Pop R23 as well when using the NOSAVE-option when using these AVR's with extended IO-space.

|- style="vertical-align: top;"
| valign="top" width="13%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
SAVE

| valign="top" style="border: 1px solid rgb(0, 0, 0);" |
This is the default and is the same as when no parameter is provided. The most common used registers, SREG, and RAMPZ are saved and restored.

Saved : SREG , R31 to R16 and R11 to R0 with exception of R6,R8 and R9.

If RAMPZ exists, it will be saved as well.

|- style="vertical-align: top;"
| valign="top" width="13%" style="width: 71px; border: 1px solid rgb(0, 0, 0);" |
SAVEALL

| valign="top" style="border: 1px solid rgb(0, 0, 0);" |
This will save all registers that SAVE will save, but it will also save R12-R15. You should use this option when using floating point math in the ISR.

|}
</div>
 

You must return from the interrupt routine with the RETURN statement.

 

The first RETURN statement that is encountered that is outside a condition will generate a RETI instruction. You may have only one such RETURN statement in your interrupt routine because the compiler restores the registers and generates a RETI instruction when it encounters a RETURN statement in the ISR. All other RETURN statements are converted to a RET instruction.

 

The possible interrupt names can be looked up in the selected microprocessor register file. 2313def.dat for example shows that for the compare interrupt the name is COMPARE1. (look at the bottom of the file)

 

 

What are interrupts good for?

 

An interrupt will halt your program and will jump to a specific part of your program. You can make a DO .. LOOP and poll the status of a pin for example to execute some code when the input on a pin changes.

 

But with an interrupt you can perform other tasks and when then pin input changes a special part of your program will be executed. When you use INPUT "Name ", v for example to get a user name via the RS-232 interface it will wait until a RETURN is received. When you have an interrupt routine and the interrupt occurs it will branch to the interrupt code and will execute the interrupt code. When it is finished it will return to the Input statement, waiting until a RETURN is entered.

 

Maybe a better example is writing a clock program. You could update a variable in your program that updates a second counter. But a better way is to use a TIMER interrupt and update a seconds variable in the TIMER interrupt handler.

 

There are multiple interrupt sources and it depends on the used chip which are available.

 

To allow the use of interrupts you must set the global interrupt switch with a ENABLE INTERRUPTS statement. This only allows that interrupts can be used. You must also set the individual interrupt switches on!

 

ENABLE TIMER0 for example allows the TIMER0 interrupt to occur.

 

With the DISABLE statement you turn off the switches.

 

When the processor must handle an interrupt it will branch to an address at the start of flash memory. These addresses can be found in the DAT files.

 

The compiler normally generates a RETI instruction on these addresses so that in the event that an interrupt occurs, it will return immediately.

 

When you use the ON ... LABEL statement, the compiler will generate code that jumps to the specified label. The SREG and other registers are saved at the LABEL location and when the RETURN is found the compiler restores the registers and generates the RETI so that the program will continue where it was at the time the interrupt occurred.

 

When an interrupt is services no other interrupts can occur because the processor(not the compiler) will disable all interrupts by clearing the master interrupt enable bit. When the interrupt is services the interrupt is also cleared so that it can occur again when the conditions are met that sets the interrupt.

 

It is not possible to give interrupts a priority. The interrupt with the lowest address has the highest interrupt!

 

 

Finally some tips :

 

when you use a timer interrupt that occurs each 10 uS for example, be sure that the interrupt code can execute in 10 uS. Otherwise you would loose time.

 

it is best to set just a simple flag in the interrupt routine and to determine it's status in the main program. This allows you to use the NOSAVE option that saves stack space and program space. You only have to Save and Restore R24 and SREG in that case.

 

*Since you can not PUSH a hardware register, you need to load it first:

 

PUSH R24 ; since we are going to use R24 we better save it

 

IN r24, SREG ; get content of SREG into R24

PUSH R24 ; we can save a register

 

;here goes your asm code

POP R24 ;get content of SREG

 

OUT SREG, R24 ; save into SREG

POP R24 ; get r24 back

 

= See Also =

[[ON VALUE|On VALUE]]

 

 

= Partial Example =

 <source lang="bascomavr">
Enable Interrupts
Enable Int0 'enable the interrupt
On Int0 Label2 Nosave 'jump to label2 on INT0
Do'endless loop
nop
Loop
End

Label2:
Dim A As Byte
If A > 1 Then
Return 'generates a RET because it is inside a condition
End If
Return 'generates a RETI because it is the first RETURN
Return 'generates a RET because it is the second RETURN
</source> {{Languages}}

[[Category:BASCOM Language Reference/de]]

@@ Line 231: / Line 231: @@
 <span style="font-family: Arial;">&nbsp;</span>
-= <span class="f_Header">Partial Example</span> =
+= <span class="f_Header">Teilbeispiel</span> =
 <br/><source lang="bascomavr">
 Enable Interrupts
-Enable Int0 'enable the interrupt
+Enable Int0 'Int0 Interrupt einschalten
-On Int0 Label2 Nosave 'jump to label2 on INT0
+On Int0 Label2 Nosave 'Sprung zu label2 wenn INT0 auftritt
-Do'endless loop
+Do'Endlosschleife
 nop
 Loop
@@ Line 245: / Line 245: @@
 Dim A As Byte
 If A > 1 Then
-Return 'generates a RET because it is inside a condition
+Return 'generiert ein RET weil es in der Abfrage ist
 End If
-Return 'generates a RETI because it is the first RETURN
+Return 'generiert ein RETI weil es das erste RETURN ist
-Return 'generates a RET because it is the second RETURN
+Return 'generiert ein RET weil es das zweite RETURN ist
 </source><br/>{{Languages}}
 [[Category:BASCOM Language Reference/de]]

@@ Line 223: / Line 223: @@
 <span style="font-family: Arial;">&nbsp;</span>
-= <span class="f_Header">See Also</span> =
+= <span class="f_Header">Siehe auch</span> =
 [[ON VALUE|On VALUE]]

@@ Line 1: / Line 1: @@
-== (**COPIED FROM ENGLISH PAGE**) === <span class="f_Header">Action</span> =
+= <span class="f_Header">Funktion</span> =
-Execute subroutine when the specified interrupt occurs.
+Führt die Subroutine aus wenn der angegebene Interrupt auftritt.
 <span style="font-family: Arial;">&nbsp;</span>

ON INTERRUPT/de - Revision history

Stefanhamburg: /* Partial Example */

Stefanhamburg: /* See Also */

Stefanhamburg: /* Remarks */

Stefanhamburg: /* (**COPIED FROM ENGLISH PAGE**) = */

Admin: 1 revision

Stefanhamburg: /* (COPIED FROM ENGLISH PAGE) = */