MAXQ Microcontroller Interrupt Programming

Introduction

No special knowledge is implied or required to read this note, but basic familiarity with the MAXQ architecture and register map is a plus. That information can be found in The MAXQ Family User Guide, data sheets (e.g., MAXQ2000), and other application notes (e.g., Introduction to the MAXQ Architecture; An Example Application Using the MAXQ2000 Evaluation Kit). The source code and project files of the examples used in this application note can be downloaded.

MAXQ10 and MAXQ20 microcontrollers are equipped with a simple, inexpensive single-vector interrupt mechanism, while interrupt sources and controls are organized logically into a three-level hierarchical structure. The hardware does not prioritize interrupts. The application code is responsible for dispatching of various interrupts through the single vector, therefore, programming and debugging the interrupts is an important part of the application development cycle. This note provides:

1. A starter guide for those who need to program simple interrupt functionality
2. Hints for implementing more elaborate interrupt priority schemes, nested interrupts, and best utilization of available hardware resources.

MAXQ Interrupt Mechanism Overview

The MAXQ family of microcontrollers has a register IV (Interrupt Vector) which holds the address of the interrupt routine, and a bit INS (Interrupt iN Service) to indicate an interrupt activity. When an interrupt is triggered, the processor core behaves as if "call IV" and "move INS,#1" instructions were inserted in the code. The MAXQ core executes a subroutine call, i.e., the instruction pointer IP is pushed into stack and loaded with the content of the IV register, then it sets the INS bit to signify that there is an active "interrupt in service" preventing further interrupt calls. Interrupt service finishes with the "RETI" (or "POPI") instruction, which pops the return address from the stack into IP and clears the INS bit, and user code resumes from the place where it was interrupted.

The interrupt trigger logic is presented in Figure 1, using the MAXQ2000 microcontroller as an example. Other MAXQ microcontrollers might have different sets of interrupt sources, but the logical structure is generic throughout the entire MAXQ family.

Logical structure begins with the individual interrupt sources listed on the left in Figure 1. Every source has an associated interrupt flag—a special bit that is set by hardware when the interrupt event from that source is detected. Each source also has an individual enable bit, which allows applications to enable or disable the interrupt source. The interrupt signal from that source is only active when both the flag and enable bits are set to 1. These bits provide individual interrupt signaling and control in the MAXQ architecture.

Because the MAXQ architecture is modular, interrupts are also grouped according to their location in modules. Like individual interrupt sources, every module has its own interrupt flag and enable bit, as shown in the middle in Figure 1. The flag is a logical "OR" of all the underlying interrupt signals from that module, while the enable bit allows applications to enable or disable interrupts for an entire module. These bits are allocated in two 8-bit registers (flags in IIR and enables in IMR) and provide interrupt signaling and control at the module level.

Finally, interrupt signals from all modules are "ORed" to form a global interrupt trigger signal, as shown on the right in Figure 1. The "interrupt global enable" bit, IGE, allows applications to disable or enable this signal, providing interrupt control at the global level.

Once set, an individual interrupt flag stays set until cleared by software (i.e., by interrupt service code), even if the condition which caused the flag to set is gone or removed. If software fails to clear the flag, the interrupt will be triggered repeatedly after exiting the service code. A modular interrupt flag (IIR register) is read-only; it is cleared automatically as soon as all underlying individual flags within a module are cleared by application code.

