MPAE-12175: updated to Melody v1.37.26, updated readme

Author: Erling Holten Wiken

.main-meta/main.json

@@ -15,7 +15,7 @@
         "compiler": [
             {
                 "name": "XC8",
-                "semverRange": "^2.31.0"
+                "semverRange": "^2.32.0"
             }
         ],
         "dfp": {

README.md

@@ -5,11 +5,13 @@
 
 This code example shows how to use single slope Pulse-Width Modulation (PWM) in the Timer/Counter A (TCA) on the AVR® DB Family of microcontrollers to generate overflow interrupts that toggle a LED. The time between each overflow interrupt is determined by the TCA clock prescaler selection and the value loaded into the period register. Then the overflow interrupt is enabled, and the TCA is started. Inside the interrupt handler function, the LED is toggled. The result is that the amber LED0 on the AVR128DB48 Curiosity Nano development board is blinking with an equal period on and off (50% duty cycle).
 
-![cnano](images/avr128db48_cnano_board.png)
+![cnano](images/avr128db48_cnano_board.png | width=1000)
 
 ## Related Documentation
 
 - [AVR128DB48 device page](https://www.microchip.com/wwwproducts/en/AVR128DB48)
+- [MPLAB Code Configurator](https://www.microchip.com/en-us/development-tools-tools-and-software/embedded-software-center/mplab-code-configurator)
+- [AVR128DB48 Curiosity Nano Hardware User Guide](https://www.microchip.com/DevelopmentTools/ProductDetails/PartNO/EV35L43A)
 
 
 ## Software Used
@@ -18,9 +20,9 @@ Microchip’s free MPLAB X IDE, compiler and MPLAB Code Configurator (MCC) graph
 
 - [MPLAB® X IDE v5.45](https://www.microchip.com/mplab/mplab-x-ide) or newer
 - [MPLAB® Xpress IDE](https://www.microchip.com/xpress) (alternative to MPLAB X IDE)
-- [XC8 Compiler v2.31](https://www.microchip.com/mplab/compilers) or newer
+- [XC8 Compiler v2.32](https://www.microchip.com/mplab/compilers) or newer
 - [MPLAB® Code Configurator (MCC) v4.1.0](https://www.microchip.com/mplab/mplab-code-configurator) or newer
-- [MPLAB® Melody Library 1.37.24 or newer](https://www.microchip.com/mplab/mplab-code-configurator) or newer
+- [MPLAB® Melody Library 1.37.26 or newer](https://www.microchip.com/mplab/mplab-code-configurator) or newer
 - [MCC Device Libraries 8-bit AVR MCUs 2.7.0](https://www.microchip.com/mplab/mplab-code-configurator) or newer
 - [Microchip AVR128DB48 Device Support Pack AVR-Dx_DFP 1.2.98](https://packs.download.microchip.com/) or newer
 
@@ -42,9 +44,9 @@ Add the required peripherals:  Timer Counter A (TCA0), Interrupt Manager, and Pi
 
 ### System Configuration: INTERRUPT MANAGER
 
-In the INTERRUPT MANAGER, global interrupts is enabled. The interrupt associated with TCA0 (overflow) is enabled in the TCA0 configuration.
+In the INTERRUPT MANAGER, global interrupts is enabled. The interrupt associated with TCA0 (overflow) is enabled in the TCA0 configuration, so we will leave that alone in this view.
 
-![Interrupts](images/interrupt_manager_needupdate.png)
+![Interrupts](images/interrupt_manager.png)
 
 ### System Configuration: PINS
 
@@ -73,7 +75,7 @@ In the *Pins* configuration box, now the pin you added will show (Pin Name = PB3
 - Requested Timeout used in this example is 0.25s. For different periods, use a combination of Clock Selection and Requested Timeout to create the desired period (based on the Clock Selection prescaler value, the possible range for Requested Timeout will change, higher prescaler gives longer timeout options. The actual timeout will be calculated and shown in next line (this should be identical to Requested Timeout in normal mode).
 - Turn on "Enable Overflow Interrupt" button to enable overflow interrupts from TCA0.
 
-![tca0](images/TCA0_needsupdate.png)
+![tca0](images/TCA0.png)
 
 Now all configuration is complete. You have now enabled global interrupts, set PB3 as output in order to blink the LED and configured the timer (TCA0) to count up to a given value that gives you a certain time period (250 ms), then trigger an overflow interrupt. Next steps are setting up the hardware and programming the device.
 

avr128db48-blink-with-timer-mplab-mcc.X/avr128db48-cnano-led-blink-pwm-mcc.mc3

@@ -14,24 +14,6 @@
 #include <avr/io.h>
 #include "./port.h"
 
-//get/set IO_PA2 aliases
-#define IO_PA2_SetHigh() do { PORTA_OUTSET = 0x4; } while(0)
-#define IO_PA2_SetLow() do { PORTA_OUTCLR = 0x4; } while(0)
-#define IO_PA2_Toggle() do { PORTA_OUTTGL = 0x4; } while(0)
-#define IO_PA2_GetValue() (VPORTA.IN & (0x1 << 2))
-#define IO_PA2_SetDigitalInput() do { PORTA_DIRCLR = 0x4; } while(0)
-#define IO_PA2_SetDigitalOutput() do { PORTA_DIRSET = 0x4; } while(0)
-#define IO_PA2_SetPullUp() do { PORTA_PIN2CTRL  |= PORT_PULLUPEN_bm; } while(0)
-#define IO_PA2_ResetPullUp() do { PORTA_PIN2CTRL  &= ~PORT_PULLUPEN_bm; } while(0)
-#define IO_PA2_SetInverted() do { PORTA_PIN2CTRL  |= PORT_INVEN_bm; } while(0)
-#define IO_PA2_ResetInverted() do { PORTA_PIN2CTRL  &= ~PORT_INVEN_bm; } while(0)
-#define IO_PA2_DisableInterruptOnChange() do { PORTA.PIN2CTRL = (PORTA.PIN2CTRL & ~PORT_ISC_gm) | 0x0 ; } while(0)
-#define IO_PA2_EnableInterruptForBothEdges() do { PORTA.PIN2CTRL = (PORTA.PIN2CTRL & ~PORT_ISC_gm) | 0x1 ; } while(0)
-#define IO_PA2_EnableInterruptForRisingEdge() do { PORTA.PIN2CTRL = (PORTA.PIN2CTRL & ~PORT_ISC_gm) | 0x2 ; } while(0)
-#define IO_PA2_EnableInterruptForFallingEdge() do { PORTA.PIN2CTRL = (PORTA.PIN2CTRL & ~PORT_ISC_gm) | 0x3 ; } while(0)
-#define IO_PA2_DisableDigitalInputBuffer() do { PORTA.PIN2CTRL = (PORTA.PIN2CTRL & ~PORT_ISC_gm) | 0x4 ; } while(0)
-#define IO_PA2_EnableInterruptForLowLevelSensing() do { PORTA.PIN2CTRL = (PORTA.PIN2CTRL & ~PORT_ISC_gm) | 0x5 ; } while(0)
-
 //get/set LED0_PIN aliases
 #define LED0_PIN_SetHigh() do { PORTB_OUTSET = 0x8; } while(0)
 #define LED0_PIN_SetLow() do { PORTB_OUTCLR = 0x8; } while(0)
@@ -51,8 +33,6 @@
 #define LED0_PIN_EnableInterruptForLowLevelSensing() do { PORTB.PIN3CTRL = (PORTB.PIN3CTRL & ~PORT_ISC_gm) | 0x5 ; } while(0)
 
 void PIN_MANAGER_Initialize();
-void PA2_DefaultInterruptHandler(void);
-void PA2_SetInterruptHandler(void (* interruptHandler)(void)) ; 
 void PB3_DefaultInterruptHandler(void);
 void PB3_SetInterruptHandler(void (* interruptHandler)(void)) ; 
 #endif /* PINS_H_INCLUDED */

avr128db48-blink-with-timer-mplab-mcc.X/avr128db48-cnano-led-blink-pwm-mcc.mc3.bak

@@ -37,15 +37,14 @@
 
 #include "../pins.h"
 
-static void (*PA2_InterruptHandler)(void);
 static void (*PB3_InterruptHandler)(void);
 void PORT_Initialize(void);
 
 void PIN_MANAGER_Initialize()
 {
   PORT_Initialize();
   /* DIR Registers Initialization */
-    PORTA.DIR = 0x4;
+    PORTA.DIR = 0x0;
     PORTB.DIR = 0x8;
     PORTC.DIR = 0x0;
     PORTD.DIR = 0x0;
@@ -150,7 +149,6 @@ void PIN_MANAGER_Initialize()
     PORTMUX.ZCDROUTEA = 0x0;
 
   // register default ISC callback functions at runtime; use these methods to register a custom function
-    PA2_SetInterruptHandler(PA2_DefaultInterruptHandler);
     PB3_SetInterruptHandler(PB3_DefaultInterruptHandler);
 }
 
@@ -186,19 +184,6 @@ void PORT_Initialize(void)
     }
 
 }
-/**
-  Allows selecting an interrupt handler for PA2 at application runtime
-*/
-void PA2_SetInterruptHandler(void (* interruptHandler)(void)) 
-{
-    PA2_InterruptHandler = interruptHandler;
-}
-
-void PA2_DefaultInterruptHandler(void)
-{
-    // add your PA2 interrupt custom code
-    // or set custom function using PA2_SetInterruptHandler()
-}
 /**
   Allows selecting an interrupt handler for PB3 at application runtime
 */
@@ -215,10 +200,6 @@ void PB3_DefaultInterruptHandler(void)
 ISR(PORTA_PORT_vect)
 {  
     // Call the interrupt handler for the callback registered at runtime
-    if(VPORTA.INTFLAGS & PORT_INT2_bm)
-    {
-       PA2_InterruptHandler();
-    }
 
     /* Clear interrupt flags */
     VPORTA.INTFLAGS = 0xff;

avr128db48-blink-with-timer-mplab-mcc.X/mcc_generated_files/system/pins.h

@@ -142,62 +142,71 @@ ISR(TCA0_OVF_vect)
  */
 void TCA0_Initialize(void) {
     // Compare 0
-    TCA0.SINGLE.CMP0 = 0x0;
+    TCA0.SINGLE.CMP0 = 0xF423;
 
     // Compare 1
-    TCA0.SINGLE.CMP1 = 0x0;
+    TCA0.SINGLE.CMP1 = 0xF423;
 
     // Compare 2
-    TCA0.SINGLE.CMP2 = 0x0;
+    TCA0.SINGLE.CMP2 = 0xF423;
 
     // Count
     TCA0.SINGLE.CNT = 0x0;
 
-    // ALUPD undefined; CMP0EN disabled; CMP1EN disabled; CMP2EN disabled; WGMODE SINGLESLOPE; 
+    // ALUPD disabled; CMP0EN disabled; CMP1EN disabled; CMP2EN disabled; WGMODE SINGLESLOPE; 
     TCA0.SINGLE.CTRLB = 0x3;
 
-    // CMP0OV undefined; CMP1OV undefined; CMP2OV undefined; 
+    // CMP0OV disabled; CMP1OV disabled; CMP2OV disabled; 
     TCA0.SINGLE.CTRLC = 0x0;
 
     // SPLITM disabled; 
     TCA0.SINGLE.CTRLD = 0x0;
 
-    // CMD undefined; LUPD undefined; DIR UP; 
+    // CMD NONE; DIR disabled; LUPD disabled; 
     TCA0.SINGLE.CTRLECLR = 0x0;
 
-    // CMD undefined; LUPD undefined; DIR UP; 
+    // CMD NONE; DIR UP; LUPD disabled; 
     TCA0.SINGLE.CTRLESET = 0x0;
 
-    // CMP0BV undefined; CMP1BV undefined; CMP2BV undefined; PERBV undefined; 
+    // CMP0BV disabled; CMP1BV disabled; CMP2BV disabled; PERBV disabled; 
     TCA0.SINGLE.CTRLFCLR = 0x0;
 
-    // CMP0BV undefined; CMP1BV undefined; CMP2BV undefined; PERBV undefined; 
+    // CMP0BV disabled; CMP1BV disabled; CMP2BV disabled; PERBV disabled; 
     TCA0.SINGLE.CTRLFSET = 0x0;
 
-    // DBGRUN undefined; 
+    // DBGRUN disabled; 
     TCA0.SINGLE.DBGCTRL = 0x0;
 
-    // CNTAEI undefined; CNTBEI undefined; EVACTA undefined; EVACTB undefined; 
+    // CNTAEI disabled; CNTBEI disabled; EVACTA CNT_POSEDGE; EVACTB NONE; 
     TCA0.SINGLE.EVCTRL = 0x0;
 
     // CMP0 disabled; CMP1 disabled; CMP2 disabled; OVF enabled; 
     TCA0.SINGLE.INTCTRL = 0x1;
 
-    // CMP0 undefined; CMP1 undefined; CMP2 undefined; OVF undefined; 
+    // CMP0 disabled; CMP1 disabled; CMP2 disabled; OVF disabled; 
     TCA0.SINGLE.INTFLAGS = 0x0;
 
-    // Period = 250ms; 4MHz/16 = 250kHz -> t_TCA = 1/250k = 4us; 
-    // PER = 250ms/4us = 62500 = 0xF424
-    TCA0.SINGLE.PER = 0xF424;
+    // Period
+    TCA0.SINGLE.PER = 0xF423;
 
     // Temporary data for 16-bit Access
     TCA0.SINGLE.TEMP = 0x0;
 
-    // RUNSTDBY disabled; CLKSEL DIV16; ENABLE enabled;  
+    // CLKSEL DIV16; ENABLE enabled; RUNSTDBY disabled; 
     TCA0.SINGLE.CTRLA = 0x9;
 
 }
 
+void TCA0_Start(void)
+{
+    TCA0.SINGLE.CTRLA|= TCA_SINGLE_ENABLE_bm;
+}
+
+void TCA0_Stop(void)
+{
+    TCA0.SINGLE.CTRLA&= ~TCA_SINGLE_ENABLE_bm;
+}
+
 void TCA0_Write(uint16_t timerVal)
 {
     TCA0.SINGLE.CNT=timerVal;

avr128db48-blink-with-timer-mplab-mcc.X/mcc_generated_files/system/src/pins.c

@@ -63,7 +63,11 @@ extern "C" {
 
 typedef void (*TCA0_cb_t)(void);    
 
+extern const struct TMR_INTERFACE TCA0_Interface;
+
 void TCA0_Initialize(void);
+void TCA0_Start(void);
+void TCA0_Stop(void);
 void TCA0_OverflowCallbackRegister(TCA0_cb_t cb);
 void TCA0_Compare0CallbackRegister(TCA0_cb_t cb);
 void TCA0_Compare1CallbackRegister(TCA0_cb_t cb);