In the configuration shown in Figure 1, the global interrupt trigger signal on the right is active, caused by three individual sources on the left: UART1 Transmit, Timer1 Overflow, and Watchdog Timer. All three have both their individual flag and enable bits set. One more source (Ext8 in module 1 is also signaling, but that signal is masked (disabled) at the module level, because the interrupt mask bit IMR.1 is 0. The software in the interrupt service routine (ISR) identifies the signaling sources by analyzing flags and enable bits (shown in Figure 1 in reverse order, that is, from right to left), then services each active source and clears the individual interrupt flags.

Programming a Simple Interrupt Service Routine

Many applications do not require complex interrupt functionality—just one or two interrupts with no regard to priority. Let's see how to program such service routines for the MAXQ. We use the IAR Embedded Workbench^® as an example programming tool, but our code is mostly portable (except for a few tool-specific features, indicated below).

Assume that an existing application needs to fire short pulses on a port pin every millisecond while doing many other important tasks. This could be implemented using an on-board timer configured to produce an interrupt request every 1ms.

To accomplish the interrupt programming we need to add some interrupt-related code to the existing interrupt-less application. The interrupt-related code consists of two parts: the initialization and the ISR. The initialization code is placed somewhere at the beginning of the application to set the proper interrupt configuration: the enable bits (individual, module, and global) and the IV register. The ISR can be placed anywhere, and should perform three basic tasks before exiting:

1. Identify the source of an interrupt (not necessary if only one source is used)
2. Clear the interrupt flag
3. Execute required actions

First, let's see how all this works in assembly language. C-programmers may skip this section, though it does provide helpful insight into what is going on behind the curtains. Figure 2 shows the source code of our interrupt-less application. Besides many other very important tasks, it continuously outputs the byte 0x35 (ASCII symbol "5") at baud rate of 115200. When run on the hardware, the output can be easily captured via the COM port, as shown in Figure 3.

Now we add the interrupt code, starting with the ISR, following the four steps outlined above.

1. Because only one interrupt is active, no source identification is needed;
2. If we use Timer1 overflow interrupt, the flag is bit 3 of register 8 of module 4. Clear it with



move  M4[8].3,#0  ; clear interrupt flag



3. If we use port pin P0.0 to fire a pulse, the action code might look as follows:



move  M0[0].0,#1  ; set pin high
move  M0[0].0,#0  ; set pin low




That solves the task, but we can't see the result without an oscilloscope. To visualize it, let's output something other than "5" via serial port, say "$" symbol (0x24):




move  M2[7],#0x24 ; start transmission




With this addition, we expect to see occasional $s among the 5s on the output (if ISR is executed). Note that the ISR can be invoked when the serial port is busy transmitting, causing a conflict between "$" and "5" characters. A properly written ISR should avoid such conflicts, of course, but we intentionally ignore this problem for the sake of simplicity.

4. Exit



reti  ; exit ISR

The interrupt initialization code should:

1. Configure Timer1 to overflow every 1ms.



move  M4[10],#(65536-16000)  ; ovfl every 1ms @ 16MHz
move  M4[9],M4[10]           ; init counter
move  M4[16],#0x0            ; 16-bit timer mode



2. Load the IV register with the address of the ISR.



move  IV,#
   ;  load interrupt vector



3. Enable Timer1 Overflow interrupt at all three levels: individual, module, and global.



move  M4[0],#0x88      ; int enabled, start the timer
move  IMR.4,#1         ; enable ints from module 4
move  IC.0,#1          ; enable global interrupts (IGE=1)

We also must initialize the port pin, i.e., set direction and voltage level:

move  M0[16].0,#1 ; Configure Port Pin P0.0 direction (output)
move  M0[0].0,#0  ; Set Port Pin P0.0 Low

Assembling all the pieces together, we end up with the code presented in Figure 4 and its output, in Figure 5. There are $s as expected, and short pulses are fired on the port pin P0.0 every 1ms. The pattern of $s and 5s is not exactly regular because of the aforementioned transmission conflicts—some $s don't get through.

Now let's redo the same application in C. This is even easier because C-compiler is going to do some work for us. Namely, the IAR C-compiler sets the interrupt vector IV to a generic ISR that identifies the signaling module and calls a C-function corresponding to this module. It also takes care of saving/restoring the registers used inside the ISR, so application flow will not be disrupted by an interrupt. All we need to do is write the ISR-function for each module that will generate interrupts and configure, i.e., set enable bits properly. The latter is important—if an application mistakenly enables an interrupt which does not have a corresponding ISR-function, the result will be hard to predict.

We now follow the same logical steps, but this time using C-syntax for our ISR-function.

1. Source Identification. We must tell the compiler what module is the source for the interrupt:



#pragma vector=4
__interrupt void  isr_module4() {}




The #pragma directive and keyword __interrupt inform the compiler that the following function (isr_module4() in our example) should be invoked when there is an active interrupt signal from module 4. Because only one source within module 4 is active, no more source identification is needed.

2. Clear the flag. If we use Timer1 Overflow interrupt, the flag is bit TF2 in the register T2CNB1. Clear it with



T2CNB1_bit.TF2=0; // clear interrupt flag




Note that names TF2 and T2CNB1_bit are merely substitutes for bit 3 and register M4[8], respectively. They are defined in the tool-specific include file "iomaxq200x.h".

3. Interrupt action. Issue a pulse on the port pin P0.0:



PO0=1;            // set pin high
PO0=0;            // set pin low




and send a symbol "$" via the serial port for visualization.




SBUF0='$';        // start transmission




Again, the names are defined in the include file and serve as substitutes for Mxx[yy].

4. Exit. Nothing to do; the compiler takes care of that.

Similarly, the interrupt initialization code is a direct ASM-to-C translation, except for setting the IV register which is done automatically by the compiler:

1. Configure Timer1 to overflow every 1ms.

T2R1=65536-16000; // ovfl every 1ms @ 16MHz
T2V1=T2R1;        // init counter
T2CFG1=0;         // 16-bit timer mode



2. Load the IV register with the ISR address—done by the compiler.
3. Enable Timer1 Overflow interrupt at all three levels: individual, module, and global.



T2CNA1=0x88;      // int enabled, start the timer
IMR_bit.IM4=1;    // enable ints from module 4
IC_bit.IGE=1;     // enable global interrupts (IGE=1)

We also must initialize the port pin, i.e. set direction and voltage level:

PD0=1;            // Configure P0.0 direction (output)
PO0=0;            // Set P0.0 Low

Assembling all the pieces together we end up with the code presented in Figure 6. When run on hardware, its output looks the same as shown in Figure 5.

Programming Nested Interrupts

Usually, when an interrupt is being serviced, the trigger signal is blocked at the global level by a special bit called INS (not shown in Figure 1). That bit is automatically set by hardware when entering the ISR and cleared when the RETI or POPI instruction is executed (usually when exiting an ISR). No interrupt can be triggered while INS = 1. However, some applications might want to allow nested or recursive interrupts. This can be done by clearing the INS bit inside the ISR, allowing interruption of the interrupt service routine flow. Note that the second interrupt call will be vectored to the same ISR pointed by the IV register as the first one, therefore the application should make provisions against infinite loops when allowing recursive interrupt calls.

Figure 7 shows an application with an interrupt activated on the falling edge of a port pin (connected to a push-button). This application uses the Ext0 interrupt on the MAXQ2000, located in module 0. The push-button is connected to the corresponding port pin P0.4. The interrupt service routine is designed to allow interruption of its own code by clearing the INS bit (line 14 in Figure 7). The intrinsic function __reenable_interrupt() is provided for this purpose, though the same job could be done by writing the bit directly: IC_bit.INS=0;. To prevent an infinite loop, the ISR calculates the level of nesting by incrementing the global variable nest_level on entry and decrementing on exit. The INS bit is cleared only when nesting level does not exceed a certain limit (up to 7 levels are allowed in this example).

While no interrupts happen, the application continuously outputs the character "0" via the serial port, indicating that the main() function is being executed. When the button is pushed, the ISR prints the current nesting level and executes an idle loop for a few more seconds, so the button could be pushed again while the ISR is still running. When the nesting reaches level 7, the INS bit is not cleared any more. If the button is pressed while executing the ISR at level 7, the new interrupt request stays pending (the flag is set but the trigger signal is blocked by INS = 1) until the ISR finishes and exits, clearing the INS bit and resuming the ISR at level 6. Then the pending interrupt becomes active and causes an ISR call at level 7 again. This described behavior is illustrated in Figure 8—each nonzero digit indicates an ISR entry, including recursive interrupt calls.

Programming Interrupt-Priority Schemes

Thus far we have only considered simple applications with one interrupt source. More advanced applications can use multiple interrupt sources at the same time, such as RTC alarms, timers/counters, push-buttons, or other external I/O signals, watchdog, send/receive communications to/from UART(s), SPI^™, 1-Wire^®, etc. Various interrupts might come and go, and several interrupt sources might become active simultaneously, but the application can only service them one at a time. Therefore, the application must apply some rules to decide which of the simultaneously active sources should be serviced first, second, and so forth. These rules are usually expressed in terms of interrupt priority—each interrupt source is assigned an integer number called a priority. In case of a collision, the higher priority sources get serviced before the lower priority ones.

In the MAXQ architecture, such interrupt service ordering must be implemented in software, because no hardware priority exists. In this application note we consider just two of many possible approaches to prioritizing interrupt services:

1. Source identification ordering (without recursive interrupts)
2. Dynamic interrupt re-configuration (with recursive interrupts)

In fact, both methods can be mixed together in one application, as we will see in the following example, creating flexible and effective interrupt service structure.

The former method implies arranging the source-identification part of the ISR in such a way that higher priority sources are identified and serviced first, before the lower priority sources. For example, assume the three sources in Figure 1 are signaling simultaneously, but the application wants to process the Watchdog interrupt first, then the Timer1 Overflow, and then the UART1 Transmit. The task can be solved by the following pseudo-code:

if ( <Watchdog is signaling> )
        { <service the Watchdog interrupt> }
if ( <Timer1 Overflow is signaling> )
        { <service the Timer1 Overflow interrupt> }
if ( <UART1 Transmit is signaling> )
        { <service the UART1 Transmit interrupt> }

This simple technique has almost no overhead; it does not require extra memory or recursive interrupt calls. Each interrupt is executed from start to finish in the order it was received, except when two or more interrupts are pending. In that case, the order of servicing is defined by the source-identification arrangement in the application code. But this method has a drawback: if an urgent, highest priority interrupt occurs when the other source is being serviced, it must wait until the ISR finishes, and by that time it might be too late. To overcome this problem we have to allow interruption of the ISR flow, which brings us to the second method—dynamic interrupt re-configuration.

The latter approach is more general and implies the following steps for each individual ISR:

1. Save the current interrupt configuration and re-configure the entire set of the enable bits in order to disable all lower (than current) or equal priority sources, but enable higher priority sources
2. Allow recursive interrupts, i.e., clear the INS bit
3. Execute the action for the current interrupt
4. Disallow recursive interrupts, i.e., set the INS bit
5. Restore saved in step i) interrupt configuration and exit.

This implementation allows a higher priority interrupt to be serviced almost immediately, even if it occurs while a lower priority source is being serviced. However, this method consumes more data and program space, increasing with every extra interrupt source added to the scheme.

To demonstrate both methods, we create an example MAXQ2000 application with the following interrupt priority scheme:

The watchdog timer is given the highest priority because it will reset the device if not cleared in time. Then we make use of the UART's transmit interrupt, which signals that a byte has been successfully sent and the next byte transmission can be started. This interrupt is also a high priority to ensure fast communication and prevent the buffer from overflowing. Next comes the Timer1, which fires pulses at a comparatively slow but regular pace. The push-button interrupts are given lower priority because they are coming irregularly.

The modular architecture makes it easy and convenient to assign priority at the module level. In this case, the only configuration data to save/reconfigure/restore is the IMR register, which is the 8-bit module interrupt mask. Otherwise, the entire set of the scattered individual enable bits must be stored, reconfigured, and restored in every individual ISR. Therefore, we implement a general priority approach (dynamic re-configuration) for the modules, but a simple ordering method for interrupt sources within a module.

The module 1 in our example has multiple interrupt sources, and Figure 9 shows how the priority is implemented inside the module 1 interrupt routine isr_module1(). First, it saves the current interrupt configuration (line 39 in Figure 9), then reconfigures interrupts to disable sources in module 1, but enable higher priority modules 0, 4, 2, 7 (line 40), and re-enables interrupts by clearing the INS bit (line 41). Then it identifies and services the interrupt sources within module 1 in the order of their priority. The higher priority int12 is checked first (lines 45-50), the lower priority int11 is checked second (lines 52-57), and the lowest priority int10 is checked last (lines 59-64). The service routines for those interrupts have long delay loops (inside the button() function, lines 48, 55, and 62 in Figure 9), so other interrupts can occur while the interrupt routine isr_module1() is still running.

Other interrupts are designed in similar fashion (see full source code in Appendix A, available for download), except for the highest priority Watchdog interrupt where no re-configuration is needed. The application writes various ASCII marks via UART0 so they can be captured on the PC to visualize the execution flow. For the demonstration, the hardware was assembled with two push-buttons: one connected to the pin P0.4 activating the External Interrupt 0 when pressed; another connected to pins P5.2, P5.3, P6.0 corresponding to the External Interrupts 10, 11, 12, respectively, so all three interrupts get activated simultaneously when that button is pressed down. Since the former interrupt Ext0 has higher priority, we will call it a "red button," while another button will be referred as "green button," activating the three lower priority interrupts.

When no buttons are pressed, the application prints "=Reset=" and then continuously writes the word "Main," dots "..." and the word "<Timer>" indicating that after the reset it executes the main() function, and is interrupted often by Watchdog (dots) and occasionally by Timer1 overflow (see Figure 10). When any push-button interrupt is detected, the application prints "<ExtN" on ISR entry and "ExtN>" on ISR exit (N is the number of the external interrupt). For the example presented in Figure 10, the "green" button was pushed once and then the "red" button several times. The "green" button activated three external interrupts—10, 11, and 12 simultaneously—but as we can see in Figure 10, the int12 is serviced first according to its priority, while int11 and int10 are pending. The ISR is clearly interrupted by Watchdog and Timer. Immediately after comes int11 (int10 is still pending), which got interrupted by the higher priority int0 activated with the "red" button. At last, immediately after int11 comes int10, which in turn is interrupted several times by the "red" button pressing (int0). Somewhere along the way there was a moment when all prioritized interrupts were nested: main function interrupted by int10 push-button, interrupted by int0 push-button, interrupted by Timer1 overflow, interrupted by UART transmit, interrupted by Watchdog!

Conclusion

The MAXQ microcontroller interrupt mechanism is very simple and highly configurable, making interrupt programming for the MAXQ an easy task. Despite the limited hardware resources, the unique modular architecture of the MAXQ allows developers to implement complex interrupt-priority schemes with very little overhead.

1-Wire is a registered trademark of Dallas Semiconductor
IAR Workbench is a registered trademark of IAR Systems
SPI is a trademark of Motorola, Inc.

Appendix A

MAXQ2000 Application with Multiple Prioritazed Interrupts

#include  "string.h"
// Tool-specific include files
#include  "iomaxq200x.h"  // MAXQ2000 registers
#include  "intrinsics.h"  // intrinsic functions

  // Output Buffer
#define buf_len 80
char  buffer[buf_len];
int   ptr;
  // this will append the buffer with text
void  appendbuf(char * text) {
  int i=0;
  while(text[i] && ptr<buf_len)  buffer[ptr++]=text[i++];
}

// Interrupt Service Routines

  // Push-button actions
void  button(int num) {
  long i;
  switch(num)
  {
    // Red Button
    case 0:
      for(i=0;i<100000;) i++; // pause (burn 100,000 cycles)
      break;
    // Other buttons
    case 12: case 11: case 10:
      for(i=0;i<100000;) i++; // pause (burn 100,000 cycles)
      break;
  }
}

  // Ext 10,11,12
#pragma vector=1
__interrupt void isr_module1() {
  int mask;
  // Re-configure interrupts
  mask=__get_interrupt_state(); // save configuration (mask=IMR;)
  __set_interrupt_state(0x95);  // disable mod 1; enable 0,2,4,7
  __reenable_interrupt();       // allow recursive calls (INS=0)

    // Individual ISR
    // Check Int12
    if(EIF1_bit.IE12) {
      EIF1_bit.IE12=0;      // clear int flag
      appendbuf("<Ext12");  // append buffer with text
      button(12);           // push-button action
      appendbuf("Ext12>");  // append buffer with text
    }
    // Check Int11
    if(EIF1_bit.IE11) {
      EIF1_bit.IE11=0;      // clear int flag
      appendbuf("<Ext11");  // append buffer with text
      button(11);           // push-button action
      appendbuf("Ext11>");  // append buffer with text
    }
    // Check Int10
    if(EIF1_bit.IE10) {
      EIF1_bit.IE10=0;      // clear int flag
      appendbuf("<Ext10");  // append buffer with text
      button(10);           // push-button action
      appendbuf("Ext10>");  // append buffer with text
    }

  // Restore interrupt configuration
  IC_bit.INS=1;                 // restore INS=1
  __set_interrupt_state(mask);  // restore mask (IMR=mask;)
}

  // Ext 0
#pragma vector=0
__interrupt void isr_module0() {
  int mask;
  // Re-configure interrupts
  mask=__get_interrupt_state(); // save configuration (mask=IMR;)
  __set_interrupt_state(0x94);  // disable mod 0,1; enable 2,4,7
  __reenable_interrupt();       // allow recursive calls (INS=0)

    // Individual ISR
    EIF0_bit.IE0=0;       // clear int flag
    appendbuf("<Ext0");   // append buffer with text
    button(0);            // Red push-button action
    appendbuf("Ext0>");   // append buffer with text

  // Restore interrupt configuration
  IC_bit.INS=1;                 // restore INS=1
  __set_interrupt_state(mask);  // restore mask (IMR=mask;)
}

  // Timer 1
#pragma vector=4
__interrupt void isr_module4() {
  int mask;
  // Re-configure interrupts
  mask=__get_interrupt_state(); // save configuration (mask=IMR;)
  __set_interrupt_state(0x84);  // disable mod 1,0,4; enable 2,7
  __reenable_interrupt();       // allow recursive calls (INS=0)

    // Individual ISR
    T2CNB1_bit.TF2=0;     // clear interrupt flag
    PO0 |= 0x01;          // set pin hi
    appendbuf("<Timer>"); // append buffer with text
    PO0 &= 0xFE;          // set pin low

  // Restore interrupt configuration
  IC_bit.INS=1;                 // restore INS=1
  __set_interrupt_state(mask);  // restore mask (IMR=mask;)
}

  // UART0 Transmit Done
#pragma vector=2
__interrupt void isr_module2() {
  int mask;
  // Re-configure interrupts
  mask=__get_interrupt_state(); // save configuration (mask=IMR;)
  __set_interrupt_state(0x80);  // disable mod 1,0,4,2; enable 7
  __reenable_interrupt();       // allow recursive calls (INS=0)

    // Individual ISR
    SCON0_bit.TI=0;                     // clear int flag
    if(ptr>0) {
      SBUF0=buffer[0];                  // output next byte
      memmove(buffer,&buffer[1],ptr--); // shift the buffer
    }

  // Restore interrupt configuration
  IC_bit.INS=1;                 // restore INS=1
  __set_interrupt_state(mask);  // restore mask (IMR=mask;)
}

  // Watchdog Timer
#pragma vector=7
__interrupt void isr_module7() {
  WDCN_bit.WDIF=0;          // clear int flag
  __clear_watchdog_timer(); // reset WDT
  SBUF0='.';                // print a symbol via UART0
}



// Application Code
int main(int argc, char* argv[]) {
  long i;
  // Init Port Pin P0.0
  PD0 |= 0x01;      // counfigure direction (output)
  PO0 &= 0xFE;      // set pin P0.0 low
  // Init Interrupts
  WDCN=0x52;        // enable Watchdog int
  // Ext 0,10,11,12
  EIES0=0x01;       // negative edge trigger for int 0
  EIE0 =0x01;       // enable ext 0 itnterrupt
  EIES1=0x1C;       // negative edge trigger for int 10,11,12
  EIE1 =0x1C;       // enable ext 10,11,12 itnterrupts
  // Timer 1
  T2R1=65536-16000; // ovfl every 1ms @ 16MHz
  T2V1=T2R1;        // init counter
  T2CFG1=0x70;      // 16-bit timer mode, clock/128
  T2CNA1=0x88;      // int enabled, start the timer
  // UART0 (serial)
  SCON0=0x40;       // async.mode 1, clock/4
  SMD0=0x06;        // clock/16, int enabled
  PR0=0x3AFB;       // 115200 bps @ 16MHz
  // modules & global
  __set_interrupt_state(0x97);  // enable modules 0,1,2,4,7 (IMR=0x97;)
  __enable_interrupt();         // global enable (IC_bit.IGE=1;)

  ptr=0;
  appendbuf("=Reset=");     // append buffer with text
  while(1) {
    appendbuf("Main");      // append buffer with text
    for(i=0;i<50000;) i++;  // pause (burn 50000 cycles)
  }
}